[maemo-developers] [maemo-developers] Python and maemo API documentation

[From: John P. Mitchell]

On Sun, 28 Jan 2007, Osvaldo Santana wrote:

> Hi Álvaro,
>
> On 1/27/07, Álvaro J. Iradier <airadier at gmail.com> wrote:
>> Hi,
>>
>> I'm developing some python applications for Nokia 770, and I think
>> documentation is not as good as I expected.
>>
>> 1) First, the code in the python tutorial in here:
>>
>> http://www.maemo.org/platform/docs/pymaemo/python_maemo_howto.html
>
> Yes, this document is deprecated now. Please, take a look at the new one at:
>
> http://maemo.org/platform/docs/python-bora/python_maemo_howto.html
>
>> 2) I couldn't find docs for the Python Hildon API, but I looked at the
>> maemo hildon API for C, it should be enough:
>
> We've a new API documentation to Hildon and LibOSSO in the package
> source files (I don't remember now what is the reason why this
> documents aren't uploaded to the site)...
>
> I'll upload it this Monday.
>
>> Other entries, like  API documentation control panel, status bar and
>> home applets are empty too:
>>
>> http://www.maemo.org/platform/docs/api/maemo-af-desktop-sdk-doc/index.html
>>
>> (is this available in Python, by the way).
>
> No, unfortunately we don't have created bindings for Control Panel,
> Status Bar and Home Applets stuff. We have plans to make it until
> June.

     Will there be bindings for the address book interfaces? I could not 
seem to find any in the current python 2.5 release. Thanks.

>
>> 3) I know 'help' command is not available in python for 770, but there
>> should be another version for scratchbox with 'help' available. It
>> would be very useful! Maybe it is already available and I missed it?
>
> We can't build two versions of the same package but you can use your
> distribution's Python to call help(). We don't include docstrings
> inside the Maemo bindings (hildon and osso modules).
>
> Thanks,
> Osvaldo
>
>

--
John P. Mitchell <john at cepros.com>