Five times over the last year I have emailed notices to this list,
among other places, about manual pages that are ill-formed and
consequently cannot be correctly translated to XML-DocBook.
My campaign to drain this swamp has been remarkably successful. Man
page maintainers have accepted around 300 fix patches to clean up
markup. Out of over 11000 manual pages in a full FC3 install, I can
now translate over 96% without patching and over 99% with fix patches.
There are exactly 57 manual pages left on my junk list. In these,
the largest single group (14) is from the Perl documentation. They are:
/usr/share/man/man3/B::Stash.3pm.gz
/usr/share/man/man3/Carp::Heavy.3pm.gz
/usr/share/man/man3/Encode::CJKConstants.3pm.gz
/usr/share/man/man3/Encode::CN::HZ.3pm.gz
/usr/share/man/man3/Encode::Config.3pm.gz
/usr/share/man/man3/Encode::JP::H2Z.3pm.gz
/usr/share/man/man3/Encode::JP::JIS7.3pm.gz
/usr/share/man/man3/Encode::KR::2022_KR.3pm.gz
/usr/share/man/man3/PDL::BAD2_demo.3pm.gz
/usr/share/man/man3/PDL::BAD_demo.3pm.gz
/usr/share/man/man3/PDL::Config.3pm.gz
/usr/share/man/man3/PDL::Doc::Config.3pm.gz
/usr/share/man/man3/XML::DOM-ecmascript.3pm.gz
/usr/share/man/man3/XML::SAX::PurePerl::Reader.3pm.gz
Fixing these pages should not be difficult. The following ones
PDL::BAD2_demo.3pm
PDL::BAD_demo.3pm
PDL::Config.3pm
PDL::Doc::Config.3pm
are completely empty, and should perhaps be withdrawn. The others
have a NAME line but no synopsis or description text. All it would
take to make them liftable to XML-DocBook is a description section,
even a trivial one.
Would somebody please either fix this or open the way for me to do so?
--
<a href="http://www.catb.org/~esr/";>Eric S. Raymond</a>
Love your country, but never trust its government.
-- Robert A. Heinlein.
