On 2010-04-19 17:21, Andrew Flegg <and...@bleb.org> wrote:
On Fri, Apr 16, 2010 at 18:40,  <jarmo.ti...@nokia.com> wrote:

The Maemo documentation infrastructure project has released new
Maemo Info Center documentation service for Maemo platform.
Together with Maemo Info Center service we released also the first
set of official Maemo Fremantle 5 documentation. More Fremantle 5
documentation will be updated to the Maemo Info Center service end
of April.

One thing I'd like to see is a *definitive* Maemo reference library.
Currently, we have docs spread over Forum Nokia, Info Center, the
maemo.org wiki - and then there's the docs that are *duplicated* (with
slightly different versions) between the various places.

Is it feasible to try and get things like the PyMaemo API reference
into the Info Center, and any other popular developer resources (say,
Gtkmm is an obvious example)?

There is already API references for hildonmm and hildon-fmmm, and a tutorial for the C++ bindings in general included in Info Center. If you mean that the gtkmm API reference should be included, then that should be relatively easy.

The API reference is generated by Doxygen, and the index is created with a custom XSLT script that is included in hildonmm and hildon-fmmm:

https://garage.maemo.org/plugins/ggit/browse.php/?p=maemomm;a=blob;f=hildonmm/docs/reference/tagfile-to-eclipse-toc.xsl

The tutorial documentation is Docbook XML, which makes use of the Docbook XSL stylesheets to generate an Eclipse table of contents:

https://garage.maemo.org/plugins/ggit/browse.php/?p=maemomm;a=blob;f=maemomm-documentation/docs/tutorial/eclipse.xsl

We added some paramaters to this file to make things easier:

https://garage.maemo.org/plugins/ggit/browse.php/?p=maemomm;a=blob;f=maemomm-documentation/docs/tutorial/docbook2eclipse-toc.xsl

--
David King | http://amigadave.com/ | dav...@openismus.com
_______________________________________________
maemo-developers mailing list
maemo-developers@maemo.org
https://lists.maemo.org/mailman/listinfo/maemo-developers

Reply via email to