Server issues

[Loye Young]

> About documentation, i think that every avahi tools has a manpage
> sebest at delly2:~$ man avahi-
> avahi-autoipd         avahi-autoipd.action  avahi-daemon
> avahi-daemon.conf

<code>
loyeyoung at homer :~$ man avahi
No manual entry for avahi
loyeyoung at homer:~$ man avahi-daemon  # This does have a man page, but it
doesn't explain much to someone who doesn't already know
loyeyoung at homer:~$ man avahi-autoipd
No manual entry for avahi-autoipd
loyeyoung at homer:~$ man avahi-autoipd.action
No manual entry for avahi-autoipd.action
loyeyoung at homer:~$ man avahi-daemon.conf # This does have a man page, but it
doesn't explain much to someone who doesn't already know
</code>

> About not starting avahi-daemon: (this is ubuntu/debian specific)
<snip details>
(1) Your comments are helpful and should be easily accessible in the
documentation.
(2) AVAHI_DAEMON_START=0 should be default, IMHO. Better yet, avahi
shouldn't be on the system at all unless specifically installed. At most, it
should be a "Suggested" dependency.
(3) Still doesn't explain how to get avahi off the machine and leave it in a
usable and upgradeable state.

> So what is the missing documentation in avahi?
(1) See above.
(2) How it interacts with and overrides (some would argue "hijacks") the
normal Debian networking system of ifupdown, /etc/network/interfaces, etc.
(3) What the jargon in the documentation means. E.g., the following line
from the avahi-daemon manpage is unintelligible to someone who doesn't
already know the avahi system:
       " The  daemon  registers local  IP addresses and static services
using mDNS/DNS-SD and provides
       two IPC APIs for local programs to make use of the mDNS  record
cache the  avahi-daemon maintains. "
Whoever wrote this must have an affinity for tax regulations under the U.S.
Internal Revenue Code. ;-)

-- 
Loye Young
Isaac & Young Computer Company
Laredo, Texas
(956) 857-1172
loye.young at iycc.net
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.ubuntu.com/archives/ubuntu-server/attachments/20071120/43ffa563/attachment.html>