Bugzilla Bug 135028

in the doc directory are numerous .texi files with important information (such
as how to use gpg-agent). These files are not converted or installed. The
Makefile has several options for creating html, pdf, info pages, etc that are
not used. docbook-to-man is required for this though. I think man pages and
info pages for more than just gpg should be installed. I realize this could
cause a collision with parts of gnupg 1.4.

Bleh... That .texi stuff requires quite a few very fragile dependencies, that
cause more harm that good (tons of bugs about this stuff). I'd say USE=doc is
best you can hope for. Care to submit a patch (which should really use doc flag
for that)?

bleh! is right. The texi files are useless. The gpg-agent one does not even
compile into an info page. HOWEVER, there is a make option, make html in doc
which does create some nice html documentation which could be stuffed into
${D}/doc/${P}/html. I'll take a look at the Makefile.am file and see if it
can't be done automagically.

Created an attachment (id=87984) [edit]
gnupg-1.9.20-r3.ebuild.diff

This patch adds 3 lines of code to the ebuild which
1) creates html files by running make html in doc/
2) installs them into doc/html

May not be the best way to go, but at least some doc is provided. Comments can
easily be removed if desired. Don't know why Werner & Co. still do this :(

since I'm fussy I'll say USE=doc and depend on docbook(?)

If you can get man pages to build, more power to you. I could not even get the
agent info page to build. html pages compile fine though. IF the man pages and
info pages are doable, I would argue USE=doc is overkill, since man pages and
info pages are standard fare. One last option, although messy, is to make the
files separately and include them in the files/ directory if they are small
enough. Maybe I'll write Werner and find out what's up. These files should be
included with no extra fuss. This is not cvs code.

Peter, I'm sorry, but you are sprouting crap here.
"The texi files are useless. The gpg-agent one does not even
compile into an info page."
gnupg-1.9 makes a SINGLE info document: gnupg.info.
If you go and look at it, you will see that it uses gpg-agent.texi to make the
gpg-agent section.

none of the files are formatted for manpages however, so you are correct that
no manpages are present - but this mirrors many other GNU utilities where the
only docs are info documents.

regardless, I've applied a variant of your html patch (that includes the pretty
images).