[Fedora-packaging] Manpages using %doc

Michael Schwendt mschwendt at gmail.com
Wed May 16 15:18:56 UTC 2012

On Wed, 16 May 2012 07:20:56 -0500, JC (Jon) wrote:

> On Wed, May 16, 2012 at 7:12 AM, Tomas Radej wrote:
> > Hi,
> >
> > Is it possible for man pages to use the %doc macro in the %files section in a spec file? In Guidelines, there's no explicit mention of it, and I haven't found a package having this behavior. However, I am reviewing spacewalk-pylint ( https://bugzilla.redhat.com/show_bug.cgi?id=800899 ), which does this:
> >
> >        %files
> >        %doc %{_mandir}/man8/spacewalk-pylint.8*
> >
> > Can you please give me a stance on that?
> It seems more logical to list the man page in the regular %files
> section, and leave doc for things like html, COPYING, README, etc.
> Though I've never tried the above, I'm not sure whether it would put
> the man page in /usr/share/doc/foo-version/, breaking man's ability to
> find it, or put it in the man dir, and allow it to be left out if
> --nodocs is passed.

The %doc macro does two different things depending on whether you
use it in conjunction with a _local_ file or an absolute path to a file.
For the former, it installs a copy of that file in the default docdir as
you've mentioned and marks it as Documentation. For the latter, it just
marks the already installed file as Documentation.

Fedora release 17 (Beefy Miracle) - Linux 3.3.4-5.fc17.x86_64
loadavg: 0.01 0.05 0.05

More information about the packaging mailing list