[IAEP] Alpha API Docs are up.
Carol Lerche
cafl at msbit.com
Sun Jun 8 17:44:11 CEST 2008
Doxygen will do Python as well as C, C++ and other languages:
http://internetducttape.com/2007/03/20/automatic_documentation_python_doxygen/
http://www.stack.nl/~dimitri/doxygen/docblocks.html#pythonblocks
On Sun, Jun 8, 2008 at 8:17 AM, David Farning <dfarning at gmail.com> wrote:
> A very early alpha of the API documentation is now up at
> http://www.sugarlabs.org/~dfarning/<http://www.sugarlabs.org/%7Edfarning/>.
>
> The API are generated using epydoc which has a number of pros and cons.
>
> Pros:
> Uses standard python docstrings- there is no commitment to epydoc in
> the future.
> Very easy.
> Docstrings can be extended using epytext, reStructuredText and
> Javadoc.
>
> Cons:
> The parser is more strict than the standard python parser. It catches
> some formatting errors that the python interrupter is able to handles.
> In many files the parser stopped before it reached the end of the file.
> I will put up a log file so developers can see what errors it is
> catching.
>
> Epydoc only documents python files. I haven't looked to deeply into
> the code but it looks like there are several c files in sugar-base and
> sugar-toolkit. Do we want those documented?
>
> Thanks
> Dfarning
>
> _______________________________________________
> Its.an.education.project mailing list
> Its.an.education.project at lists.lo-res.org
> http://lists.lo-res.org/mailman/listinfo/its.an.education.project
>
--
"Always do right," said Mark Twain. "This will gratify some people and
astonish the rest."
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.lo-res.org/pipermail/its.an.education.project/attachments/20080608/e0c9eb8a/attachment.htm>
More information about the Its.an.education.project
mailing list