ba7aca3b38
Comment to HTML and XML conversion: ignore commands that contain a declaration
...
as their argument. For example, \fn, \function, \typedef, \method, \class etc.
llvm-svn: 161601
2012-08-09 18:20:29 +00:00
dcbc8ce2b5
Comment to HTML and XML conversion: use CommandTraits to classify commands.
...
This also fixes a bug in comment to XML conversion: \result was just an
ordinary paragraph, not an alias for \returns.
llvm-svn: 161596
2012-08-09 17:33:20 +00:00
6cffc1928a
Comment XML: use xml:space="preserve" in Verbatim tags, so that XML tidy does
...
not compress spaces in verbatim content.
llvm-svn: 161531
2012-08-08 22:10:24 +00:00
168d23414a
Comment AST: DeclInfo: add a special kind for enums.
...
Comment XML: add a root node kind for enums.
llvm-svn: 161442
2012-08-07 18:59:04 +00:00
740c0fbe0e
libclang API for comment-to-xml conversion.
...
The implementation also includes a Relax NG schema and tests for the schema
itself. The schema is used in c-index-test to verify that XML documents we
produce are valid. In order to do the validation, we add an optional libxml2
dependency for c-index-test.
Credits for CMake part go to Doug Gregor. Credits for Autoconf part go to Eric
Christopher. Thanks!
llvm-svn: 161431
2012-08-07 17:54:38 +00:00
58e4131995
Comment to HTML conversion: correct typo in CSS class name: taram -> tparam
...
llvm-svn: 161145
2012-08-01 23:47:30 +00:00
3a770d0fe4
Comment to HTML conversion: refactor. Extracted a class to for FullComment
...
semantic parts -- this will be reused for comment to XML conversion.
llvm-svn: 161139
2012-08-01 22:48:16 +00:00
307cf89b19
Comment to HTML conversion: skip \tparam commands with whitespace paragraphs
...
llvm-svn: 161096
2012-08-01 00:48:00 +00:00
7c0456f91b
Comment to HTML conversion: escape HTML special characters in command arguments
...
llvm-svn: 161094
2012-08-01 00:21:12 +00:00
34df220410
Comment parsing: add support for \tparam command on all levels.
...
The only caveat is renumbering CXCommentKind enum for aesthetic reasons -- this
breaks libclang binary compatibility, but should not be a problem since API is
so new.
This also fixes PR13372 as a side-effect.
llvm-svn: 161087
2012-07-31 22:37:06 +00:00
3af5f73344
Move comment from member operator() to class.
...
llvm-svn: 160980
2012-07-30 19:47:34 +00:00
5de4c064c1
Add missing include for Linux buildbot
...
llvm-svn: 160971
2012-07-30 17:49:32 +00:00
a260c030b8
Add an assert to ParamCommandComment::getParamIndex() -- it should not be
...
called unless index is valid.
llvm-svn: 160970
2012-07-30 17:38:19 +00:00
6b375193a2
libclang comment to HTML rendering: \result is the same as \returns
...
llvm-svn: 160738
2012-07-25 17:14:58 +00:00
378458d597
libclang comments AST: clang_ParamCommandComment_getParamName: don't assert
...
when a \param command does not have a parameter name, just return an empty
string instead.
llvm-svn: 160638
2012-07-23 19:41:49 +00:00
d73e4ce992
Comment AST: add InlineContentComment::RenderKind to specify a default
...
rendering mode for clients that don't want to interpret Doxygen commands.
Also add a libclang API to query this information.
llvm-svn: 160633
2012-07-23 16:43:01 +00:00
4c6d7a2ed2
Comment to HTML conversion: add more CSS classes to identify function arguments
...
by index. This is useful if the user does not document all arguments, and we
can't find a particular argument by index via :nth-of-type() CSS selector.
llvm-svn: 160595
2012-07-21 01:47:43 +00:00
5e4fe00e64
Add libclang APIs to walk comments ASTs and an API to convert a comment to an
...
HTML fragment.
For testing, c-index-test now has even more output:
* HTML rendering of a comment
* comment AST tree dump in S-expressions like Comment::dump(), but implemented
* with libclang APIs.
llvm-svn: 160577
2012-07-20 21:34:34 +00:00
Dmitri Gribenko