[Fedora-packaging] Manpages using %doc

[Jon Ciesla]

On Wed, May 16, 2012 at 7:12 AM, Tomas Radej <tradej at redhat.com> 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.

Probably the latter, but I'd still keep it out of %doc.  The only
reason people would use --nodocs is to save space, and man pages are
trivially small.

-J

> Thank you,
>
> --
> Tomas Radej <tradej at redhat.com>
> --
> packaging mailing list
> packaging at lists.fedoraproject.org
> https://admin.fedoraproject.org/mailman/listinfo/packaging



-- 
http://cecinestpasunefromage.wordpress.com/
------------------------------------------------
in your fear, seek only peace
in your fear, seek only love

-d. bowie