diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 9bfad5ce24..97079e5aed 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -3816,32 +3816,30 @@
             However, on rare occasions where you might want to use a
             layer but exclude parts that are causing problems, such
             as introducing a different version of a recipe, you can
-            use <filename>BBMASK</filename> to exclude the recipe.
+            use 
+            <ulink url='&YOCTO_DOCS_REF_URL;#var-BBMASK'><filename>BBMASK</filename></ulink>
+            to exclude the recipe.
         </para>
 
         <para>
             It is possible to filter or mask out <filename>.bb</filename> and
             <filename>.bbappend</filename> files.
             You can do this by providing an expression with the
-            <ulink url='&YOCTO_DOCS_REF_URL;#var-BBMASK'><filename>BBMASK</filename></ulink>
-            variable.
+            <filename>BBMASK</filename> variable.
             Here is an example:
             <literallayout class='monospaced'>
      BBMASK = "/meta-mymachine/recipes-maybe/"
             </literallayout>
             Here, all <filename>.bb</filename> and
-            <filename>.bbappend</filename> files in the directory that matches
+            <filename>.bbappend</filename> files in the directory that match
             the expression are ignored during the build process.
-            See the glossary entry for the
-            <ulink url='&YOCTO_DOCS_REF_URL;#var-BBMASK'><filename>BBMASK</filename></ulink>
-            variable for more information.
         </para>
 
         <note>
-            The value you provide is passed to python's regular expression
+            The value you provide is passed to Python's regular expression
             compiler.
             The expression is compared against the full paths to the files.
-            For complete syntax information, see python's documentation at
+            For complete syntax information, see Python's documentation at
             <ulink url='http://docs.python.org/release/2.3/lib/re-syntax.html'></ulink>.
         </note>
     </section>