major rewrite of ARM service and a bit of the ARM IPC to take advantage of the simplifications possible now that we no longer intercept traffic; the new code in particular is better at communicating what exactly ARM was doing in response to requests. A major change is that gnunet-arm -i/-k now only impacts if a service is running by-default, on-demand starting is no longer impacted, option -t from gnunet-arm was removed

1 files changed, 6 insertions, 10 deletions

diff --git a/doc/man/gnunet-arm.1 b/doc/man/gnunet-arm.1
index 30e0082ef..e8b7c7a61 100644
--- a/doc/man/gnunet-arm.1
+++ b/doc/man/gnunet-arm.1
@@ -9,7 +9,7 @@ gnunet\-arm \- control GNUnet services
 .br
 
 .SH DESCRIPTION
-\fBgnunet\-arm\fP can be used to start or stop GNUnet services, including the ARM service itself.
+\fBgnunet\-arm\fP can be used to start or stop GNUnet services, including the ARM service itself.  The ARM service is a supervisor for GNUnet's service processes.  ARM starts services on-demand or as configured and re-starts them if they crash.  
 
 .SH OPTIONS
 
@@ -19,7 +19,7 @@ Use the configuration file FILENAME.
 
 .TP
 .IP "\-e, \-\-end"
-Shutdown all GNUnet services (including ARM).
+Shutdown all GNUnet services (including ARM itself).  Running "gnunet-arm -e" is the usual way to shutdown a GNUnet peer.
 
 .TP
 .IP "\-h, \-\-help"
@@ -31,19 +31,15 @@ Use LOGLEVEL for logging.  Valid values are DEBUG, INFO, WARNING and ERROR.
 
 .TP
 .IP "\-i SERVICE,  \-\-init=SERVICE"
-Starts the specified SERVICE if it is not already running.
+Starts the specified SERVICE if it is not already running.  More specifically, this makes the service behave as if it were in the default services list.
 
 .TP
 .IP "\-k SERVICE,  \-\-kill=SERVICE"
-Stop the specified SERVICE if it is running.
+Stop the specified SERVICE if it is running.  While this will kill the service right now, the service may be restarted immediately if other services depend on it (service is then started 'on-demand').  If the service used to be a 'default' service, its default-service status will be revoked.  If the service was not a default service, it will just be (temporarily) stopped, but could be re-started on-demand at any time.
 
 .TP
 .IP "\-s, \-\-start"
-Start all GNUnet default services on this system (including ARM).
-
-.TP
-.IP "\-t SERVICE,  \-\-test=SERVICE"
-Report if the specified SERVICE is running.
+Start all GNUnet default services on this system (and also ARM).  Naturally, if a service is demanded by a default service, it will then also be started.  Running "gnunet-arm -s" is the usual way to start a GNUnet peer.
 
 .TP
 .IP "\-v, \-\-version"
@@ -51,7 +47,7 @@ Print GNUnet version number.
 
 
 .SH BUGS
-Report bugs by using Mantis <https://gnunet.org/mantis/> or by sending electronic mail to <gnunet\-developers@gnu.org>
+Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org>
 
 .SH SEE ALSO
 gnunet\-service\-arm(1)