r207392 - libclang: split out the documentation comment API

[Dmitri Gribenko]

On Mon, Apr 28, 2014 at 3:39 AM, Alp Toker <alp at nuanti.com> wrote:
> Author: alp
> Date: Sun Apr 27 21:39:27 2014
> New Revision: 207392
>
> URL: http://llvm.org/viewvc/llvm-project?rev=207392&view=rev
> Log:
> libclang: split out the documentation comment API
>
> It's possible that the "comment AST" may be replaced or split out in the
> midterm, any anyway this makes the headers easier to read.
>
> Developers don't currently need to include "clang-c/Documentation.h" explicitly
> and there's no macro to test for availability yet.
>
> The raw comment and brief comment accessors have been kept in Index.h though
> brief support may also move here as a separate proposal.
>
> This is not a deprecation, just a gentle separation of concerns as we look to
> simplify the built-in representation of comment nodes and support external
> comment processors.

Alp,

If you would like to "simplify" built-in representation of comment
nodes by replacing or splitting out a major part of implementation,
please discuss this first.  You have never replied to my other email,
where I said that it is unclear to me what your goals are, and without
understanding the goals it is impossible to review changes like that.

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>*/