Placement of man pages
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_SubPackag es
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.
packaging mailing list