Peter S Galbraith <p...@debian.org>: > There has been an open bug report for the imgsizer man page markup for 3 > years and (sorry) I am just now looking into it after dropping the ball > for so long.
I wrote imgsizer, so I can fix the problem at the source and cut sb2man out of the picture, and will happily do so. It sucked. > The bug is at http://bugs.debian.org/379166 > > : For example: > : > : -n, --no-overwwrite, .SH DESCRIPTION > : > : For updates, see <http://www.catb.org/~esr: > : http://www.catb.org/~esr> > : > : In the synopsis, the short options and --no-overwrite are emboldened > : but --document-root, --version and --help are not. > : > : Under OPTIONS, the first few options are not displayed at all. > : > : "-no-overwwrite" is spelt incorrectly (two w's). > : > : I presume that before the text "This script will try create" (surely > : "try to create?") there should be a heading, since this is no longer > : describing the options. > : > : For Debian, the last paragraph before "NOTE", starting "This script is > : written in Python" can be removed, except for the last sentence, as > : the rest of the paragraph just describes dependencies, which have no > : place in a man page, and in any case are automatically satisfied in > : Debian. > : > : In the SEE ALSO section, "rdjpgcom(1)" is not emboldened but the other > : two referenced man pages are. > > I thought I'd just edit the man page, but its header says: > > Generated by db2man.xsl. Don't modify this, modify the source. > > Unfortunately, db2man (http://projects.camlcity.org/projects/db2man.html) > is neither packaged by Debian, nor packagable as I understand it because > the XML parser "Tony" has "disappeared from the web". > > The db2man tool may not be optimal either, since its homepage says: > > : Currently, only a subset of the "docbook" tags that are allowed in > : "refentry" are supported. Unknown tags are simply ignored as if they had > : not been written. > > Anyway, are you interested in fixing these bugs? Interested, and, in fact, I think they're already fixed in my masters. My makefile uses xmlto, not db2man, and the XML markup in the problem are has been written. Should I just push out a fix release and notify you? -- <a href="http://www.catb.org/~esr/";>Eric S. Raymond</a> -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
