Gericom/teak-llvm
1
Fork 0
mirror of https://github.com/Gericom/teak-llvm.git synced 2025-06-27 23:38:59 -04:00
Code Issues Actions Packages Projects Releases Wiki Activity
131,589 Commits 1 Branch 0 Tags 875 MiB
dcbc8ce2b5
Commit Graph

23 Commits

Author SHA1 Message Date
Dmitri Gribenko
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
Dmitri Gribenko
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
Dmitri Gribenko
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
Dmitri Gribenko
94ef6357ca Comment AST: treat enumerators as "variables" in DeclInfo. 
llvm-svn: 161435
 2012-08-07 18:12:22 +00:00
Dmitri Gribenko
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
Dmitri Gribenko
58e4131995 Comment to HTML conversion: correct typo in CSS class name: taram -> tparam 
llvm-svn: 161145
 2012-08-01 23:47:30 +00:00
Dmitri Gribenko
307cf89b19 Comment to HTML conversion: skip \tparam commands with whitespace paragraphs 
llvm-svn: 161096
 2012-08-01 00:48:00 +00:00
Dmitri Gribenko
7c0456f91b Comment to HTML conversion: escape HTML special characters in command arguments 
llvm-svn: 161094
 2012-08-01 00:21:12 +00:00
Dmitri Gribenko
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
Dmitri Gribenko
4586df765e Implement resolving of HTML character references (named: &, decimal: *, 
hex: ) during comment parsing.

Now internal representation of plain text in comment AST does not contain
character references, but the characters themselves.

llvm-svn: 160891
 2012-07-27 20:37:06 +00:00
Dmitri Gribenko
6b375193a2 libclang comment to HTML rendering: \result is the same as \returns 
llvm-svn: 160738
 2012-07-25 17:14:58 +00:00
Dmitri Gribenko
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
Dmitri Gribenko
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
Dmitri Gribenko
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
Dmitri Gribenko
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
77369eead6 CommentBriefParser: use \returns if we can't find the \brief or just a plain 
paragraph.

llvm-svn: 160550
 2012-07-20 17:01:34 +00:00
Dmitri Gribenko
3e242d6d3c CommentBriefParser: make \short should equivalent to \brief, per Doxygen manual. 
llvm-svn: 160383
 2012-07-17 18:35:14 +00:00
Dmitri Gribenko
44cd7e6746 Restrict the set of declaration kinds for which we allow trailing comments. 
llvm-svn: 159878
 2012-07-06 23:27:33 +00:00
Dmitri Gribenko
0743f94671 Cleanup \brief comment. Since it is a single paragraph, no need to save newlines there. 
llvm-svn: 159325
 2012-06-28 01:38:21 +00:00
Dmitri Gribenko
a1e9c8e783 Teach \brief parser about commands that start a new paragraph implicitly 
llvm-svn: 159309
 2012-06-28 00:01:41 +00:00
Dmitri Gribenko
7e8729b904 Attaching documentation comments to declarations: don't attach a comment to a declaration if there is a preprocessor directive between them. 
llvm-svn: 159305
 2012-06-27 23:43:37 +00:00
Dmitri Gribenko
5188c4b9cc Implement a lexer for structured comments. 
llvm-svn: 159223
 2012-06-26 20:39:18 +00:00
Dmitri Gribenko
aab8383a2b Structured comment parsing, first step. 
* Retain comments in the AST
* Serialize/deserialize comments
* Find comments attached to a certain Decl
* Expose raw comment text and SourceRange via libclang

llvm-svn: 158771
 2012-06-20 00:34:58 +00:00