Make a PostEvents container class for packaging several postevents

scm/define-music-types.scm

Index: scm/define-music-types.scm
diff --git a/scm/define-music-types.scm b/scm/define-music-types.scm
index d816b269ce36dba94436da49eae0ead72b3e48b2..1090d332b49aec21b01fcf852f1f19fc158f7889 100644
--- a/scm/define-music-types.scm
+++ b/scm/define-music-types.scm
@@ -72,10 +72,10 @@ Syntax: @w{@var{note}@code{-\\arpeggio}}")
     (ArticulationEvent
      . ((description . "Add an articulation marking to a note.
 
-Syntax: @var{note}@code{x}@code{y}, where @code{x} is a direction
-(@code{^} for up or @code{_} for down), or LilyPond's choice
-(no direction specified), and where @code{y} is an articulation
-(such as @w{@code{-.}}, @w{@code{->}}, @code{\\tenuto}, @code{\\downbow}).
+Syntax: @var{note}@code{x}@code{y}, where @code{x} is a direction\
+\n(@code{^} for up or @code{_} for down), or LilyPond's choice\
+\n(no direction specified), and where @code{y} is an articulation\

[Ian Hulin (gmail), 2013/03/24 13:20:15]

"\n(no direction specified or @code{-}), and when @code{y} is an articulation\"

[dak, 2013/03/24 13:36:43]

I did not actually change this documentation string, only formatted it
differently to stop it from throwing the whole Emacs indentation/highlighting
engine off.  And @code{-} _does_ not specify a direction but merely is a
syntactic marker not actually related to ArticulationEvent itself.

The whole documentation string is only so-so accurate (for example, one _can't_
have x = ^ and y "such as" -.) and the proposed change is more or less from
inaccurate to inaccurate without a real incremental improvement.

Now this patch has already been committed and this change is a separate commit
"Defuse some open parens starting lines...".  I don't consider it worth
reverting (and getting back the Emacs-confusing strings), but it would certainly
warrant a more accurate rewrite.  The proposed change in wording is not really
an improvement, however.

+\n(such as @w{@code{-.}}, @w{@code{->}}, @code{\\tenuto}, @code{\\downbow}).
 See the Notation Reference for details.")
 	(types . (general-music post-event event articulation-event script-event))
 	))
@@ -437,6 +437,12 @@ Syntax: @var{note}@code{\\(} and @var{note}@code{\\)}")
 	(types . (general-music post-event span-event event phrasing-slur-event))
 	))
 
+    (PostEvents
+     . ((description . "Container for several postevents.
+
+This can be used to package several events into a single one.  Should not be seen outside of the parser.")
+        (types . (post-event post-event-wrapper))))
+
     (PropertySet
      . ((description . "Set a context property.