[shepherd] 06/07: doc: Improve the introduction.

[Ludovic Courtès]

civodul pushed a commit to branch master
in repository shepherd.

commit 8cbf1a5c4b2a7d2ff8d767f020395235ca4ee4ae
Author: Ludovic Courtès <address@hidden>
Date:   Wed Jan 27 14:57:03 2016 +0100

    doc: Improve the introduction.
    
    * shepherd.texi (Introduction): Mention "GNU Daemon Shepherd"; reword a
    few things.
---
 shepherd.texi |   19 ++++++++++---------
 1 files changed, 10 insertions(+), 9 deletions(-)

diff --git a/shepherd.texi b/shepherd.texi
index 88acd33..5dc5f9c 100644
--- a/shepherd.texi
+++ b/shepherd.texi
@@ -51,8 +51,8 @@ Documentation License''.
 @node Top
 @top The GNU Shepherd Manual
 
-This manual documents the Shepherd version @value{VERSION}, a service
-manager for the GNU system.
+This manual documents the address@hidden version @value{VERSION}, a
+service manager for the GNU system.
 
 @menu
 * Introduction::      Introduction to the Shepherd service manager.
@@ -77,8 +77,8 @@ manager for the GNU system.
 @chapter Introduction
 
 @cindex service manager
-This manual documents the Shepherd service manager.  The Shepherd looks
-after system services, typically @dfn{daemons}.
+This manual documents the address@hidden Shepherd, or address@hidden
+for short.  The Shepherd looks after system services, typically @dfn{daemons}.
 It is used to start and stop them in a reliable
 fashion.  For instance it will dynamically determine and start any
 other services that our desired service depends upon.  As another
@@ -92,7 +92,7 @@ as @code{root}.  Normally the purpose of init systems is to 
manage all
 system-wide services, but the Shepherd can also be a useful tool assisting
 unprivileged users in the management of their own daemons.
 
-Unfortunately all flexible software requires some time to master and
+Flexible software requires some time to master and
 the Shepherd is no different.  But don't worry: this manual should allow you to
 get started quickly.  Its first chapter is designed as a practical
 introduction to the Shepherd and should be all you need for everyday use
@@ -110,10 +110,11 @@ Managing Daemons} (or @dfn{Daemons-Managing Daemon}?).
 @cindex Guile
 @cindex Scheme
 @cindex GOOPS
-This program is written in @dfn{Guile}, an implementation of the
-Scheme programming language, using the @dfn{GOOPS} extension for
-object-orientation.  Guile is also the Shepherd's configuration language
-(@pxref{Top,,, guile, GNU Guile Reference Manual}).  We have tried to
+This program is written in Guile, an implementation of the
+Scheme programming language, using the GOOPS extension for
+object-orientation.  Guile is also the Shepherd's configuration language.
address@hidden,,, guile, GNU Guile Reference Manual}, for an
+introduction to Guile.  We have tried to
 make the Shepherd's basic features as accessible as possible---you should be
 able to use these even if you do not know how to program in Scheme.  A
 basic grasp of Guile and GOOPS is required only if you wish to make