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

perltoc.pod issues

Thread Next
From:
Stas Bekman
Date:
November 2, 2003 16:20
Subject:
perltoc.pod issues
Message ID:
3FA59F41.2000008@stason.org
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:
     690

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
http://stason.org/     mod_perl Guide ---> http://perl.apache.org
mailto:stas@stason.org http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org   http://ticketmaster.com


Thread Next


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