packaging-committee

#930 Tighten up the manpage section.
Merged by tibbs. Opened by tibbs.
tibbs/packaging-committee manpages  into  master

Download 930.patch

Use SHOULD/MUST language throughout, and require that manpages be referenced by pattern.

(The first commit converts to semantic linebreaks; look at the following commits to see the actual changes).

1 new commit added

  • Note explicitly that %doc is not needed for manpages.

Changes look good (haven't checked if it renders correctly).

I really do recommend the browser extension; it's possible to get an idea of the rendering (without the Fedora stylesheets and such, sadly) just by looking at the raw file.

 
`+%files+`

?

1 new commit added

  • Render %files as code.

One interesting thing I've found is that RPM (via brp-compress) will re-compress manpages into its preferred format. So if you install a xz-compressed manpage, rpm will call unxz and then gzip the result. So I'm not sure if there is any point in stating "they SHOULD be installed uncompressed as the build system will compress them is needed". In reality it doesn't seem to matter at all whether they are compressed or not; you'll get .gz files out at the end.

1 new commit added

  • Note that RPM will recompress manpages.

Pull-Request has been merged by tibbs
Metadata
None
No Tags
Static archive. pagure.io was sunset in 2026; this is a read-only snapshot.
Red Hat Logo

Fedora is sponsored by Red Hat. Learn more about the relationship between Red Hat and Fedora »

© Red Hat, Inc. and others.