[PATCH] CMake targets for building man pages

Sean Silva chisophugis at gmail.com
Fri Jun 12 14:47:52 PDT 2015


On Fri, Jun 12, 2015 at 2:01 AM, Andrew Wilkins <axwalk at gmail.com> wrote:

> In http://reviews.llvm.org/D10304#185908, @silvas wrote:
>
> > Clang's man page is the only thing that is generated like this. The rest
> use Sphinx's manpage output.
>
>
> @chandlerc given the above, do you still want me to create a
> macro/function? I'm not deeply involved here, so grain of salt, but I think
> it'd be better to converge on one documentation tool (Sphinx) than to
> perpetuate use of multiple formats (Sphinx & pod2man, and whatever else
> there may be). I could look at rewriting the clang.pod file in Sphinx, and
> then use Sphinx in CMake. Is that a reasonable change?
>

I would support converting the clang manpage to Sphinx. Dmitri, IIRC Apple
generates their shipping clang manpage from the pod documentation; do you
know who is the right point of contact so that we can make sure that you
guys smoothly transition to generating it with Sphinx?

-- Sean Silva


>
> BTW, there's this: https://llvm.org/bugs/show_bug.cgi?id=23054, so what's
> there seems to be broken on OS X at least, though I can't verify that.
>
>
> http://reviews.llvm.org/D10304
>
> EMAIL PREFERENCES
>   http://reviews.llvm.org/settings/panel/emailpreferences/
>
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.llvm.org/pipermail/cfe-commits/attachments/20150612/7af19677/attachment.html>


More information about the cfe-commits mailing list