[PATCH] Sphinx-based clang man pages

[Andrew Wilkins]

In http://reviews.llvm.org/D10562#191155, @beanz wrote:

> These patches only modify the CMake build system, not the autoconf build system. Was that intentional? If so, you're only deprecating the pod-based manpage generation for CMake, which means it will still need to be kept in-sync and up-to-date for autoconf generation.


I'm not really sure what the policies, if any, are around breaking packaging. My intention is to set a date to remove the files:

  clang/docs/clang.pod
  clang/docs/tools/Makefile
  clang/docs/tools/manpage.css

Since there'll be a branch for 3.7 soon, that could be done when 3.7 is out.

The change for packagers should be pretty small, assuming they're already building the sphinx docs. If using CMake (nobody yet, I expect), the new target can be used. Otherwise, use Makefile.sphinx directly. The latter is what the Debian packaging scripts do for the LLVM docs and man pages, since there are no targets for them in the autotools build.


http://reviews.llvm.org/D10562

EMAIL PREFERENCES
  http://reviews.llvm.org/settings/panel/emailpreferences/