[maemo-developers] D-BUS service name confusion

[From: Eero Tamminen]

Hi,

ext Kimmo Hämäläinen wrote:
>> - The documentation of osso_initialize() is wrong/misleading.
> ...
> 
> libosso.h says:
> * @param application The name of the application.
>  * This name forms the last part of the default (D-BUS) service name of the
>  * application. Note that the D-BUS service name will be
>  * 'com.nokia.application', where 'application' is the value you gave as the
>  * parameter. Note also that this argument must be identical to the
>  * X-Osso-Service value in the desktop file, or the D-BUS daemon will kill
>  * your application. 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'.
>  * The only valid characters that the name may contain are letters a-z and
>  * the underscore '_'.
> 
> Is it wrong?

I think mentioning the internal shortcut used by Nokia applications
is wrong (legacy from years ago times when there were no other
applications).  Nowadays it should document just the full path name
case like should rest of the documentation.


	- Eero