LSARC/2006/455 Avahi and libdaemon

[Brian Cameron]

Padraig:

My understanding of Sun manpage policy is that all libraries
should have manpages, if only to describe that they are Uncommitted
in the ATTRIBUTES section and not to be used.  The fact that there
are many non-Committed JDS libraries that don't meet this policy is
probably not a good excuse either, though probably a better one.

One thing worth mentioning in JDS library manpages is whether the
library is in the GNOME Platform.  If so, the community provides
ABI stability.  For libraries non in the Platform, it's probably
good to mention this as an extra warning.

Brian


> Joseph Kowalski wrote:
>> John Fischer wrote:
>>> I am sponsoring this fast track for Padraig O'Briain from the
>>> JDS - Gnome team in Ireland.  The case directory contains this
>>> proposal and man pages for the various commands.  I have set
>>> the timer for Wednesday August 22nd, 2007.
>> ...
>>
>> If I understand this right, libdaemon is a general purpose purpose
>> library to make it easier to write daemons.  It is Uncommitted.
>> Shouldn't there be a definition of each of the Uncommitted
>> interfaces exposed?  Man pages would be nice, but perhaps
>> something else as often suggested for "sfw" objects.
>>
>> - jek3
>>
> 
> libdaemon does not have any man pages.
> 
> The only reason for delivering libdaemon is that it is used by avahi.
> 
> It is not intended to make libdaemon available for any other projects to 
> use.
> 
> Padraig