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

Update documentation for Pod::Html and pod2html

James E Keenan
November 29, 2022 21:19
Update documentation for Pod::Html and pod2html
Message ID:
Having been staring at for 
several weeks now and spending many hours peering into its depths, I am 
more aware than ever of the inadequacies of its documentation.

To improve the situation, I will be proposing a series of pull requests 
which will aim at things like:

* Documenting the command-line switches in lib/Pod/ and 
bin/pod2html in the same alphabetical order.

* Figuring out the best way to document the 'no*' switches.

* Having the wording of the documentation for each command-line switch 
be identical (except where that's not appropriate).

And so forth.

The first such p.r. is

If there are one or two committers who would like to be designated 
reviewers for these p.r.s, please let me know.

If there are other readers of this list who want to follow along on this 
project, please ping me.

Thank you very much.
Jim Keenan Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at | Group listing | About