1 files changed, 8 insertions, 6 deletions

diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml
index 0d64f84cfb..eaab17258d 100644
--- a/documentation/ref-manual/ref-classes.xml
+++ b/documentation/ref-manual/ref-classes.xml
@@ -2772,18 +2772,20 @@
 </section>
 
 <section id='ref-classes-useradd'>
-    <title>Adding Users - <filename>useradd.bbclass</filename></title>
+    <title><filename>useradd.bbclass</filename></title>
 
     <para>
-        If you have packages that install files that are owned by custom users or groups,
-        you can use this class to specify those packages and associate the users and groups
-        with those packages.
+        The <filename>useradd</filename> class supports recipes that restrict
+        packages to certain users or groups.
+        For example, if you have packages that install files that are owned
+        by custom users or groups, you can use this class to specify
+        those packages and then associate them with the users and groups.
         The <filename>meta-skeleton/recipes-skeleton/useradd/useradd-example.bb</filename>
         recipe in the <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>
         provides a simple example that shows how to add three
         users and groups to two packages.
-        See the <filename>useradd-example.bb</filename> for more information on how to
-        use this class.
+        See the <filename>useradd-example.bb</filename> recipe for more
+        information on how to use this class.
     </para>
 </section>