[shepherd] 31/32: doc: Clarify which instance 'herd' talks to.

[Ludovic Courtès]

civodul pushed a commit to branch master
in repository shepherd.

commit 09e1b6b8869527bc0650331049edf77caa5a5d66
Author: Ludovic Courtès <ludo@gnu.org>
AuthorDate: Wed Mar 30 14:11:09 2022 +0200

    doc: Clarify which instance 'herd' talks to.
    
    * doc/shepherd.texi (Invoking herd): Clarify which instance 'herd' talks to.
---
 doc/shepherd.texi | 21 +++++++++++++++++++--
 1 file changed, 19 insertions(+), 2 deletions(-)

diff --git a/doc/shepherd.texi b/doc/shepherd.texi
index 4867ceb..849909f 100644
--- a/doc/shepherd.texi
+++ b/doc/shepherd.texi
@@ -474,8 +474,25 @@ Synonym for @code{--silent}.
 
 @cindex herd
 The @command{herd} command is a generic client program to control a
-running instance of @command{shepherd} (@pxref{Invoking shepherd}).  It has the
-following synopsis:
+running instance of @command{shepherd} (@pxref{Invoking shepherd}).
+When running as root, it communicates with the @dfn{system
+instance}---the process with PID@tie{}1; when running as a normal user,
+it communicates with the @dfn{user's instance}, which is a regular,
+unprivileged process managing the user's own services.  For example, the
+following command displays the status of all the @dfn{system services}:
+
+@example
+sudo herd status
+@end example
+
+Conversely, the command below displays the status of @dfn{user
+services}, assuming a user @command{shepherd} is running:
+
+@example
+herd status
+@end example
+
+The command has the following synopsis:
 
 @example
 herd [@var{option}@dots{}] @var{action} [@var{service} [@var{arg}@dots{}]]