ref-manual, dev-manual: Applied review edits (read-only rootfs and package repo)

A couple sets of review comments from Paul applied here.

1. Added the "read-only-rootfs" item to the EXTRA_IMAGE_FEATURES
   variable description and a link to the appropriate section
   in the dev-manual.

2. Pulled the how-to-create a package repository section out
   of the section on how to customize an image with the
   IMAGE_FEATURES and EXTRA_IMAGE_FEATURES section and made
   it a stand-alone section in the "Tasks" chapter of the
   dev-manual.

3. Integrated the SSH server example into the main topic
   because we don't want an isolated sub-section within a
   main topic.

4. In the image features section of the ref-manual, I fixed
   the link with the "read-only-rootfs" feature to go to
   the now-isolated section on how to do that instead of
   going to the customizing an image using the IMAGE_FEATURES
   and EXTRA_IMAGE_FEATURES variables section.

(From yocto-docs rev: 9c79b5f40d8dc6b37fbe636a2459f89b70bd8ea8)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>

2 files changed, 32 insertions, 24 deletions

diff --git a/documentation/ref-manual/ref-features.xml b/documentation/ref-manual/ref-features.xml
index 97c645149c..7c43ab392f 100644
--- a/documentation/ref-manual/ref-features.xml
+++ b/documentation/ref-manual/ref-features.xml
@@ -184,10 +184,10 @@
                 <listitem><para><emphasis>doc-pkgs:</emphasis> Installs documentation packages for all packages
                     installed in a given image.</para></listitem>
                 <listitem><para><emphasis>nfs-server:</emphasis> Installs an NFS server.</para></listitem>
-                <listitem><para><emphasis>read-only-fsroot:</emphasis> Creates 
+                <listitem><para><emphasis>read-only-fsroot:</emphasis> Creates
                     an image whose root filesystem is read-only.
-                    See the 
-                    "<ulink url='&YOCTO_DOCS_DEV_URL;#usingpoky-extend-customimage-imagefeatures'>Customizing Images Using Custom <filename>IMAGE_FEATURES</filename> and <filename>EXTRA_IMAGE_FEATURES</filename></ulink>"
+                    See the
+                    "<ulink url='&YOCTO_DOCS_DEV_URL;#creating-a-read-only-root-filesystem'>Creating a Read-Only Root Filesystem</ulink>"
                     section in the Yocto Project Development Manual for more
                     information.</para></listitem>
                 <listitem><para><emphasis>splash:</emphasis> Enables showing a splash screen during boot.
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index b954fd036a..f81ab62ded 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -950,12 +950,12 @@ Core layer for images cannot be removed
                     The list of additional features to include in an image.
                     Typically, you configure this variable in an image recipe.
                     You can also configure it in the <filename>local.conf</filename>
-                    file found in the 
+                    file found in the
                     <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>.
                     <note>
                         Use the
                         <link linkend='var-IMAGE_FEATURES'><filename>IMAGE_FEATURES</filename></link>
-                        variable to define the primary list of features you want to 
+                        variable to define the primary list of features you want to
                         add to the image.
                     </note>
                 </para>
@@ -967,12 +967,21 @@ Core layer for images cannot be removed
              including symbol information for debugging and
              profiling.
 
+"debug-tweaks" - Makes an image suitable for development.
+                 For example, ssh root access has a blank
+                 password.  You should remove this feature
+                 before you produce a production image.
+
 "dev-pkgs" - Adds -dev packages for all installed packages.
              This is useful if you want to develop against
              the libraries in the image.
 
-"tools-sdk" - Adds development tools such as gcc, make,
-              pkgconfig and so forth.
+"read-only-rootfs" - Creates an image whose root
+                     filesystem is read-only. See the
+                     "<ulink url='&YOCTO_DOCS_DEV_URL;#creating-a-read-only-root-filesystem'>Creating a Read-Only Root Filesystem</ulink>"
+                     section in the Yocto Project
+                     Development Manual for more
+                     information
 
 "tools-debug" - Adds debugging tools such as gdb and
                 strace.
@@ -980,27 +989,26 @@ Core layer for images cannot be removed
 "tools-profile" - Adds profiling tools such as oprofile,
                   exmap, lttng and valgrind (x86 only).
 
+"tools-sdk" - Adds development tools such as gcc, make,
+              pkgconfig and so forth.
+
 "tools-testapps" - Adds useful testing tools such as
                    ts_print, aplay, arecord and so
                    forth.
 
-"debug-tweaks" - Makes an image suitable for development.
-                 For example, ssh root access has a blank
-                 password.  You should remove this feature
-                 before you produce a production image.
                     </literallayout>
                 </para>
 
                 <para>
-                    For a complete list of image features that ships with the 
-                    Yocto Project, see the 
-                    "<link linkend="ref-features-image">Images</link>" 
+                    For a complete list of image features that ships with the
+                    Yocto Project, see the
+                    "<link linkend="ref-features-image">Images</link>"
                     section.
                 </para>
 
                 <para>
-                    For some examples that show how to customize your image by 
-                    using this variable, see the 
+                    For some examples that show how to customize your image by
+                    using this variable, see the
                     "<ulink url='&YOCTO_DOCS_DEV_URL;#usingpoky-extend-customimage-imagefeatures'>Customizing Images Using Custom <filename>IMAGE_FEATURES</filename> and <filename>EXTRA_IMAGE_FEATURES</filename></ulink>"
                     section in the Yocto Project Development Manual.
                 </para>
@@ -1229,23 +1237,23 @@ Core layer for images cannot be removed
                 <para>
                     The list of features to include in an image.
                     Typically, you configure this variable in an image recipe.
-                    You can also configure it in the 
-                    <filename>local.conf</filename> file found in the 
+                    You can also configure it in the
+                    <filename>local.conf</filename> file found in the
                     <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink>.
                     <note>
-                        You can also add extra features to the image by using 
+                        You can also add extra features to the image by using
                         the
                         <filename><link linkend='var-EXTRA_IMAGE_FEATURES'>EXTRA_IMAGE_FEATURES</link></filename> variable.
                     </note>
-                    For a list of image features that ships with the Yocto 
-                    Project, see the 
-                    "<link linkend="ref-features-image">Images</link>" 
+                    For a list of image features that ships with the Yocto
+                    Project, see the
+                    "<link linkend="ref-features-image">Images</link>"
                     section.
                 </para>
 
                 <para>
-                    For some examples that show how to customize your image by 
-                    using this variable, see the 
+                    For some examples that show how to customize your image by
+                    using this variable, see the
                     "<ulink url='&YOCTO_DOCS_DEV_URL;#usingpoky-extend-customimage-imagefeatures'>Customizing Images Using Custom <filename>IMAGE_FEATURES</filename> and <filename>EXTRA_IMAGE_FEATURES</filename></ulink>"
                     section in the Yocto Project Development Manual.
                 </para>