Hey all,
this is a continuation of a thread regarding extensions documentation in
general, but I am starting a new thread due to the slightly different focus.
I made changes that add the python sources to doxygen generation. This
is already somewhat useful, because it is easy to see class methods with
arguments at a glance.
Also made a doxygen 'subpage' for the python extensions, linking to some
common classes in the extensions directory. (note: some input on this
list is welcome)
Now, this is really nice, but has one downside - the Classes list and
the Namespaces list contain python and c++ documentation all mixed up.
Does anyone think it is a problem?
In my opinion, there are enough tools at hand to find the necessary
documentation - e.g. seach, the "Inkscape Source Code Documentation"
subpage, the files list (which is separated because the extensions and
core code are in different directories).
I'd like to know whether any c++ devs would be irked by this.
Otherwise, I'll just submit a pull request.
It is also a possibility to create a new Doxyfile and output the
extension docs in a separate directory. In a sense it 'feels right' for
all documentation to be in one place, though.
Any thoughts?
Regards,
Mois
------------------------------------------------------------------------------
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
_______________________________________________
Inkscape-docs mailing list
Inkscape-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/inkscape-docs