maemo.org Bugzilla – Bug 3205
Important sentence missing in description of osso_initialize()
Last modified: 2009-06-10 19:29:05 UTC
You need to
before you can comment on or make changes to this bug.
The description of osso_initialize() is the libosso API reference (see URL) is
not complete. If you compare it with the description which can be found in
libosso.h you'll notice that the sentence
"If you do not want to use the default 'com.nokia' prefix, you must pass the
whole D-Bus service name, e.g. 'org.maemo.my_app'."
is missing. This leads to the wrong impression that your service name must be
of the form "com.nokia.<application>" and only <application> should be used as
Maybe it's best to drop all the confusing "com.nokia" stuff anyway (which is
not of interest for third party developers) and simply say that the full
service name, e.g. 'org.maemo.my_app', should be specified as first argument!?
The required sentence has been added to the 4.1 documentation:
Closing as FIXED.
Moving Documentation component from maemo.org to Development Platform since the
bugs there refer to official developer documentation and this falls out of the
responsibility of the community.
Sorry for the noise, you can filter your bugmail by searching for this comment.
Mass-moving package specific complaints about API documentation to the
corresponding packages plus adding "docs" keyword.
Doing this as API documentation is maintained by the developers and hence bug
reports are not visible enough if they are filed under "Development platform >
You can filter your bugmail by searching for "docs-cleanup-20090610".
Sorry for the noise.