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

bugzilla at redhat.com bugzilla at redhat.com
Sun Oct 4 04:59:04 UTC 2009


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





--- Comment #29 from Ralf Corsepius <rc040203 at freenet.de>  2009-10-04 00:59:01 EDT ---
(In reply to comment #28)
> > 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.
> I did not know. Please, can you point where it is described more precisely.
It's "common sense" - c.f. the "MANUAL SECTIONS" in man man.

> > 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  
> We speak about separate -doc sub-packages now instead of "user-documentation
> goes into the base package"  
I don't understand this remark.

In general, separate *-doc (sub-)packages only make real sense in very few
occasions, e.g.
1) when docs are optional supplements (e.g. a pdf's formated docs, which are
already available in some other formats)
2) when docs are "big" and can be shared as "noarch"-subpackages between
architectures.
3) when upstream ships docs as separate package
...

-- 
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.




More information about the package-review mailing list