Commit graph

30 commits

Author SHA1 Message Date
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