Re: [Fedora-packaging] Manpages using %doc
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