[Fedora-packaging] Manpages using %doc

[Michael Schwendt]

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