diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml
index 17784c2628..21f125b6ad 100644
--- a/documentation/ref-manual/ref-classes.xml
+++ b/documentation/ref-manual/ref-classes.xml
@@ -2705,17 +2705,17 @@
 </section>
 
 <section id='ref-classes-update-alternatives'>
-    <title>Alternatives - <filename>update-alternatives.bbclass</filename></title>
+    <title><filename>update-alternatives.bbclass</filename></title>
 
     <para>
-        This class helps the alternatives system when multiple sources provide
-        the same command.
+        The <filename>update-alternatives</filename> class helps the
+        alternatives system when multiple sources provide the same command.
         This situation occurs when several programs that have the same or
         similar function are installed with the same name.
         For example, the <filename>ar</filename> command is available from the
         <filename>busybox</filename>, <filename>binutils</filename> and
         <filename>elfutils</filename> packages.
-        The <filename>update-alternatives.bbclass</filename> class handles
+        The <filename>update-alternatives</filename> class handles
         renaming the binaries so that multiple packages can be installed
         without conflicts.
         The <filename>ar</filename> command still works regardless of which
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 7ece12cc2c..4a0e4d1047 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -89,7 +89,7 @@
      ALTERNATIVE_busybox = "sh sed test bracket"
                     </literallayout>
                     For more information on the alternatives system, see the
-                    "<link linkend='ref-classes-update-alternatives'>Alternatives - <filename>update-alternatives.bbclass</filename></link>"
+                    "<link linkend='ref-classes-update-alternatives'><filename>update-alternatives.bbclass</filename></link>"
                     section.
                 </para>
             </glossdef>
@@ -122,7 +122,7 @@
 
                 <para>
                     For more information on the alternatives system, see the
-                    "<link linkend='ref-classes-update-alternatives'>Alternatives - <filename>update-alternatives.bbclass</filename></link>"
+                    "<link linkend='ref-classes-update-alternatives'><filename>update-alternatives.bbclass</filename></link>"
                     section.
                 </para>
             </glossdef>
@@ -147,7 +147,7 @@
 
                 <para>
                     For more information on the alternatives system, see the
-                    "<link linkend='ref-classes-update-alternatives'>Alternatives - <filename>update-alternatives.bbclass</filename></link>"
+                    "<link linkend='ref-classes-update-alternatives'><filename>update-alternatives.bbclass</filename></link>"
                     section.
                 </para>
             </glossdef>
@@ -197,7 +197,7 @@
 
                 <para>
                     For more information on the alternatives system, see the
-                    "<link linkend='ref-classes-update-alternatives'>Alternatives - <filename>update-alternatives.bbclass</filename></link>"
+                    "<link linkend='ref-classes-update-alternatives'><filename>update-alternatives.bbclass</filename></link>"
                     section.
                 </para>
             </glossdef>