[Fedora-packaging] Placement of man pages

Ralf Corsepius rc040203 at freenet.de
Sun Feb 7 18:05:01 UTC 2010


On 02/07/2010 01:04 PM, Michael Schwendt wrote:
> On Sun, 7 Feb 2010 14:52:32 +0800 (CST), Chen wrote:
>
>> Hi all,I'm trying to package a library which have a lot of API documentations, so I intend to split them into -doc subpackage.The API documentations included in this library have several types such as html, pdf, man pages. I wonder which subpackage should the man pages goes in, the -devel subpackage or -doc subpackage??Regard,Chen Lei
>>
>
> Those man pages, which cover the library API, normally belong into the
> -devel package. But depending on their total size and quantity you may put
> them into the -doc package instead:
>
> https://fedoraproject.org/wiki/Packaging:NamingGuidelines#Documentation_SubPackages

Man pages belong into the package they are documenting.

Normally this means *.1 go into the package, *.3's into the devel 
package. Others need to be looked into on a case by case basis.

It also means shipping man-pagaes in *-doc packages under normal 
circumstances is considered bad packaging.

Ralf




More information about the packaging mailing list