Red Hat Bugzilla – Bug 237238
The API documentation is missing
Last modified: 2007-11-30 17:12:02 EST
Description of problem:
In the subpackge rpm-devel the api doc is complete missing.
The directory /usr/share/doc/rpm-devel-4.4.2/apidocs don't contains any files.
Version-Release number of selected component (if applicable):
The API doco goes missing every time rpm is built on a system without doxygen installed.
The API doco is not tracked with a dependency and is handled optionally for RHL 7x
hysterical reasons (doxygen was not present everywhere) and because doxygen includes
a subpkg that depends on Qt (the licensing at one point in time was wrong) and because
KDE is a huge build dependency for a build tool like rpm to carry.
You can simple add the doxygen dependency at the build require part of the spec
file. And for Qt you don't need KDE. It is an stand alone package.
(In reply to comment #2)
> You can simple add the doxygen dependency at the build require part of the spec
> file. And for Qt you don't need KDE. It is an stand alone package.
No, you missed the point. The doxygen dependency was explicitly, intentionally
NOT listed because rpm is a core OS package. Qt is not, and is in fact quite
heavy with dependencies of its own. It would be far too costly in terms of
dependency overhead to *require* doxygen (and thus Qt, X libs, libjpeg, libpng,
libtiff, libmng, fontconfig, ...ad nauseum) for something as low-level as RPM.
Thus, API docs are built if doxygen is there and not if it isn't. Perfectly
sane and reasonable since they are not required for proper RPM functionality.
Rawhide rpm has the api generation re-enabled (again)