[PATCH] CMake targets for building man pages

Chris Matthews chris.matthews at apple.com
Tue Jun 16 12:47:19 PDT 2015


I think we have decided we will be able to do this. Please go ahead.

> On Jun 15, 2015, at 4:10 PM, Andrew Wilkins <axwalk at gmail.com> wrote:
> 
> On Tue, 16 Jun 2015 at 06:55 Chris Matthews <chris.matthews at apple.com <mailto: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 <mailto:gribozavr at gmail.com>> wrote:
> >
> > On Fri, Jun 12, 2015 at 2:47 PM, Sean Silva <chisophugis at gmail.com <mailto:chisophugis at gmail.com>> wrote:
> >>
> >>
> >> On Fri, Jun 12, 2015 at 2:01 AM, Andrew Wilkins <axwalk at gmail.com <mailto:axwalk at gmail.com>> wrote:
> >>>
> >>> In http://reviews.llvm.org/D10304#185908 <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 <mailto:gribozavr at gmail.com>>*/
> 

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.llvm.org/pipermail/cfe-commits/attachments/20150616/23461081/attachment.html>


More information about the cfe-commits mailing list