Red Hat Bugzilla – Bug 221894
Add BuildRequires: doxygen to rpm specfile
Last modified: 2007-11-30 17:11:52 EST
Description of problem: I'm looking for detailed documentation on the RPM API http://fedora.redhat.com/docs/drafts/rpm-guide-en/ch16s07.html says: "The RPM bindings for Python are documented along with the C programming API. On a Red Hat Linux system, look in the file /usr/share/doc/rpm-devel-4.1/apidocs/html/group__python.html to see the start of the Python-specific documentation." However, on my FC6 box, I don't have any content in: /usr/share/doc/rpm-devel-4.4.2/apidocs (with rpm-devel-4.4.2-32, and they're not listed in rpm -ql) They're present on my RHEL3 box with rpm-devel-4.2.3-24_nonptl in /usr/share/doc/rpm-devel-4.2.3/apidocs/html/ Did they get deleted, moved to a different package, etc? What's the canonical online location for these docs? I don't see them at rpm.org. Thanks
I found a generated copy online here: http://wraptastic.org/apidocs/html/index.html
(specifically, is rpmExpand exposed directly anywhere by the python bindings? I couldn't find it, only addMacro and delMacro)
Yep, apidocs are not generated if doxygen is not installed in build tree. Note that the URL in #1 no longer has anything to do with your rpm-4.4.2, fork you! Yep, rpmExpand() was never added to rpm-python even after several suggestions from me. The script kiddie's consensus opinion was that applications that use rpm-python should never ever have to know about rpm confuguration elemens. Not my call, mon.
Created attachment 145177 [details] Patch to conditionally BuildRequire doxygen Attached patch is for devel (i.e. F7): adds a BuildRequires on doxygen; conditionalised to ease people wanting to strip down the build. No Changelog entry.
Changing summary to "Add BuildRequires: doxygen to rpm specfile", and moving to devel, since it still affects rpm-devel-4.4.2-38.fc7.i386.rpm pnasrat: OK to apply this and rebuild in devel (with a changelog)?
Having separate htmldocs conditional doesn't make much sense IMO because if the html docs aren't generated, apidocs is empty. Current rawhide unconditionally buildrequires doxygen so the issue is fixed, but if you want to make it conditional on %{with_apidocs} I don't mind.
Oh and as to comments #2 and #3, I'm going to add evalMacro() (or whatever you want to call it) to the python bindings. Always mystified me why there isn't such a method.