Please do not reply directly to this email. All additional comments should be made in the comments box of this bug.
https://bugzilla.redhat.com/show_bug.cgi?id=521909
Ralf Corsepius rc040203@freenet.de changed:
What |Removed |Added ---------------------------------------------------------------------------- CC| |rc040203@freenet.de
--- Comment #27 from Ralf Corsepius rc040203@freenet.de 2009-10-02 08:50:27 EDT --- (In reply to comment #26)
(In reply to comment #25)
There is one unwritten guideline above all others. It's called "consider common sense".
Only after real guidelines.
Nonsense. The guidelines are supposed to be a reflection of the "common sense" and are not a law (and even laws can be changed).
If a -devel package included a couple of "man 3" pages for its API headers and also at least one large PDF file or a huge HTML tree, would you move _all_ %doc files into a separate -doc package?
Man file must stay in main package I though, not in -devel.
Wrong again. Man pages must be part of the subpackage they document. This normally means, *1's need to go to the base package, *3's need to go to *-devel.
No. Nothing in the guidelines says you must decide between either -devel OR -doc. You are free to move the large files into -doc and keep other documentation files in -devel.
The same as with man-pages. In general, doc's need to be part (Or be pulled in through package deps) of the package they document. => user-documentation goes into the base package => devel-docs into *devel packages unless there are technical reasons to do otherwise