diff --git a/opcodes/dollar.xml b/opcodes/dollar.xml
index 777fc85b76..aabd6b3e6e 100644
--- a/opcodes/dollar.xml
+++ b/opcodes/dollar.xml
@@ -27,7 +27,16 @@
     </para>
 
     <para>
-      <emphasis>&dollar;NAME</emphasis> -- calls a defined macro. To use a macro, the name is used following a &dollar; character. The name is terminated by the first character which is neither a letter nor a number. If it is necessary for the name not to terminate with a space, a period, which will be ignored, can be used to terminate the name. The string, <emphasis>&dollar;NAME</emphasis>., is replaced by the replacement text from the definition. The replacement text can also include macro calls.
+      <emphasis>&dollar;NAME</emphasis>
+      <emphasis>&dollar;NAME.</emphasis>  -- calls a defined macro. To
+      use a macro, the name is used following a &dollar;
+      character. The name is terminated by the first character which
+      is neither a letter nor a number. If it is necessary for the
+      name to be followed by a letter or number, a period, which will be
+      ignored, can be used to terminate the name. The string,
+      <emphasis>&dollar;NAME</emphasis>., is replaced by the
+      replacement text from the definition. The replacement text can
+      also include macro calls. 
     </para>
   </refsect1>
  
@@ -39,7 +48,7 @@
   <refsect1>
     <title>Initialization</title>
     <para>
-      <emphasis>&num; replacement text &num;</emphasis> --  The replacement text is any character string (not containing a &num;) and can extend over mutliple lines. The replacement text is enclosed within the &num; characters, which ensure that additional characters are not inadvertently captured.
+      <emphasis>&num; replacement text &num;</emphasis> --  The replacement text is any character string (not containing a &num;) and can extend over multiple lines. The replacement text is enclosed within the &num; characters, which ensure that additional characters are not inadvertently captured.
     </para>
   </refsect1>
 
diff --git a/score/macros.xml b/score/macros.xml
index 0a1d4e22e4..60255d2c05 100644
--- a/score/macros.xml
+++ b/score/macros.xml
@@ -24,15 +24,15 @@
     </para>
 
     <para>
-      <emphasis>&dollar;NAME.</emphasis> --  calls a defined macro.
-      To use a macro, the name is used following a &dollar; character.
+      <emphasis>&dollar;NAME.</emphasis> -- calls a defined macro.  To
+      use a macro, the name is used following a &dollar; character.
       The name is terminated by the first character which is neither a
-      letter nor a number.  If it is necessary for the name not to
-      terminate with a space, a period, which will be ignored, can be
-      used to terminate the name.  The string,
+      letter nor a number.  If it is necessary for the name to be
+      immediately followed by a leter or digit, a period, which will
+      be ignored, can be used to terminate the name.  The string,
       <emphasis>&dollar;NAME</emphasis>., is replaced by the
       replacement text from the definition.  The replacement text can
-      also include macro calls. 
+      also include macro calls.
     </para>
 
     <para>