jyapayne/swig
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Added support for parsing of missing doxygen commands. Now parser produces correct parse tree for every doxygen tag, at least for those included in the testcase. Also added the test with all the tags, even those that will be ignored later.

Browse source 
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2012-doxygen@13322 626c5289-ae23-0410-ae9c-e8d60b6d4f22
This commit is contained in:
Dmitry Kabak 2012-07-14 22:41:41 +00:00
commit 4ce9f2361c
4 changed files with 401 additions and 17 deletions
Download patch file Download diff file Expand all files Collapse all files

338
Examples/test-suite/doxygen_translate_all_tags.i Normal file
View file

@ -0,0 +1,338 @@
%module doxygen_translate
%inline %{
/**
* \a Hello
*
* \addindex SomeLatexIndex
*
* \addtogroup someGroup "Some title"
*
* \anchor theAnchor
*
* \arg some list item
*
* \attention This is attention!
* You were warned!
*
* \authors lots of them
*
* \author Zubr
*
* \b boldword
*
* \brief Some brief description,
* extended to many lines.
*
* \bug Not everything works right now...
*
* \c codeword
*
* \callgraph
*
* \callergraph
*
* \category someCategory headerFile.h headerName
*
* \cite citationword
*
* \class someClass headerFile.h headerName
*
* \code some test code \endcode
*
* \cond SOMECONDITION
* Some conditional comment
* \endcond
*
* \copybrief someClass::someMethod
*
* \copydetails someClass::someMethod2
*
* \copydoc someClass::someMethod3
*
* \copyright some copyright
*
* \date 1970 - 2012
*
* \def someDefine
*
* \defgroup someGroup Some titles
*
* \deprecated Now use another function
*
* \details This is very large
* and detailed description of some thing
*
* \dir /somePath/someFolder
*
* \dontinclude someFile.h
*
* \dot
* digraph example {
* node [shape=record, fontname=Helvetica, fontsize=10];
* b [ label="class B" URL="\ref B"];
* c [ label="class C" URL="\ref C"];
* b -> c [ arrowhead="open", style="dashed" ];
* }
* \enddot
*
* \dotfile dotFile.dot "The caption"
*
* \e italicword
*
* \em emphazedWord
*
* \enum someEnum
*
* \example someFile.txt
* Some details on using the example
*
* \exception SuperError
*
* \extends someOtherFunction
*
* \f$ \sqrt{(x_2-x_1)^2+(y_2-y_1)^2} \f$
*
* \f[
* \sqrt{(x_2-x_1)^2+(y_2-y_1)^2}
* \f]
*
* \f{
* \sqrt{(x_2-x_1)^2+(y_2-y_1)^2}
* \f}
*
* \file file.h
*
* \fn someFn
*
* \headerfile someHeader.h "Header name"
*
* \hideinitializer
*
* \htmlinclude htmlFile.htm
*
* \htmlonly
* This will only appear in hmtl
* \endhtmlonly
*
* \if ANOTHERCONDITION
* First part of comment
* \if SECONDCONDITION
* Nested condition text
* \elseif THIRDCONDITION
* The third condition text
* \else
* The last text block
* \endif
* \else
* Second part of comment
* \if CONDITION
* Second part extended
* \endif
* \endif
*
* \ifnot SOMECONDITION
* This is printed if not
* \endif
*
* \image html testImage.bmp "Hello, world!" asd=10qwe
*
* \implements someFunction
*
* \include header.h
*
* \includelineno header2.h
*
* \ingroup someGroup anotherGroup
*
* \internal
*
* \invariant Some text
* describing invariant.
*
* \interface someInterface someHeader.h "Header name"
*
* \latexonly
* This will only appear in LATeX
* \endlatexonly
*
* <ul>
*
* \li Some unordered list
* \li With lots of items
* \li lots of lots of items
*
* </ul>
*
* \line example
*
* \link someMember Some description follows \endlink
*
* \mainpage Some title
*
* \manonly
* This will only appear in man
* \endmanonly
*
* \memberof someThing
*
* \msc
* Sender,Receiver;
* Sender->Receiver [label="Command()", URL="\ref Receiver::Command()"];
* Sender<-Receiver [label="Ack()", URL="\ref Ack()", ID="1"];
* \endmsc
*
* \mscfile mscFile.msc "The caption"
*
* \n \n \n
*
* \name someHeader.h
*
* \namespace someNamespace
*
* \nosubgrouping
*
* \note Here
* is the note!
*
* \overload
*
* \p someword
*
* \package superPackage
*
* \page somePage The title
*
* \par The paragraph title
* The paragraph text.
* Maybe even multiline
*
* \paragraph someParagraph Paragraph title
*
* \param a the first param
*
* \post Some description
*
* \pre Some description
*
* \private
*
* \privatesection
*
* \property someVar
*
* \protected
*
* \protectedsection
*
* \protocol someProtocol header.h "Header name"
*
* \public
*
* \publicsection
*
* \ref someAnchor
*
* \related toSomething
*
* \relates toSomethingElse
*
* \relatedalso someName
*
* \relatesalso someName
*
* \remark Some remark text
*
* \remarks Another remarks section
*
* \result Whatever
*
* \return it
*
* \returns may return
*
* \retval someValue Some description
*
* \rtfonly
* This will only appear in RTF
* \endrtfonly
*
* \sa someOtherMethod
*
* \section someSection Some title
*
* \see function
*
* \short Same as
* brief description
*
* \showinitializer
*
* \since version 0.0.0.1
*
* \skip somePattern
*
* \skipline someLine
*
* \snippet example.h Some snippet
*
* \struct someStruct
*
* \subpage someSubpage "Some description"
*
* \subsection someSubsection Some title
*
* \subsubsection someSubsection Some title
*
* \tableofcontents
*
* \test Some
* description of the
* test case
*
* \throw superException
*
* \throws RuntimeError
*
* \todo Some very important task
*
* \tparam b B is mentioned again...
*
* \typedef someTypedef
*
* \union someUnion
*
* \until somePattern
*
* \var someVar
*
* \verbatim
* very long
* text with tags <sometag>
* \endverbatim
*
* \verbinclude someFile.h
*
* \version 0.0.0.2
*
* \warning This is senseless!
*
* \weakgroup someGroup Some title
*
* \xmlonly
* This will only appear in XML
* \endxmlonly
*
* \xrefitem todo "Todo" "Todo List"
*
* Here goes test of symbols:
* \$ \@ \\ \& \~ \< \> \# \% \" \. \::
*
* And here goes simple text
*/
int function(int a, float b)
{
}
%}