lots of documentation cleanups and fixes

git-svn-id: file:///home/lennart/svn/public/avahi/trunk@1309 941a03a8-eaeb-0310-b9a0-b1bbd8fe43fe

diff --git a/man/avahi-bookmarks.1.xml.in b/man/avahi-bookmarks.1.xml.in
index 25661f680c9a1f4cf4be6b9bd52daca21afd51c5..9bebd76483865e1c6938278ef3d0e702fd24771f 100644 (file)
--- a/man/avahi-bookmarks.1.xml.in
+++ b/man/avahi-bookmarks.1.xml.in
@@ -83,7 +83,7 @@
     </options>
 
        <section name="Authors">
-         <p>The avahi developers &lt;@PACKAGE_BUGREPORT@&gt;; avahi is
+         <p>The Avahi Developers &lt;@PACKAGE_BUGREPORT@&gt;; Avahi is
          available from <url href="@PACKAGE_URL@"/></p>
        </section>
        

diff --git a/man/avahi-browse.1.xml.in b/man/avahi-browse.1.xml.in
index 306152d0a932dedd7a29cbee2db30d154e7e75b8..07b75579f7d83eb7e0b922dc9db6df48b8965fb4 100644 (file)
--- a/man/avahi-browse.1.xml.in
+++ b/man/avahi-browse.1.xml.in
@@ -108,7 +108,7 @@
        </options>
        
        <section name="Authors">
-         <p>The avahi developers &lt;@PACKAGE_BUGREPORT@&gt;; avahi is
+         <p>The Avahi Developers &lt;@PACKAGE_BUGREPORT@&gt;; Avahi is
          available from <url href="@PACKAGE_URL@"/></p>
        </section>
        

diff --git a/man/avahi-daemon.8.xml.in b/man/avahi-daemon.8.xml.in
index b4ad07db7a0dbcc857b1a1efe373b9c7acd05873..e9732d61916789a45033afa38b8a6b398fe69c66 100644 (file)
--- a/man/avahi-daemon.8.xml.in
+++ b/man/avahi-daemon.8.xml.in
@@ -42,8 +42,8 @@
       exclusively by avahi-dnsconfd (a daemon which configures unicast
       DNS servers using server info published via mDNS) and nss-mdns
       (a libc NSS plugin, providing name resolution via mDNS). Finally
-      there is the DBUS interface which provides a rich object
-      oriented interface to DBUS enabled applications.</p>
+      there is the D-Bus interface which provides a rich object
+      oriented interface to D-Bus enabled applications.</p>
       
       <p>Upon startup avahi-daemon interprets its configuration file
       <file>@pkgsysconfdir@/avahi-daemon.conf</file> and reads XML
@@ -63,17 +63,17 @@
 
          <option>
                <p><opt>-D | --daemonize</opt></p>
-               <optdesc><p>Daemonize after startup. Implies <opt>--syslog</opt></p></optdesc>
+               <optdesc><p>Daemonize after startup. Implies <opt>--syslog</opt>.</p></optdesc>
          </option>
 
       <option>
         <p><opt>-s | --syslog</opt></p>
-        <optdesc><p>Log to syslog instead of STDERR. Implied by <opt>--daemonize</opt></p></optdesc>
+        <optdesc><p>Log to syslog instead of STDERR. Implied by <opt>--daemonize</opt>.</p></optdesc>
       </option>
 
       <option>
         <p><opt>--debug</opt></p>
-        <optdesc><p>Increase verbosity to debug level</p></optdesc>
+        <optdesc><p>Increase verbosity to debug level.</p></optdesc>
       </option>
 
       <option>
@@ -92,10 +92,10 @@
       </option>
 
       <option>
-        <p><opt>--no-proctitle</opt></p>
+        <p><opt>--no-proc-title</opt></p>
         <optdesc><p>Don't change the process name while
-        running. Unless this option is specified avahi will reflect
-        it's current state and selected host name in the process
+        running. Unless this option is specified avahi-daemon will reflect
+        it's current state and the selected host name in the process
         title.</p></optdesc>
       </option>
 
@@ -144,15 +144,15 @@
     </section>
 
     <section name="Signals">
-      <p><arg>SIGINT, SIGTERM, SIGQUIT</arg>: avahi-daemon will shutdown. This is issued by passing --kill to avahi-daemon.</p>
+      <p><arg>SIGINT, SIGTERM, SIGQUIT</arg>: avahi-daemon will shutdown. (Same as <opt>--kill</opt>).</p>
       <p><arg>SIGHUP</arg>: avahi-daemon will reload unicast DNS
       server data from <file>/etc/resolv.conf</file> and static
