Bug 61753 - Man pages not installed
Summary: Man pages not installed
Status: RESOLVED FIXED
Alias: None
Product: systemd
Classification: Unclassified
Component: general (show other bugs)
Version: unspecified
Hardware: Other All
: medium normal
Assignee: systemd-bugs
QA Contact: systemd-bugs
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2013-03-03 20:17 UTC by Matthew Burgess
Modified: 2013-07-16 03:22 UTC (History)
0 users

See Also:
i915 platform:
i915 features:


Attachments

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.