Attempt to explain . as macro name terminator

csound · Jun 28, 2019 · 747685f · 747685f
1 parent e389e27
commit 747685f
Show file tree

Hide file tree

Showing 2 changed files with 17 additions and 8 deletions.
diff --git 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
@@ -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>