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

perltoc.pod issues

Thread Next
Stas Bekman
November 2, 2003 16:20
perltoc.pod issues
Message ID:
I've glanced at perltoc.pod and noticed that it:

1) includes quite a few duplications, e.g. the block start with:

=item Installation and Configuration Improvements

=over 4

=item -Dusethreads means something different

=item New Configure flags
... many more lines ...

is repeated twice.

% cat perltoc.pod | sort | uniq --repeated | wc -l

gives a whooping:

though granted that not all non-unique lines are really duplicates.

2) includes messed up things like:

=item New or Changed Diagnostics

"%s" variable %s masks earlier declaration in same %s, "my sub" not yet
implemented, "our" variable %s redeclared, '!' allowed only after types %s,
/ cannot take a count, / must be followed by a, A or Z, / must be followed
by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
\\%c passed through, /%s/: Unrecognized escape \\%c in character class
passed through, /%s/ should probably be written as "%s", %s() called too
early to check prototype, %s argument is not a HASH or ARRAY element, %s
argument is not a HASH or ARRAY element or slice, %s argument is not a
subroutine name, %s package attribute may clash with future reserved word:
%s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
substitution pattern, Bad realloc() ignored, Bareword found in conditional,
Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector

what's the point of having this useless gibberish in perltoc.pod?

Stas Bekman            JAm_pH ------> Just Another mod_perl Hacker     mod_perl Guide --->

Thread Next Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at | Group listing | About