Commit graph

35 commits

Author SHA1 Message Date
Vadim Zeitlin
a76c1343b7 Simplify management of tag handlers in PyDocConverter.
Avoid having to pass dummy empty string arguments, just use default value for
the unused last parameter of handleParagraph().

Also get rid of dozens of "" occurrences in the tag map initialization code,
use a helper function instead.

No real changes.
2014-08-13 16:11:30 +02:00
Vadim Zeitlin
f684242467 Replace DoxygenTranslator debug parameters with a single flags one.
This makes the code more readable and more extensible as more flags are easier
to add in the future than more boolean parameters.

No user-visible changes.
2014-08-13 16:11:30 +02:00
Vadim Zeitlin
5c0ed6c635 No changes, just spelling fixes in Doxygen branch changes.
Most are just typos, but also s/JavaDoc/Javadoc/ and s/PythonDoc/Pydoc/ as
this is how they are officially called.
2014-05-07 19:12:10 +02:00
Marko Klopcic
4663fce63c fixed bug in handling of ref tag in Java, added handling in Python 2013-03-17 20:09:34 +01:00
Marko Klopcic
3b7908fa6e fixed leading spaces for the second row of table in pydoc, sources formatted 2013-02-23 15:20:27 +01:00
Marko Klopcic
0b6bc80038 Translation of HTML tags to Python almost finished 2013-02-13 23:06:20 +01:00
Marko Klopcic
560dedb6c0 added handling of HTML tags and HTML entities to PyDocConverter, updated tests 2013-02-12 22:58:50 +01:00
Marko Klopcic
29d1bba70a improved comment formatting for Python 2013-02-02 23:01:09 +01: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
dfad1c8156 Fixed param description alignment in PyDoc translator
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2012-doxygen@13667 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2012-08-19 13:58:12 +00:00
Dmitry Kabak
0d35785724 Small cosmetic changes to generated comments
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2012-doxygen@13647 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2012-08-17 23:47:56 +00:00
Dmitry Kabak
316be573f8 Fixed lots of PyDoc converter problems, see doxygen_tricky_constructs test
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2012-doxygen@13633 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2012-08-16 14:18:47 +00:00
Dmitry Kabak
f7f3960d11 Eliminate 'signed/unsigned comparison' compiler warning
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2012-doxygen@13582 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2012-08-10 12:27:40 +00:00
Dmitry Kabak
7178385d48 Made comment output nicer, now printing _someword_ instead of _someword _
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2012-doxygen@13576 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2012-08-09 18:58:53 +00:00
Dmitry Kabak
0a3db948cc Fixed possible bug: as the return value of makeDocumentation is never checked, don't return null pointers, even in case of errors
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2012-doxygen@13518 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2012-08-05 14:18:46 +00:00
Dmitry Kabak
346fdfcab7 Added doxygen:notranslate feature, to prevent running of automatic comment translation
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2012-doxygen@13517 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2012-08-05 14:16:57 +00:00
Dmitry Kabak
c72a56c6f1 Small fix to display params type correctly in PyDocConverter
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2012-doxygen@13484 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2012-08-02 12:22:26 +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
03da0be1fa Fixed numerous 'unused argument' warnings
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2012-doxygen@13426 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2012-07-29 11:53:01 +00:00
Dmitry Kabak
0b7d1ffc45 Small fix to correctly generate overloaded method comments in python
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2012-doxygen@13400 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2012-07-25 12:11:28 +00:00
Dmitry Kabak
c56d5fcf90 Some code refactoring and all of the doxy commands are working for the python comment translator
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2012-doxygen@13335 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2012-07-19 16:08:11 +00:00
Dmitry Kabak
d9e8d140e7 Refactored PyDocConverter class, implemented some commands
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2012-doxygen@13331 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2012-07-18 22:05:19 +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
4289b8e273 Refactored comment translator class, implemented result caching
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2012-doxygen@13191 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2012-06-25 15:47:36 +00:00
Dmitry Kabak
72b23954fb Fix integration of doxygen with autodoc feature, fixed autodoc test and some code refactored
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2012-doxygen@13183 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2012-06-18 18:33:30 +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
06269a50a5 Apply modified patch 2879724 from Marko Klopcic
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2008-cherylfoil@11716 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2009-11-01 22:05:01 +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
William S Fulton
45518cd0d1 apply doxygen-svndiff.patch from #2763155
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2008-cherylfoil@11697 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2009-10-13 21:27:09 +00:00
Jamie Kirkpatrick
8d28e0faad Reformatting.
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2008-cherylfoil@10845 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2008-09-12 11:22:04 +00:00
Jamie Kirkpatrick
83cef07b90 Multiple documentation sections are now concatted into one where there are various overloads for methods with the same name.
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2008-cherylfoil@10844 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2008-09-12 11:21:40 +00:00
Jamie Kirkpatrick
01695a3128 Major refactoring: translation now takes a node and returns a translated comment if there is one.
This is to allow for situations where you need to use several nodes to create a comment, for example where there are multiple overloads for the same function but the target language doesnt support overloading: in this case we want to combine comments to explain the possible overloads.


git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2008-cherylfoil@10843 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2008-09-12 11:20:58 +00:00
Jamie Kirkpatrick
d7f2ceedd4 Improve output so that the width of the docstrings can be controlled.
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2008-cherylfoil@10841 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2008-09-12 11:19:32 +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
Jamie Kirkpatrick
0db7edfa63 Progress towards a working pydoc implementation.
- Nodes are now passed to the documentation translator so that type information can be looked up and used in parameter comments.
- Class comments are now inserted as well as some method information,


git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/branches/gsoc2008-cherylfoil@10838 626c5289-ae23-0410-ae9c-e8d60b6d4f22
2008-09-12 11:17:39 +00:00