Red Hat Bugzilla – Bug 560151
LLVM package should build llvm-apidoc by default
Last modified: 2010-05-26 15:08:14 EDT
Description of problem:
The llvm package as built in Fedora does not include the doxygen documentation for llvm developers. The spec file says that it is by default not built because it is large. I don't think this is a reasonable justification for omitting it, as developers need it. If the -devel subpackage is included in Fedora, the -apidoc subpackage should be included as well.
Version-Release number of selected component (if applicable):
Steps to Reproduce:
1. none required, repository does not contain llvm-apidoc
repository does not contain llvm-apidoc
repository should contain llvm-apidoc, or alternatively, the documentation should be included in the -devel subpackage.
apidoc has been turned on in Rawhide. The recommended LLVM build process (of having the output directory be separate from the source directory) does not work when doxygen *and* clang are both enabled -- the doxygen sources are not copied properly -- so I've reverted to building within the source directory as per normal
It's been pointed out on the development list that the apidocs generated are indeed unreasonably huge; I've reverted them to disabled by default in 2.7-3.
I have, however, made sure that --with apidoc now actually works. There was a problem building the clang apidocs if the build is done from a directory other than the source root -- even though this was upstream recommendation.
You can still regenerate them yourself (rpmbuild --with apidoc llvm-2.7-3.fc14.src.rpm) , or view the API documentation on LLVM's site.