-      service definitions from <file>@servicedir@/</file>.</p>
+      service definitions from <file>@servicedir@/</file>. (Same as <opt>--reload</opt>)</p>
       <p><arg>SIGUSR1</arg>: avahi-daemon will dump local and remote cached resource record data to syslog.</p>
     </section>
 
        <section name="Authors">
-         <p>The avahi developers &lt;@PACKAGE_BUGREPORT@&gt;; avahi is
+         <p>The Avahi Developers &lt;@PACKAGE_BUGREPORT@&gt;; Avahi is
          available from <url href="@PACKAGE_URL@"/></p>
        </section>
        

diff --git a/man/avahi-daemon.conf.5.xml.in b/man/avahi-daemon.conf.5.xml.in
index 7dff0974c1d957f919fd2045190a7b4ddc25fa75..bfbd0e52b3364e9f84289f99443d426799152eba 100644 (file)
--- a/man/avahi-daemon.conf.5.xml.in
+++ b/man/avahi-daemon.conf.5.xml.in
@@ -96,12 +96,12 @@
 
       <option>
         <p><opt>enable-dbus=</opt> Takes either "yes", "no" or
-        "warn". If set to "yes" avahi-daemon connects to D-BUS,
+        "warn". If set to "yes" avahi-daemon connects to D-Bus,
         offering an object oriented client API. It is only available
         if Avahi has been compiled with <opt>--enable-dbus</opt> in
         which case it defaults to "yes". "warn" behaves like "yes",
         but the daemon starts up even when it fails to connect to a
-        D-BUS daemon. In addition, if the connection to the D-BUS
+        D-Bus daemon. In addition, if the connection to the D-Bus
         daemon is terminated we try to reconnect. (Unless we are in a
         chroot() environment where this definitely will fail.) </p>
       </option>
@@ -281,13 +281,13 @@
       </option>
 
       <option>
-        <p><opt>rlimit-nproc=</opt> Value for RLIMIT_NPROC (number of process of user). Since only a single avahi-daemon process is usually running you can set this safely to 1.</p>
+        <p><opt>rlimit-nproc=</opt> Value for RLIMIT_NPROC (number of process of user). avahi-daemon forks of a helper process on systems where <manref name="chroot" section="2"/> is available. Therefore this value should not be set below 2.</p>
       </option>
 
     </section>
 
        <section name="Authors">
-         <p>The avahi developers &lt;@PACKAGE_BUGREPORT@&gt;; avahi is
+         <p>The Avahi Developers &lt;@PACKAGE_BUGREPORT@&gt;; Avahi is
          available from <url href="@PACKAGE_URL@"/></p>
        </section>
        

diff --git a/man/avahi-discover.1.xml.in b/man/avahi-discover.1.xml.in
index 43574f629ada0e3d2c02942f9fc319b580672ff1..5d4f8787da618f2feedb1689008067c468c491dc 100644 (file)
--- a/man/avahi-discover.1.xml.in
+++ b/man/avahi-discover.1.xml.in
@@ -43,7 +43,7 @@
     </options>
        
        <section name="Authors">
-         <p>The avahi developers &lt;@PACKAGE_BUGREPORT@&gt;; avahi is
+         <p>The Avahi Developers &lt;@PACKAGE_BUGREPORT@&gt;; Avahi is
          available from <url href="@PACKAGE_URL@"/></p>
        </section>
        

diff --git a/man/avahi-dnsconfd.8.xml.in b/man/avahi-dnsconfd.8.xml.in
index 14a9f4ae2a04d73d3a5cc2a03dfa01e329422f7f..454afac8f6970afa8e783c46f5b65ae471901168 100644 (file)
--- a/man/avahi-dnsconfd.8.xml.in
+++ b/man/avahi-dnsconfd.8.xml.in
@@ -76,7 +76,7 @@
 
     <section name="Files">
       
-      <p><file>@pkgsysconfdir@/dnsconfd.action</file>: the script to run when a DNS server is found or removed.</p>
+      <p><file>@pkgsysconfdir@/avahi-dnsconfd.action</file>: the script to run when a DNS server is found or removed.</p>
     
     </section>
 
@@ -86,7 +86,7 @@
     </section>
 
        <section name="Authors">
-         <p>The avahi developers &lt;@PACKAGE_BUGREPORT@&gt;; avahi is
+         <p>The Avahi Developers &lt;@PACKAGE_BUGREPORT@&gt;; Avahi is
          available from <url href="@PACKAGE_URL@"/></p>
        </section>
        

