[Pkg-emboss-devel] Antwort: [EMBOSS] Manpage generator

[Daniel Leidert]

Am Montag, den 16.07.2007, 22:18 +0900 schrieb Charles Plessy:
> Le Sun, Jul 15, 2007 at 10:35:49PM +0200, Daniel Leidert a écrit :
> > Because I don't get any answer on my PMs, I send this to the list
> > instead:
> 
> Hi Daniel,
> 
> thank you for your feedback, I was just keeping your PM for this weekend
> as I waited for the release of EMBOSS 5.0.0 to continue my work.

I simply wasn't sure, if you received the mails.

[..]
> > About the dhdate entity: The date is automatically added when creating
> > the manpage via xsltproc (that's a part of the docbook-xsl features).
> > You don't need to create an entity nor use the <date> tag.
> 
> Taken from the template ; corrected.

Yes, thanks for reminding me about this. It has already been fixed in
the dh-make template. I will remove this from the example file too or
add a comment.

[..]
> > I further suggest to set the man.charmap.use.subset parameter to zero
> > when creating the manpages.
> 
> Corrected. Maybe you can explain the rationale (sparing buildd time ?)
> in the template ?

file:///usr/share/doc/docbook-xsl/doc/manpages/man.charmap.use.subset.html
(package docbook-xsl-doc-html)

The default is to replace only a subset of special characters with their
groff code to save time during processing. This can lead to lintian
warning/error manpage-has-errors-from-man (especially the "can't find
numbered character" error). So we disable the default behaviour and
replace all special characters with their groff code. This increases
processing time, but prevents unnecessary errors.

If you can be sure, the default behaviour will NOT lead to issues with
mandb/lintian, you can of course leave the default value of
man.charmap.use.subset. If you spot issues, then you can also check the
man.charmap.subset.profile parameter and refine, which parts of the roff
map you need.

Regards, Daniel