[Bug 521909] Review Request: ne7ssh - SSH Library is a Secure Shell client software written in C++

[bugzilla at redhat.com]

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 at freenet.de> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |rc040203 at freenet.de




--- Comment #27 from Ralf Corsepius <rc040203 at 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

-- 
Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are on the CC list for the bug.