From a3224b8dd7b8e4309ef599cf11c8fcaefa412bf5 Mon Sep 17 00:00:00 2001
From: Scott Rifenbark <scott.m.rifenbark@intel.com>
Date: Thu, 9 Jan 2014 10:03:09 -0600
Subject: [PATCH] dev-manual: Edits to "Enabling System Services" section.

Applied review comments from Paul Eggleton to the section that is
part of the "Writing a New Recipe" section.  I changed the title
of the section and applied some rewordings to better reprepresent
exactly what sysvinit and systemd really are (managers).

(From yocto-docs rev: 95c3ed5b7d1ace08828baacc8401e1ea5d96a06e)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
---
 .../dev-manual/dev-manual-common-tasks.xml    | 44 ++++++++++---------
 1 file changed, 24 insertions(+), 20 deletions(-)

diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 585f4ad4da..169a9169c0 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -2029,8 +2029,8 @@
             </note>
         </section>
 
-        <section id='new-recipe-optionally-supporting-services'>
-            <title>Supporting Services</title>
+        <section id='new-recipe-enabling-system-services'>
+            <title>Enabling System Services</title>
 
             <para>
                 If you want to install a service, which is a process that
@@ -2061,9 +2061,10 @@
                 Here are some examples:
                 <itemizedlist>
                     <listitem><para><emphasis>SysVinit:</emphasis>
-                        The SysVinit service is a group of processes that
-                        control the very basic functions of your system.
-                        SysVinit includes the init program, the first program
+                        SysVinit is a system and service manager that
+                        manages the init system used to control the very basic
+                        functions of your system.
+                        The init program is the first program
                         started by the Linux kernel when the system boots.
                         Init then controls the startup, running and shutdown
                         of all other programs.</para>
@@ -2080,25 +2081,21 @@
                         <ulink url='&YOCTO_DOCS_REF_URL;#var-INITSCRIPT_PARAMS'><filename>INITSCRIPT_PARAMS</filename></ulink>
                         variables within your recipe.</para></listitem>
                     <listitem><para><emphasis>Systemd:</emphasis>
-                        The Systemd service is a system management daemon
-                        designed for the Linux startup process.
-                        Systemd is the first process to execute and is
-                        therefore the parent process of all child processes.
+                        Systemd was designed to replace SysVinit and provide
+                        enhanced management of services.
+                        For more information on Systemd, see the Systemd
+                        homepage at
+                        <ulink url='http://freedesktop.org/wiki/Software/systemd/'></ulink>.
                         </para>
                         <para>To include this service, your recipe needs to
-                        inherit the
-                        <ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-systemd'><filename>systemd</filename></ulink>
-                        class.
-                        See the class for more information.</para></listitem>
+                        inherit the <filename>systemd</filename> class.
+                        See the
+                        <ulink url='&YOCTO_GIT_URL;/cgit/cgit.cgi/poky/tree/meta/classes/systemd.bbclass'><filename>systemd.bbclass</filename></ulink>
+                        file or the
+                        "<ulink url='&YOCTO_DOCS_REF_URL;#ref-classes-systemd'><filename>systemd.bbclass</filename></ulink>"
+                        section for more information.</para></listitem>
                 </itemizedlist>
             </para>
-
-            <para>
-                For an example showing how to install a post-installation
-                script, see the
-                "<link linkend='usingpoky-extend-addpkg-postinstalls'>Post-Installation Scripts</link>"
-                section.
-            </para>
         </section>
 
         <section id='new-recipe-packaging'>
@@ -2135,6 +2132,13 @@
                 section for an example that shows how you might split
                 your software into more than one package.
             </para>
+
+            <para>
+                For an example showing how to install a post-installation
+                script, see the
+                "<link linkend='usingpoky-extend-addpkg-postinstalls'>Post-Installation Scripts</link>"
+                section.
+            </para>
         </section>
 
         <section id='new-recipe-testing'>