Re: [Graphviz] building doc with Python3
Robin Dunn <[email protected]>
| Newsgroups | gmane.comp.python.wxpython.devel |
|---|---|
| Message-ID | <[email protected]> |
[email protected] wrote: > But the still living question is, where are the doc-files? > e.g. Which file do I need to edit, wenn I modify the Point.Get() > documentation. > Other examples would be Size.Get() and class DateTime. The documentation of the C++ classes comes from wxWidgets/interface/wx. As described in several places, doxygen is used to parse those files into XML and the XML is processed by Phoenix's etg scripts to produce the wrapper generator code and also to generate the ReST files used to produce the documentation. There are also some static, hand-edited files under docs/sphinx/rest_substitutions that are used for things like the overview pages and the example code snippets. In addition, there are documentation snippets for some things in the etg files themselves. These are usually for custom Python-specific additions to the C++ classes, or to fiddle with the documentation objects coming from the C++ classes (via the XML) like some changes I pushed a few hours ago. Finally, the pure python modules (like what is in wx.lib) are documented as regular docstrings in the .py files. -- Robin Dunn Software Craftsman http://wxPython.org -- You received this message because you are subscribed to the Google Groups "wxPython-dev" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. For more options, visit https://groups.google.com/d/optout.