[EMAIL PROTECTED] (Casey West) writes:
> Well, this message has less to do with that than it does with the
> standard documentation. Pete Sergeant has put together a fairly good
> complaint list (http://perl.clueball.com) about the standard
> documentation.
I'd like to add to the list on that site:
- no means to customize output to something complete (e.g. everything
cited at perltoot compiled together in a "book")
- decentralized documentation, making it harder to, e.g., grep it
> What Pete and I would like to see is a full scale editorial and
> technical attack on the standard documentation (the stuff under pod/,
> mostly).
>
> Along the same lines, Sean Burke has developed some good guidelines
> for writing POD that the standard documentation should abide by.
Where can I (we?) find it?
> perldoc needs some major updates.
And enhancements. :-)
I think about using XML to fix some deficiencies... besides, it makes
it possible to use several tools to index, search, manipulate
docs. POD is restricted to Perl.
--
Godoy. <[EMAIL PROTECTED]>
Solutions Developer - Conectiva Inc. - http://en.conectiva.com
Desenvolvedor de Solu��es - Conectiva S.A. - http://www.conectiva.com.br
