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

Reply via email to