From f5dc9d701d617d41a00e15fa2f55b900f1aba43b Mon Sep 17 00:00:00 2001
From: Richard Frith-Macdonald <rfm@gnu.org>
Date: Sat, 23 Jul 2005 18:39:38 +0000
Subject: [PATCH] Documentation tweaks

git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/base/trunk@21523 72102866-910b-0410-8b05-ffd578937521
---
 ChangeLog    |  3 +++
 Tools/gdnc.1 | 20 ++++++++++++++++----
 Tools/gdnc.m | 28 +++++++++++++++-------------
 3 files changed, 34 insertions(+), 17 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index b11291a21..9294a88ce 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -8,6 +8,9 @@
 	mingw ifdefs
 	* Tools/AGSHtml.h: Added defines for building without the gnustep
 	base library.
+	* Tools/gdnc.m: Fix minor documentation error.
+	* Tools/gdnc.1: Fix minor documentation error and add documentation
+	of flags to set public/network servers running.
 
 2005-07-22  Richard Frith-Macdonald <rfm@gnu.org>
 
diff --git a/Tools/gdnc.1 b/Tools/gdnc.1
index 9c9e88eab..82367a95e 100644
--- a/Tools/gdnc.1
+++ b/Tools/gdnc.1
@@ -16,7 +16,9 @@ gdnc \- GNUstep Distributed Notification Center
 .P
 .SH DESCRIPTION
 The gdnc daemon is used by GNUstep programs to send notifications and 
-messages to one another.
+messages to one another.  By default it uses private inter-process
+communications accessible only to the curtrent user on the machine on
+which it is running (where the operating system supports them).
 .P
 Every user needs to have his own instance of
 .B gdnc
@@ -26,7 +28,8 @@ will be started automatically as soon as it is needed,
 it is recommended to start
 .B gdnc
 in a personal login script like ~/.bashrc or ~/.cshrc.
-Alternatively you can launch gpbs when your windowing system or the
+Alternatively (if you have no command-line tools which use distributed
+notifications) you can launch gdnc when your windowing system or the
 window manager is started. For example, on systems with X11 you can launch
 .B gdnc
 from your .xinitrc script or alternatively
@@ -39,12 +42,21 @@ for a sample startup script.
 To attach
 .B gdnc
 to a remote session use the
-.IP "\fB-NXHost \fIhostname" 
+.IP "\fB-NSHost \fIhostname" 
 argument.
 .P
+To run a copy of the server to handle public notifications (available to all
+users on the local machine)
+.IP "\fB-GSPublic YES"
+.P
+To run a copy of the server to handle network-public notifications (available
+to all users able to connect to the local machine on the network)
+.IP "\fB-GSNetwork YES"
+.P
 .SH DIAGNOSTICS
 .B gdomap -L GDNCServer
-will lookup instances of gdnc.
+will lookup instances of gdnc which were launched with the NSHost, GSPublic,
+or GSNetwork command line arguments.
 .P
 Alternatively, 
 .B gdomap -N
diff --git a/Tools/gdnc.m b/Tools/gdnc.m
index 903032927..52ff6bd28 100644
--- a/Tools/gdnc.m
+++ b/Tools/gdnc.m
@@ -1004,21 +1004,23 @@ ihandler(int sig)
 @end
 
 
-/** <p>The  gdnc  daemon is used by GNUstep programs to send notifications and
-       messages to one another, in conjunction with the Base library
-       Notification-related classes.</p>
+/**
+  <p>The  gdnc  daemon is used by GNUstep programs to send notifications and
+     messages to one another, in conjunction with the Base library
+     Notification-related classes.</p>
 
-    <p>Every user needs to have his own instance of gdnc running.  While  gdnc
-       will be started automatically as soon as it is needed, it is recommended
-       to start gdnc in a personal login script like  ~/.bashrc  or  ~/.cshrc.
-       Alternatively  you  can  launch  gpbs when your windowing system or the
-       window manager is started. For example, on systems  with  X11  you  can
-       launch  gdnc  from  your  .xinitrc script or alternatively - if you are
-       running Window Maker - put it in Window Maker's autostart script.   See
-       the GNUstep Build Guide for a sample startup script.</p>
+  <p>Every user needs to have his own instance of gdnc running.  While  gdnc
+     will be started automatically as soon as it is needed, it is recommended
+     to start gdnc in a personal login script like  ~/.bashrc  or  ~/.cshrc.
+     Alternatively (if you have no command-line tools which use distributed
+     notifications) you  can  launch gdnc when your windowing system or the
+     window manager is started. For example, on systems  with  X11  you  can
+     launch  gdnc  from  your  .xinitrc script or alternatively - if you are
+     running Window Maker - put it in Window Maker's autostart script.   See
+     the GNUstep Build Guide for a sample startup script.</p>
 
-     <p>Please see the man page for more information.
-</p> */
+  <p>Please see the man page for more information.</p>
+ */
 int
 main(int argc, char** argv, char** env)
 {