[PATCH] CMake targets for building man pages

Andrew Wilkins axwalk at gmail.com
Mon Jun 15 16:10:21 PDT 2015


On Tue, 16 Jun 2015 at 06:55 Chris Matthews <chris.matthews at apple.com>
wrote:

> I have been informed that it may take some doing to get Sphinx into our
> build environment.  Can you give me a few days to investigate?
>

No problem. Thank you.


> > On Jun 13, 2015, at 2:25 PM, Dmitri Gribenko <gribozavr at gmail.com>
> wrote:
> >
> > On Fri, Jun 12, 2015 at 2:47 PM, Sean Silva <chisophugis at gmail.com>
> wrote:
> >>
> >>
> >> 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?
> >
> > Using Sphinx in our build system might be a challenge.  Adding Chris
> > Bieneman and Chris Matthews.
> >
> > Dmitri
> >
> > --
> > main(i,j){for(i=2;;i++){for(j=2;j<i;j++){if(!(i%j)){j=0;break;}}if
> > (j){printf("%d\n",i);}}} /*Dmitri Gribenko <gribozavr at gmail.com>*/
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.llvm.org/pipermail/cfe-commits/attachments/20150615/7134de0a/attachment.html>


More information about the cfe-commits mailing list