Bug 144630 - RPM manpages don't point to documentation of advanced features
Summary: RPM manpages don't point to documentation of advanced features
Alias: None
Product: Fedora
Classification: Fedora
Component: rpm   
(Show other bugs)
Version: 3
Hardware: All Linux
Target Milestone: ---
Assignee: Jeff Johnson
QA Contact: Mike McLean
Depends On:
TreeView+ depends on / blocked
Reported: 2005-01-10 03:36 UTC by D. Hugh Redelmeier
Modified: 2007-11-30 22:10 UTC (History)
2 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
Last Closed: 2005-01-10 14:26:02 UTC
Type: ---
Regression: ---
Mount Type: ---
Documentation: ---
Verified Versions:
Category: ---
oVirt Team: ---
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---

Attachments (Terms of Use)

Description D. Hugh Redelmeier 2005-01-10 03:36:06 UTC
Description of problem:
It is hard to find out about newer features of spec files.  The man
pages don't describe them nor do any of the documents listed in SEE ALSO.

It turns out that /usr/share/doc/rpm* contain documents filling in
some of these gaps.  Although these documents could be improved, I
think that they are the best that have been published.

Additional info:

At least rpm(8) and rpmbuild(8) SEE ALSO sections should be updated.

This problem dates back to at least RHL7.0

Comment 1 Jeff Johnson 2005-01-10 14:26:02 UTC
Heh, "newer" is the gap between the publication of "Maximum RPM"
in 1997 and the release of rpm-3.0 in RHL 6.0 in 1998.

The convention of puttingv other, useful, documentation
in the path /usr/share/doc/N-V-R is well enough established
that additional explicit ptrs in man pages is not necessary imho.

Note You need to log in before you can comment on or make changes to this bug.