Merge pull request #231 from nxadm/master

Update documentation for .nl => .nl-in and .nl-out

Author: jonathanstowe

doc/Language/5to6-perlvar.pod

@@ -424,18 +424,17 @@ filehandle. E. g. C<$*IN.ins>.
 
 =item $/
 
-This is accessed through the C<.nl> method on the filehandle. E. g.
-C<$*IN.nl>.
+This is accessed through the C<.nl-in> method on the filehandle. E. g.
+C<$*IN.nl-in>.
 
 =item $OUTPUT_RECORD_SEPARATOR
 
 =item $ORS
 
 =item $\
 
-[NEEDS FURTHER RESEARCH] The <.nl> method on the filehandle (e. g.
-C<$*OUT.nl>) I<appears> to give the output record separator, but this is
-currently not clear.
+This is accessed through the C<.nl-out> method on the filehandle. E. g.
+C<$*OUT.nl-out>.
 
 =item $OUTPUT_AUTOFLUSH
 

doc/Language/io.pod

@@ -35,7 +35,7 @@ the file for you.
 =head2 Line by line
 
 Of course, we also have the option to read a file line-by-line. The new line
-separator (e.g. $*IN.nl) will be excluded.
+separator (e.g. $*IN.nl-in) will be excluded.
 
     for 'huge-csv'.IO.lines -> $line {
         # Do something with $line

doc/Type/IO/Handle.pod

@@ -36,7 +36,7 @@ Returns L<Bool::True> if the read operations have exhausted the content of the f
     method lines($limit = Inf)
 
 Return a lazy list of the file's lines read via L<get>, limited to C<$limit> lines.
-The new line separator (e.g. $*IN.nl) will be excluded.
+The new line separator (e.g. $*IN.nl-in) will be excluded.
 
     =for code :allow<B>
     my @data;