Author: masak
Date: 2009-03-14 13:34:54 +0100 (Sat, 14 Mar 2009)
New Revision: 25823
Modified:
docs/Perl6/Spec/S32-setting-library/IO.pod
Log:
replaced 'record' with 'line' in IO.pod
'record' is fine and understandable in the Unix world, and used by
tools such as awk -- but line is immediately understandable and shorter.
Modified: docs/Perl6/Spec/S32-setting-library/IO.pod
===================================================================
--- docs/Perl6/Spec/S32-setting-library/IO.pod 2009-03-14 12:34:50 UTC (rev
25822)
+++ docs/Perl6/Spec/S32-setting-library/IO.pod 2009-03-14 12:34:54 UTC (rev
25823)
@@ -17,7 +17,7 @@
Daniel Ruoso <[email protected]>
Date: 19 Feb 2009 extracted from S29-functions.pod; added stuff from
S16-IO later
Last Modified: 14 Mar 2009
- Version: 3
+ Version: 4
The document is a draft.
@@ -261,16 +261,16 @@
=over
-=item method Int input-record-count()
+=item method Int input-line()
-Returns a count of the number of records (lines?) that have been input.
+Returns the number of lines (records) that have been input.
Now with cleaned-up localization usage.
-=item method Str input-record-separator() is rw
+=item method Str input-line-separator() is rw
This regulates how "readline" behaves.
-The input record separator, newline by default.
+The input line (record) separator, newline by default.
This influences Perl's idea of what a ``line'' is.
Works like awk's RS variable, including treating empty lines
as a terminator if set to the null string.
@@ -284,7 +284,7 @@
that the next input character belongs to the next paragraph,
even if it's a newline.
-Remember: the value of input-record-separator is a string, not a regex.
+Remember: the value of input-line-separator is a string, not a regex.
awk has to be better for something. :-)
=item method Str input-field-separator() is rw
@@ -298,7 +298,7 @@
=item method Str readline()
-Reads the stream before it finds a $.input-record-separator and
+Reads the stream before it finds a $.input-line-separator and
returns it (including the separator). If $.input-escape is set, it
should pay attention to that.
@@ -306,7 +306,7 @@
Reads the stream before it finds a $.input-field-separator and returns
it (including the separator). If a readfield finds a
-$.input-record-separator it consumes the record separator, but returns
+$.input-line-separator it consumes the line separator, but returns
undef. If $.input-escape is set, it should pay attention to that.
=item method Str getc(Int $char? = 1)
@@ -328,11 +328,11 @@
=over
-=item method Int output-record-count()
+=item method Int output-line()
-Returns a count of the number of records (lines?) that have been output.
+Returns the number of lines (records) that have been output so far.
-=item method Str output-record-separator() is rw
+=item method Str output-line-separator() is rw
This regulates how say and print(%hash) behaves.
@@ -344,23 +344,23 @@
=item method Str output-escape() is rw
This allows the definition of a escape character, which should be used
-by say and print to preserve the record/field semantics.
+by say and print to preserve the line/field semantics.
=item method Bool print(Str $str)
=item method Bool say(Str $str)
Sends $str to the data stream doing proper encoding conversions. Say
-sends an additional $.output-record-separator. This should also
-convert "\n" to the desired $.output-record-separator.
+sends an additional $.output-line-separator. This should also
+convert "\n" to the desired $.output-line-separator.
=item method Bool print(Array @arr)
=item method Bool say(Array @arr)
Sends each element of @arr separated by $.output-field-separator. Say
-should add an additional $.output-record-separator. If an element
-contains the $.output-record-separator or the
+should add an additional $.output-line-separator. If an element
+contains the $.output-line-separator or the
$.output-field-seaparator and a $.output-escape is defined, it should
do the escaping.
@@ -368,9 +368,9 @@
=item method Bool say(Hash %hash)
-Sends each pair of the hash separated by $.output-record-separator,
+Sends each pair of the hash separated by $.output-line-separator,
with key and value separated by $.output-field-separator. If one of
-those contains a $.output-record-separator or a
+those contains a $.output-line-separator or a
$.output-field-seaparator and $.output-escape is set, it should do the
escaping.
