Bug 61753

Summary: Man pages not installed
Product: systemd Reporter: Matthew Burgess <matthew>
Component: generalAssignee: systemd-bugs
Status: RESOLVED FIXED QA Contact: systemd-bugs
Severity: normal    
Priority: medium    
Version: unspecified   
Hardware: Other   
OS: All   
Whiteboard:
i915 platform: i915 features:

Description Matthew Burgess 2013-03-03 20:17:11 UTC
On a system without xsltproc installed, building of the man pages is correctly disabled.  However, this also seems to disable the installation of the pre-built/shipped man pages.  It'd be nice if the shipped copy of the man pages could be installed without requiring the docbook processing tools.
Comment 1 Zbigniew Jedrzejewski-Szmek 2013-03-15 14:31:43 UTC
Actually, pre-built man pages are not shipped. Also, I'm not sure if shipping them is feasible. Manpages are modified based upon configure settings... Some are simply skipped, which is not a problem, but some are generated:
  build/man/systemd.directives.xml
  build/man/systemd.index.xml
  build/man/systemd.unit.xml

I guess that what what you request (after adding the shipping of manpages in tarball) could be implemented, with only a *few* of the manpages out of date. How important is it to install manpages without docbook?
Comment 2 Matthew Burgess 2013-03-15 14:41:21 UTC
(In reply to comment #1)
> Actually, pre-built man pages are not shipped.

Really?  There's a bunch of .1, .5, .7, .8 files under man/ in the tarballs :-)

> Manpages are modified based upon configure
> settings... Some are simply skipped, which is not a problem, but some are
> generated:
>   build/man/systemd.directives.xml
>   build/man/systemd.index.xml
>   build/man/systemd.unit.xml
> 
> I guess that what what you request (after adding the shipping of manpages in
> tarball) could be implemented, with only a *few* of the manpages out of
> date. How important is it to install manpages without docbook?

Ah, I didn't realise some were dynamically generated.  This isn't a crucial feature, more of a 'nice-to-have'.  In the Linux From Scratch book (http://www.linuxfromscratch.org/lfs/view/systemd/), when building the base LFS system, we do not have libxml2, libxslt or the docbook-xml/docbook-xsl infrastructure either.  We could provide a patch/tarball to deliver pre-built man pages based on the 'configure' options in our instructions.  It'd be nice if you could ship the non-configure-specific man pages though, to cut down on the size of such a patch/tarball.

Thanks,

Matt.
Comment 3 Zbigniew Jedrzejewski-Szmek 2013-07-16 03:22:21 UTC
Manpages are now part of the distribution tarball (or will be in systemd-206).

http://cgit.freedesktop.org/systemd/systemd/commit/?id=b31c6d8

Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.