diff --git a/doc/xscore_gen.md b/doc/xscore_gen.md
index 1ee54d1..65300e6 100644
--- a/doc/xscore_gen.md
+++ b/doc/xscore_gen.md
@@ -233,6 +233,7 @@ Edit Sytax:
 %<grace_note_flag>      Flag note as a grace note
 %%<grace_note_flag>         -last note in grace note sequence
 $<sci_pitch>            Assign a note a new pitch
+[ <comment> ]           Add an arbitrary comment.
 
 <grace_note_flag>
   b (begin grace)
@@ -256,6 +257,9 @@ It is only necessary to mark the tick number of grace notes in order
 to give the time sequence of the notes. A single grace note therefore does
 not require an explict tick mark notation (i.e. @####)
 
+Note that a given event (e.g. note,rest,bar) can be marked as both the
+begin (i.e.%b) and end (e.g. %%a, %s) of a grace note sequence. 
+
 
 Insert/delete  Event Marks: <mark>
 -----------------------------------