William S Fulton
ac85784a76
Doxygen source rename
...
Source/DoxygenTranslator/src directory is renamed Source/Doxygen
Renamed files in this directory to short names using lowercase as is the
convention for the rest of the SWIG source.
C++ extension is also .cxx like other SWIG source code.
I used doxy as the prefix for most file renames because without this
Doxygen/parser.* would be easily confused with CParse/parser.* so
Doxygen/doxyparser.* is renamed from DoxygenTranslator/src/DoxygenParser.*
2018-05-26 12:52:52 +01:00
William S Fulton
d1e0912ac0
Correct source code headers
2018-05-25 23:35:06 +01:00
William S Fulton
658eb26e19
Beautify doxygen source code
...
Just whitespace changes
2018-05-25 07:56:44 +01:00
Vadim Zeitlin
751f617aac
Add support for doxygen:alias feature
...
This allows to replace non-standard Doxygen commands with some (fixed) text
instead of just ignoring them, as was already possible with the feature
doxygen:ignore.
2017-02-01 02:20:47 +01:00
Vadim Zeitlin
4e7dad2b76
Get rid of meaningless return type of DoxygenParser methods
...
The return value of methods handling various Doxygen commands was never
actually used, so just get rid of it and don't return anything, this makes the
code slightly simpler without any change of functionality.
It also makes the question about why all these functions return "int" (which
should have been "bool" from the beginning) obsolete.
2017-02-01 01:53:31 +01:00
Vadim Zeitlin
71c4e55fd9
Return enum, not untyped int, when classifying Doxygen commands
...
This makes the purpose of DoxygenParser::commandBelongs() more clear and also
allows the compiler to check that we handle all of its possible return values.
And it actually turns out that we didn't, so add the missing values now to
avoid changing the behaviour in any way in this commit, but they will be dealt
with later.
2017-02-01 01:43:11 +01:00
Vadim Zeitlin
87ae580d75
Get rid of unnecessary "typedef enum" in C++ code
...
No real changes, just remove this C-ism from C++ DoxygenParser class code.
2017-02-01 01:38:43 +01:00
Vadim Zeitlin
05b5ed11bc
Add a possibility to flexibly ignore custom Doxygen tags.
...
Add %feature("doxygen:ignore:<command>") implementation, documentation and
test case.
This feature allows to use custom tags in C++ Doxygen comments for
C++-specific things that don't make sense in the context of the target
language and also allows to insert contents specific to the target language in
the C++ comments using (different) custom commands, which is very useful in
practice to explain the particularities of the API wrappers.
2014-09-11 01:39:42 +02:00
Vadim Zeitlin
dc3102a535
Pass the node the Doxygen comment is attached to to DoxygenParser.
...
This will be needed to take into account various Doxygen-specific features
that can be attached to this node.
2014-09-03 17:28:23 +02:00
Vadim Zeitlin
a7b67a2cac
Get rid of findCommand() which duplicaed commandBelongs().
...
There is no need for two functions for finding the value of a key in the map.
2014-09-03 17:28:23 +02:00
Vadim Zeitlin
f256f0107e
Recognize unknown Doxygen tags correctly.
...
DoxygenParser::commandBelongs() returned the same value (0) for simple
commands and unrecognized commands. Fix this by returning a different NONE
value for the latter.
2014-09-03 17:28:23 +02:00
Marko Klopcic
1883797742
refactored comment tokenizer
2013-01-29 22:58:10 +01:00
Marko Klopcic
8de06366cf
fixed handling of quoted text adn standalone backslash and @
2013-01-23 23:15:36 +01:00
Marko Klopcic
13d2dad679
added tests for HTML tags, bugs in HTML tags fixed
2013-01-18 21:21:12 +01:00
Marko Klopcic
7984516b31
implemented translation of HTML tags - they are handled as a special class of commands
2013-01-16 23:15:14 +01:00
Marko Klopcic
a9ef35bc66
Parsing of comments to tokens rewritten so that html entities and html tags are now treated as commands. Whitespaces are also preserved more acurately, so some doxygen tests fail at the moment
2013-01-10 08:51:56 +01:00
Marko Klopcic
af74b4f96a
renamed test case
...
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2012-doxygen@13726 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2012-08-27 20:25:00 +00:00
Marko Klopcic
46f2a16608
more refactoring, typedefs were introduced, DoxyCommandEnum moved to DoxygenParser
...
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2012-doxygen@13725 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2012-08-26 20:07:57 +00:00
Marko Klopcic
c9eda79264
refactored DoxygenEntity class
...
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2012-doxygen@13724 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2012-08-26 15:34:46 +00:00
Marko Klopcic
ed6df45c0a
refactored DoxygenParser: class Token is now nested in Doxygen parser because it is only used there, class TokenList has been removed - it more or less duplicated std::list, other code moved to DoxygenParser
...
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2012-doxygen@13722 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2012-08-26 13:00:52 +00:00
Dmitry Kabak
cecc793782
Various small code fixes. Some unwanted code removed.
...
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2012-doxygen@13551 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2012-08-07 20:04:23 +00:00
Dmitry Kabak
3fbe45f0c6
Added nice doxygen debug switching (-debug-doxygen-parser and -debug-doxygen-translator)
...
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2012-doxygen@13427 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2012-07-29 13:48:03 +00:00
Dmitry Kabak
ed1bd4fbb9
Implemented nice error output, with filename and line number information.
...
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2012-doxygen@13313 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2012-07-10 17:17:51 +00:00
Dmitry Kabak
509cbd72b0
Small JavaDoc converter and doxygen parser improvements, now basic tags working
...
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2012-doxygen@13263 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2012-07-07 13:47:35 +00:00
Dmitry Kabak
13adf595ec
Refactored the code, got rid of global objects, got rid of tons of string comparisons
...
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2012-doxygen@13253 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2012-07-04 22:23:22 +00:00
William S Fulton
02fbe37ae6
Add new GPL license headers to source files added in this branch
...
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2008-cherylfoil@11911 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2010-03-06 11:47:21 +00:00
William S Fulton
19d90026ef
formatting fixes after running make beautify plus a few manual formatting fixes
...
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2008-cherylfoil@11699 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2009-10-13 23:26:01 +00:00
Jamie Kirkpatrick
d12b8bc06e
Remove "using std" clause and use namespaces properly. Minor refactoring as well.
...
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2008-cherylfoil@10839 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2008-09-12 11:18:35 +00:00
Cheryl Foil
88bd4e6331
Removal of unneeded importants; debugging parser
...
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2008-cherylfoil@10777 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2008-08-18 04:54:35 +00:00
Cheryl Foil
4f2a579d6d
Now works end to end :) DoxygenTranslator restructured and placed into SWIG, Changes to java.cxx and
...
lang.cxx to accomodate this
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2008-cherylfoil@10761 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2008-08-15 23:36:18 +00:00