1 files changed, 9 insertions, 4 deletions

diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml
index 21f125b6ad..0d64f84cfb 100644
--- a/documentation/ref-manual/ref-classes.xml
+++ b/documentation/ref-manual/ref-classes.xml
@@ -2751,13 +2751,18 @@
 </section>
 
 <section id='ref-classes-update-rc.d'>
-    <title>Initscripts - <filename>update-rc.d.bbclass</filename></title>
+    <title><filename>update-rc.d.bbclass</filename></title>
 
     <para>
-        This class uses <filename>update-rc.d</filename> to safely install an
+        The <filename>update-rc.d</filename> class uses
+        <filename>update-rc.d</filename> to safely install an
         initialization script on behalf of the package.
-        The OpenEmbedded build system takes care of details such as making sure the script is stopped before
-        a package is removed and started when the package is installed.
+        The OpenEmbedded build system takes care of details such as making
+        sure the script is stopped before a package is removed and started when
+        the package is installed.
+    </para>
+
+    <para>
         Three variables control this class:
         <filename><link linkend='var-INITSCRIPT_PACKAGES'>INITSCRIPT_PACKAGES</link></filename>,
         <filename><link linkend='var-INITSCRIPT_NAME'>INITSCRIPT_NAME</link></filename> and