[maemo-developers] Maemo Info Center library service released with first set of official maemo Fremantle 5 documentation

[From: David King]

On 2010-04-19 17:21, Andrew Flegg <andrew at bleb.org> wrote:
>On Fri, Apr 16, 2010 at 18:40,  <Jarmo.Tikka at 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/ | davidk at openismus.com