02/03: doc: Give example uses of 'deco'.

[Ludovic Courtès]

civodul pushed a commit to branch master
in repository guix.

commit d8b94dbd76101f9090d2ffc60125dbcca6ff029b
Author: Ludovic Courtès <address@hidden>
Date:   Sun Dec 7 22:55:06 2014 +0100

    doc: Give example uses of 'deco'.
    
    Suggested by Sleep_Walker on #guix.
    
    * doc/guix.texi (Services): Add 'deco' examples.
---
 doc/guix.texi |   37 ++++++++++++++++++++++++++++++++++---
 1 files changed, 34 insertions(+), 3 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index 1d4a012..22f2484 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -4078,11 +4078,42 @@ An important part of preparing an 
@code{operating-system} declaration is
 listing @dfn{system services} and their configuration (@pxref{Using the
 Configuration System}).  System services are typically daemons launched
 when the system boots, or other actions needed at that time---e.g.,
-configuring network access.  They are managed by address@hidden
-(@pxref{Introduction,,, dmd, GNU dmd Manual}).
+configuring network access.
+
+Services are managed by address@hidden (@pxref{Introduction,,, dmd, GNU
+dmd Manual}).  On a running system, the @command{deco} command allows
+you to list the available services, show their status, start and stop
+them, or do other specific operations (@pxref{Jump Start,,, dmd, GNU dmd
+Manual}).  For example:
+
address@hidden
+# deco status dmd
address@hidden example
+
+The above command, run as @code{root}, lists the currently defined
+services.  The @command{deco doc} command shows a synopsis of the given
+service:
+
address@hidden
+# deco doc nscd
+Run libc's name service cache daemon (nscd).
address@hidden example
+
+The @command{start}, @command{stop}, and @command{restart} sub-commands
+have the effect you would expect.  For instance, the commands below stop
+the nscd service and restart the Xorg display server:
+
address@hidden
+# deco stop nscd
+Service nscd has been stopped.
+# deco restart xorg-server
+Service xorg-server has been stopped.
+Service xorg-server has been started.
address@hidden example
 
 The following sections document the available services, starting with
-the core services.
+the core services, that may be used in an @code{operating-system}
+declaration.
 
 @menu
 * Base Services::               Essential system services.