diff --git a/man/avahi-dnsconfd.action.8.xml.in b/man/avahi-dnsconfd.action.8.xml.in
index da8b2651f0cda806a614904617c780ed2c19cf62..68114226945e148aae87fdcb64b926d71d95bb6f 100644 (file)
--- a/man/avahi-dnsconfd.action.8.xml.in
+++ b/man/avahi-dnsconfd.action.8.xml.in
@@ -74,7 +74,7 @@
     </section>  
 
        <section name="Authors">
-         <p>The avahi developers &lt;@PACKAGE_BUGREPORT@&gt;; avahi is
+         <p>The Avahi Developers &lt;@PACKAGE_BUGREPORT@&gt;; Avahi is
          available from <url href="@PACKAGE_URL@"/></p>
        </section>
        

diff --git a/man/avahi-publish.1.xml.in b/man/avahi-publish.1.xml.in
index cab5828d834ee5afd84598bcce622a440109742f..c68f60deddb8ce339c71549f0b0cd85fe574a51c 100644 (file)
--- a/man/avahi-publish.1.xml.in
+++ b/man/avahi-publish.1.xml.in
@@ -104,7 +104,7 @@
        </options>
        
        <section name="Authors">
-         <p>The avahi developers &lt;@PACKAGE_BUGREPORT@&gt;; avahi is
+         <p>The Avahi Developers &lt;@PACKAGE_BUGREPORT@&gt;; Avahi is
          available from <url href="@PACKAGE_URL@"/></p>
        </section>
        

diff --git a/man/avahi-resolve.1.xml.in b/man/avahi-resolve.1.xml.in
index f3691b99367138a2fbf084d967a7c21e5876dfd2..dbfccc030d82b4ae95abb3161cecafd1bf3f15f8 100644 (file)
--- a/man/avahi-resolve.1.xml.in
+++ b/man/avahi-resolve.1.xml.in
@@ -87,7 +87,7 @@
        </options>
 
        <section name="Authors">
-         <p>The avahi developers &lt;@PACKAGE_BUGREPORT@&gt;; avahi is
+         <p>The Avahi Developers &lt;@PACKAGE_BUGREPORT@&gt;; Avahi is
          available from <url href="@PACKAGE_URL@"/></p>
        </section>
        

diff --git a/man/avahi-set-host-name.1.xml.in b/man/avahi-set-host-name.1.xml.in
index b2eb7f43432c7f85aa59d2103632085b8143d78f..983b81c744afe0b3966374368f6f50f614cf205e 100644 (file)
--- a/man/avahi-set-host-name.1.xml.in
+++ b/man/avahi-set-host-name.1.xml.in
@@ -57,7 +57,7 @@
        </options>
 
        <section name="Authors">
-         <p>The avahi developers &lt;@PACKAGE_BUGREPORT@&gt;; avahi is
+         <p>The Avahi Developers &lt;@PACKAGE_BUGREPORT@&gt;; Avahi is
          available from <url href="@PACKAGE_URL@"/></p>
        </section>
        

diff --git a/man/avahi.hosts.5.xml.in b/man/avahi.hosts.5.xml.in
index 5fe227124315b28f8b84b7f877497c5c18684fdd..5a925475e91e12c0b2723a9d123ac22647492b7e 100644 (file)
--- a/man/avahi.hosts.5.xml.in
+++ b/man/avahi.hosts.5.xml.in
@@ -43,7 +43,7 @@
     </description>
 
        <section name="Authors">
-         <p>The avahi developers &lt;@PACKAGE_BUGREPORT@&gt;; avahi is
+         <p>The Avahi Developers &lt;@PACKAGE_BUGREPORT@&gt;; Avahi is
          available from <url href="@PACKAGE_URL@"/></p>
        </section>
        

diff --git a/man/avahi.service.5.xml.in b/man/avahi.service.5.xml.in
index 2514f33e345db265f05f2f042fd3087aa95ce62b..aeaeb058a1ea8888403f4996e94816487ac3a816 100644 (file)
--- a/man/avahi.service.5.xml.in
+++ b/man/avahi.service.5.xml.in
@@ -105,7 +105,7 @@
        </section>
 
        <section name="Authors">
-         <p>The avahi developers &lt;@PACKAGE_BUGREPORT@&gt;; avahi is
+         <p>The Avahi Developers &lt;@PACKAGE_BUGREPORT@&gt;; Avahi is
          available from <url href="@PACKAGE_URL@"/></p>
        </section>