Bug 9732 - man page install issues with 4.0 tar ball
man page install issues with 4.0 tar ball
Status: NEW
Product: Samba 4.0
Classification: Unclassified
Component: Documentation
4.0.4
All All
: P5 normal
: ---
Assigned To: Andreas Schneider
Samba QA Contact
:
Depends on:
Blocks:
  Show dependency treegraph
 
Reported: 2013-03-21 10:57 UTC by Björn Jacke
Modified: 2015-10-22 08:49 UTC (History)
3 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Björn Jacke 2013-03-21 10:57:23 UTC
there are no pre-built man pages for the ldb and tdb tools. These man pages should be pre-built in the tar ball like the other man pages also.

Even the existing man pages from docs/manpages are not installed by waf's make install. When the user entered "./configure --mandir=MANDIR" then she expects that make install will also install the man pages like in the non-waf build.
Comment 1 Andreas Schneider 2013-03-21 11:03:39 UTC
Why need the manpages be pre-built? I don't see a reason ...
Comment 2 Björn Jacke 2013-03-21 11:15:48 UTC
if the man page build process is simple and automated it might not be needed but i think because it is not simple we have the pre-built man pages in docs/manpages/ since a long time? Simplicity for users installing from a tar ball is also the reason why we always ran autogen.sh before we made a tar ball. The man pages should be simply be installed by a "make install" - without magic doc xml extra requirements. Especially there should not be such a requirement for some man pages and for some not - this is how it currently is and it should be consistent and easy to install them (like it was in previous samba versions actually).
Comment 3 Andreas Schneider 2013-03-21 11:34:52 UTC
> If the man page build process is simple and automated it might not be needed

Why is it not easy for you?

What is wrong with installing docbook and calling 'make' and 'make install'?
Comment 4 Andreas Schneider 2013-03-21 11:37:46 UTC
We require ~30 devel packages to be installed to build a fully working Samba. I don't see what is wrong with installing docbook (one additional package) for generating the manpages.
Comment 5 Björn Jacke 2013-03-22 20:26:11 UTC
if you are working on a unix system and you cannot just run "yum" then you know what a pain that is, if possible at all. Even building the man pages on different versions of linux is problematic, i know how much karo has been sufferings with that.
Comment 6 Andreas Schneider 2014-04-07 08:11:51 UTC
I'm open for patches ... :)