Hello Eric,

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.

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?
Thanks,
-- 
Peter S. Galbraith, Debian Developer          <p...@debian.org>
                                 http://people.debian.org/~psg
GPG key 1024/D2A913A1 - 97CE 866F F579 96EE  6E68 8170 35FF 799E



-- 
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org

Reply via email to