[cfe-dev] Headers from C++ standard

[Richard Smith via cfe-dev]

The below is the sort of thing I'd suggest. You'll probably need some
manual massaging to get the extraction exactly right, though.

Also, the synopses do not typically include class definitions, just a
"class X;" style declaration, so if that's a problem for you then you'll
need to do a bit more work to extract those too.
On 9 May 2016 8:51 a.m., "Kim Gräsman" <cfe-dev at lists.llvm.org> wrote:

> Hi Eric,
>
> On Mon, May 9, 2016 at 3:30 PM, Eric Liu via cfe-dev
> <cfe-dev at lists.llvm.org> wrote:
> >
> > As an alternative, we are thinking about parsing header synopses from C++
> > standard. So, we are wondering if there are existing syntax-correct
> header
> > synopses in the form of C++ header files somewhere that we can use. If
> not,
> > Manual(@klimek) suggests that maybe we could have the header synopses as
> C++
> > header files and have the standard draft includes them so that syntax
> can be
> > easily checked, and we can conveniently parse the synopses too.
>
> We've had similar plans for IWYU, and I think we eventually parsed the
> TeX source from https://github.com/cplusplus/draft/tree/master/source
> with a simple shell script.
>
> I didn't do this myself, but I found a couple of examples in our source
> here:
>
>   // These headers are defined in C++14 [headers]p3.  You can get them with
>   // $ sed -n '/begin{floattable}.*{tab:cpp.c.headers}/,/end{floattable}/p'
> lib-intro.tex | grep tcode | perl -nle 'm/tcode{<c(.*)>}/ && print qq@
>  { "<$1.h>", kPublic, "<c$1>", kPublic },@' | sort
>   // on
> https://github.com/cplusplus/draft/blob/master/source/lib-intro.tex
>
>   // These headers are defined in C++14 [headers]p2.  You can get them with
>   // $ sed -n
> '/begin{floattable}.*{tab:cpp.library.headers}/,/end{floattable}/p'
> lib-intro.tex | grep tcode | perl -nle 'm/tcode{(.*)}/ && print qq@
> "$1",@' | sort
>   // on
> https://github.com/cplusplus/draft/blob/master/source/lib-intro.tex
>
> (from
> https://github.com/include-what-you-use/include-what-you-use/blob/master/iwyu_include_picker.cc
> )
>
> Assuming you want this to be portable I'm sure you can do something
> similar in C++ relatively easily.
>
> FWIW,
> - Kim
> _______________________________________________
> cfe-dev mailing list
> cfe-dev at lists.llvm.org
> http://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-dev
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.llvm.org/pipermail/cfe-dev/attachments/20160509/c7d4624f/attachment.html>