diff --git a/v2/doc/src/advanced.xml b/v2/doc/src/advanced.xml
index 0e1e49961..7d2e8a9aa 100644
--- a/v2/doc/src/advanced.xml
+++ b/v2/doc/src/advanced.xml
@@ -631,13 +631,16 @@ rule <replaceable>rule-name</replaceable> (
       <section>
         <title>Name</title>
 
+        <!-- perphaps we should use 'name-target-name' to closer
+        bind this description to the rule's signature. Here, and for
+        other parameters.  -->
         <para>The name of main target has two purposes. First, it's used to refer to this target from
         other targets and from command line. Second, it's used to compute the names of the generated files.
         Typically, filenames are obtained from main target name by appending system-dependent suffixes and
         prefixes.
         </para>
 
-        <para>THe name of a main target can contain alphanumeral characters, 
+        <para>The name of a main target can contain alphanumeric characters, 
         dashes, undescores and dots. The entire
         name is significant when resolving references from other targets. For determining filenames, only the
         part before the first dot is taken. For example:</para>