<div class="gmail_quote">On Thu, Jul 19, 2012 at 1:26 AM, Manuel Klimek <span dir="ltr"><<a href="mailto:klimek@google.com" target="_blank">klimek@google.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Any comments on the content of the doc, or do you guys think it's fine<br>
to go in? :)<br></blockquote><div><br></div><div>'targetted': the more common spelling is with only 2 't's.</div><div><br></div><div>> $ clang -cc1 -ast-dump-xml test.cc</div><div><div>> ... cutting out internal declarations of clang ...</div>
</div><div><br></div><div>I'd suggest also adding -undef to this command, to reduce the bulk of the internal declarations. In an ideal world, that'd remove all of them, but we still include __int64_t and friends in that mode :(</div>
<div><br></div><div>> In general, -ast-dump-xml dumps declarations as XML and statements as S-expressions.</div><div><br></div><div>This promises more than we deliver. ... "dumps declarations in an XML-style format and statements in an S-expression-style format" is closer to the truth :)</div>
<div><br></div><div>>  declaration statement that delcares our result variable</div><div><br></div><div>Typo: 'delcares'</div><div><br></div><div>> Clang's AST nodes are modeled on a type hierarchy that does not have a common ancestor.</div>
<div><br></div><div>s/type/class/, to avoid confusion with clang::Type.</div><div><br></div><div>> Instead, there are multiple larger hierarchies for basic node types like Decl and Stmt. </div><div><br></div><div>It might be useful to say that many of the important AST nodes derive from Type, Decl, DeclContext or Stmt, with some classes deriving from both Decl and DeclContext.</div>
<div><br></div><div>I think the document could do with some discussion of the Type hierarchy, QualType, canonical types and type sugar.</div></div>