develooper Front page | perl.perl5.porters | Postings from June 2003

[perl #22827] Inconsistency in perl 5.8.0 'encoding' manpage

From:
Miles Spielberg
Date:
June 26, 2003 20:53
Subject:
[perl #22827] Inconsistency in perl 5.8.0 'encoding' manpage
Message ID:
rt-22827-59953.1.95427844281724@rt.perl.org
# New Ticket Created by  Miles Spielberg 
# Please include the string:  [perl #22827]
# in the subject line of all future correspondence about this issue. 
# <URL: http://rt.perl.org/rt2/Ticket/Display.html?id=22827 >


In the fourth paragraph of the ABSTRACT section of the encoding(3pm) 
manpage included with the 5.8.0 perl distribution, the following 
sentence appears:

"The encoding pragma also modifies the filehandle disciplines of STDIN, 
STDOUT, and STDERR to the specified encoding."

However, this is incorrect, and does not correspond to the behavior of 
the pragma. Later in the same manpage, under the USAGE section, the 
correct behavior is described:

"Sets fht escript encoding to ENCNAME. Filehandle disciplines of STDIN 
and STDOUT are set to ":encoding(ENCNAME)". Note that STDERR will not 
be changed."

This portion of the documentation also uses the old "discipline" 
terminology instead of the current "layer" terminology as described in 
the binmode section of the perfunc(1) manpage. Also, the encoding(3pm) 
manpage should describe how it is necessary to use binmode to change 
the filehandle layer associated with STDERR, if that is the desired 
behavior.

Thank you for your time. Please contact me if you have any questions or 
comments on this matter.

Miles Spielberg
Intern, NTT Keihanna Research Laboratories, Kyoto, Japan






nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About