1 files changed, 30 insertions, 23 deletions

diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml
index f942cc7319..7f51fc9885 100644
--- a/documentation/poky-ref-manual/ref-variables.xml
+++ b/documentation/poky-ref-manual/ref-variables.xml
@@ -74,8 +74,10 @@
 
         <glossentry id='var-BBFILE_COLLECTIONS'><glossterm>BBFILE_COLLECTIONS</glossterm>
             <glossdef>
-                <para>Lists the names of configured layers. These names are used to find the other BBFILE_*
-                    variables. Typically each layer will append its name to this variable in its
+                <para>Lists the names of configured layers. 
+                    These names are used to find the other <filename>BBFILE_*</filename>
+                    variables. 
+                    Typically, each layer will append its name to this variable in its
                     <filename>conf/layer.conf</filename> file.
                 </para>
             </glossdef>
@@ -105,14 +107,16 @@
                     lower precedence.</para>
                 <para>A larger value for the <filename>BBFILE_PRIORITY</filename> variable results in a higher
                     precedence. 
-                    For example, the value 6 has a higher precedence than the
-                    value 5. 
-                    If not specified, the BBFILE_PRIORITY variable is set based on layer
-                    dependencies (see LAYERDEPENDS below). Tdefault priority if unspecified
-                    for a layer with no dependencies is the lowest defined priority + 1
+                    For example, the value 6 has a higher precedence than the value 5. 
+                    If not specified, the <filename>BBFILE_PRIORITY</filename> variable is set based on layer
+                    dependencies (see the
+                    <filename><link linkend='var-LAYERDEPENDS'>LAYERDEPENDS</link></filename> variable for 
+                    more information.
+                    The default priority, if unspecified
+                    for a layer with no dependencies, is the lowest defined priority + 1
                     (or 1 if no priorities are defined).</para>
                 <tip>
-                    You can use the command "bitbake-layers show_layers" to list
+                    You can use the command <filename>bitbake-layers show_layers</filename> to list
                     all configured layers along with their priorities.
                 </tip>
             </glossdef>
@@ -552,14 +556,14 @@
         <glossentry id='var-LAYERDEPENDS'><glossterm>LAYERDEPENDS</glossterm>
             <glossdef>
                 <para>Lists the layers that this recipe depends upon, separated by spaces.
-                    Optionally a specific layer version may be specified for a dependency
-                    by adding it to the end of the layer name with a colon, e.g. "anotherlayer:3"
-                    (to be compared against LAYERVERSION_anotherlayer in this example).
+                    Optionally, you can specify a specific layer version for a dependency
+                    by adding it to the end of the layer name with a colon, (e.g. "anotherlayer:3"
+                    to be compared against <filename>LAYERVERSION_anotherlayer</filename> in this case).
                     An error will be produced if any dependency is missing or
                     the version numbers do not match exactly (if specified).
                     This variable is used in the <filename>conf/layer.conf</filename> file 
                     and must be suffixed with the name of the specific layer (e.g. 
-                    LAYERDEPENDS_mylayer).</para>
+                    <filename>LAYERDEPENDS_mylayer</filename>).</para>
             </glossdef>
         </glossentry>
 
@@ -577,11 +581,11 @@
         <glossentry id='var-LAYERVERSION'><glossterm>LAYERVERSION</glossterm>
             <glossdef>
                 <para>Optionally specifies the version of a layer as a single number.
-                    This may be used within LAYERDEPENDS for another layer in order to
+                    You can use this within <filename>LAYERDEPENDS</filename> for another layer in order to
                     depend on a specific version of the layer.
                     This variable is used in the <filename>conf/layer.conf</filename> file 
                     and must be suffixed with the name of the specific layer (e.g.
-                    LAYERVERSION_mylayer).</para>
+                    <filename>LAYERVERSION_mylayer</filename>).</para>
             </glossdef>
         </glossentry>
 
@@ -600,7 +604,7 @@
                     failure, which gives the developer an opportunity to review any 
                     license change.</para>
                 <para>
-                    This variable must be defined for all recipes (unless LICENSE
+                    This variable must be defined for all recipes (unless <filename>LICENSE</filename>
                     is set to "CLOSED")</para>
                 <para>For more information, see the
                     <link linkend='usingpoky-configuring-LIC_FILES_CHKSUM'>
@@ -970,10 +974,11 @@
                 <para>
                     The revision of the source code used to build the package.
                     This variable applies to Subversion, Git, Mercurial and Bazaar
-                    only. Note that if you wish to build a fixed revision and you wish
+                    only. 
+                    Note that if you wish to build a fixed revision and you wish
                     to avoid performing a query on the remote repository every time
-                    BitBake parses your recipe, you should specify a SRCREV that is a
-                    full revision identifier (and not just a tag).
+                    BitBake parses your recipe, you should specify a <filename>SRCREV</filename> that is a
+                    full revision identifier and not just a tag.
                 </para>
             </glossdef>
         </glossentry>
@@ -1070,14 +1075,16 @@
                     By default, the variable is set to "xterm" but it can 
                     be any X11 terminal application or a terminal multiplexer such as screen.
                 </para>
-                <para>
-                    NOTE: whilst KONSOLE_TERMCMD and KONSOLE_TERMCMDRUN are provided
+                <note>
+                    While <filename>KONSOLE_TERMCMD</filename> and 
+                    <filename>KONSOLE_TERMCMDRUN</filename> are provided
                     and will work with KDE's Konsole terminal application Konsole from KDE 3,
-                    Konsole in KDE 4.0 and later will no longer work here due to the fact
+                    Konsole in KDE 4.0 and later versions will no longer work here due to the fact
                     that it now launches in the background by default, and it is not practically
-                    possible to wait until it has terminated. It is hoped that this can be fixed
+                    possible to wait until it has terminated. 
+                    It is hoped that this can be fixed
                     in a future version.
-                </para>
+                </note>
             </glossdef>
         </glossentry>