Bug 135028 – gnupg-1.9.20-r3 does not install man pages

• Product: Gentoo Linux
• Status: RESOLVED FIXED

[Description Peter Hyman 2006-05-31 04:52:36 UTC]

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.

[Comment 1 Jakub Moc (RETIRED) 2006-05-31 05:03:35 UTC]

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)?

[Comment 2 Peter Hyman 2006-05-31 07:22:16 UTC]

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.

[Comment 3 Peter Hyman 2006-05-31 08:18:31 UTC]

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 :(

[Comment 4 Daniel Black (RETIRED) 2006-06-01 05:26:23 UTC]

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

[Comment 5 Peter Hyman 2006-06-01 09:08:28 UTC]

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.

[Comment 6 Robin Johnson 2006-10-04 21:03:11 UTC]

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).