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 attachment 87984 [details, diff] 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).