Am 07.11.2017 um 12:15 schrieb Mois:
One question is if we want to document Inkscape source and Python extension API in the same document
Not sure what you mean by this, but I suppose it's better if they're separate. Doesn't Doxygen generate one page per class/module/interface/whatever? So they would both be automatically linked from an 'index' page...
We could reuse the same configuration or create a new one, imo depends on the relative size of additional changes needed. Perhaps just adding *.py to FILE_PATTERNS and the extension directory to INPUT would do the job and doxygen will index everything nicely? I'm going to experiment with some dummy documentation comments in extensions and see how it'll work.
Btw http://wiki.inkscape.org/wiki/index.php/Doxygen_documentation "Inkscape Doxygen Documentation is not currently available online"
any specific reason for this? Or it's just the ease of generating it locally that renders it unnecessary?
- As far as I know (cave: I'm not a developer, this is only what I gathered from mailing lists and other communication with devs), these are the reasons:
- the Jenkins instance we once used for generating it is disabled, because - there's no maintainer - we have CI via gitlab/Appveyor/(no idea for Mac) now - the website resources (RAM, CPU, disk space) are scarce - we didn't have any requests for it (as far as I know)
So if you would like to generate it via CI and make the result available for the website to either link to or to copy it (and ideally, can also help with that), I think there's no problem with that, and it can be helpful for others (esp. the documenting part) :)
Maren
Cheers, 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