[Swig-devel] GSoC 2012: Doxygen, Weekly Report (August 13-August 20)

[дмитрий к. <use...@gm...>]

*Done:*

   1. Thanks to my mentor, lots of lots of bugs in special cases where
   found and fixed. That's all.
   2. So, as this is my last report, I would like to say that it was
   awesome time coding for SWIG and I would be happy to be a maintainer of
   Doxygen code in SWIG later.

*Commits:*

   1.
   http://swig.svn.sourceforge.net/viewvc/swig?view=revision&revision=13622
   2.
   http://swig.svn.sourceforge.net/viewvc/swig?view=revision&revision=13632
   3.
   http://swig.svn.sourceforge.net/viewvc/swig?view=revision&revision=13633
   4.
   http://swig.svn.sourceforge.net/viewvc/swig?view=revision&revision=13634
   5.
   http://swig.svn.sourceforge.net/viewvc/swig?view=revision&revision=13635
   6.
   http://swig.svn.sourceforge.net/viewvc/swig?view=revision&revision=13636
   7.
   http://swig.svn.sourceforge.net/viewvc/swig?view=revision&revision=13647
   8.
   http://swig.svn.sourceforge.net/viewvc/swig?view=revision&revision=13661
   9.
   http://swig.svn.sourceforge.net/viewvc/swig?view=revision&revision=13663
   10.
   http://swig.svn.sourceforge.net/viewvc/swig?view=revision&revision=13667
   11.
   http://swig.svn.sourceforge.net/viewvc/swig?view=revision&revision=13668

*Open issues:*

   1. Attaching comments to the vars and constants in python is unsupported
   right now. Actually, that's impossible because of current var passing
   technique used in python code. So, I'm giving up solving this issue.
   2. Rewrite tokenizer, or find a way to store whitespace info in current
   design. Definitely after-gsoc part, because that will only affect the
   'niceness' of generated comments.
   3. Also as an after-gsoc plan, rewrite the current parsing code. Right
   now it uses bison grammar, and that's not a really good idea to parse
   comments with that (one of the problems is that any misplaced doxygen
   comment will generate syntax error, and that's not a desired behavior). I
   already have some code parts to assign comments by line-numbers. As David
   Beazley said, that was already implemented some time ago in swig, but it
   was before the main repository was moved to svn and I couldn't find that
   changes. So I wrote an implementation myself, it needs lots of fixes and
   not very stable right now, so I don't want to commit it before the end of
   GSoC as current version is still working and capable of lots of things.

-- 
Regards,
Dmitry Kabak