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

[From: Osvaldo Santana]

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.

> 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

-- 
Osvaldo Santana Neto (aCiDBaSe)
http://www.pythonologia.org