Bug 41803 – RPM api manpages not in /usr/share/man/man3

Bug 41803 - RPM api manpages not in /usr/share/man/man3

Summary:	RPM api manpages not in /usr/share/man/man3

Status:	CLOSED WONTFIX

Aliases:	None

Product:	Red Hat Linux
Classification:	Retired
Component:	rpm (Show other bugs)
Sub Component:
Version:	7.1
Hardware:	All Linux

Priority	medium Severity medium
Target Milestone:	---
Target Release:	---
Assigned To:	Jeff Johnson
QA Contact:	David Lawrence
Docs Contact:

URL:
Whiteboard:
Keywords:

Depends On:
Blocks:
	Show dependency tree / graph

Reported:	2001-05-22 05:23 EDT by Mike A. Harris
Modified:	2007-04-18 12:33 EDT (History)
CC List:	0 users

See Also:
Fixed In Version:
Doc Type:	Bug Fix
Doc Text:
Story Points:	---
Clone Of:
Environment:
Last Closed:	2001-05-22 05:23:23 EDT
Type:	---
Regression:	---
Mount Type:	---
Documentation:	---
CRM:
Verified Versions:
Category:	---
oVirt Team:	---
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---

Attachments	(Terms of Use)
Add an attachment (proposed patch, testcase, etc.)

Groups: None (edit)

Description Mike A. Harris 2001-05-22 05:23:19 EDT

The man pages for the RPM API are not contained in the system manpage
directories, and are as such, not in the manpath.  They are currently
located in /usr/share/doc/rpm-devel-4.0.x/apidocs/man3

These should be moved to the proper location so that man can find them.

Comment 1 Jeff Johnson 2001-05-22 12:15:46 EDT

I disagree because
	1) doxygen generated man pages are a bit frothy. For example,
	almost every function in rpm is documented, and doxygen spits a
	different man page for each. Overkill, IMHO.
	2) the documentation is a bit flimsy, adding to /usr/share/man is
	just gonna create a mass of tedious bug reports about
	insignificant minutiae.
	3) there are only a handful of people who are programming
	directly against rpmlib. Over 50% of those people are me,
	myself, and I, and I certainly don't need or want man pages
	in /usr/share/man

I expect that the doxygen generated man pages will be ripped out at
some point, possibly the apidocs as well. It's early yet ...

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