From: Han-Wen Nienhuys <hanwen@xs4all.nl>
Date: Tue, 19 Nov 2002 00:12:15 +0000 (+0000)
Subject: * Documentation/user/refman.itely (Analysis brackets): add
X-Git-Tag: release/1.7.8~2
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=fac0d2eb9cbaf9ae45f36a7e1aa651d25932d459;p=lilypond.git

* Documentation/user/refman.itely (Analysis brackets): add
horizontal bracket doco.

* Documentation/user/refman.itely (Multi measure rests): fermatas
on mm rests.
---

diff --git a/ChangeLog b/ChangeLog
index 07dd8ec138..4e59cb531a 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,8 @@
 2002-11-19  Han-Wen Nienhuys  <hanwen@cs.uu.nl>
 
+	* Documentation/user/refman.itely (Analysis brackets): add
+	horizontal bracket doco.
+
 	* ly/property-init.ly (setMmRestFermata): added.
 
 	* Documentation/user/refman.itely (Multi measure rests): fermatas
diff --git a/Documentation/user/refman.itely b/Documentation/user/refman.itely
index 8cb5be61a7..7d7ece992f 100644
--- a/Documentation/user/refman.itely
+++ b/Documentation/user/refman.itely
@@ -1651,6 +1651,7 @@ accidentals using @code{!} and @code{?}.
 * Breath marks::                
 * Tempo::                       
 * Text spanners::               
+* Analysis brackets::           
 @end menu
 
 @node Slurs 
@@ -1814,6 +1815,32 @@ An application---or rather, a hack---is to fake octavation indications.
 @end lilypond
 
 
+@node Analysis brackets
+@subsection Analysis brackets
+@cindex brackets
+@cindex phrasing brackets
+@cindex musicological analysis
+@cindex note grouping bracket
+
+Brackets are used in musical analysis to indicate structure in musical
+pieces. LilyPond supports a simple form of nested horizontal brackets.
+To use this, add the @internalsref{Horizontal_bracket_engraver} to
+@internalsref{Staff} context.  A bracket is started with
+@code{\groupOpen} and closed with @code{\groupClose}. This produces
+@internalsref{HorizontalBracket} objects.
+
+@lilypond[singleline,verbatim]
+\score { \notes \relative c'' {  
+	c4-\groupOpen-\groupOpen
+	c4-\groupClose
+	c4-\groupOpen
+        c4-\groupClose-\groupClose
+  }
+  \paper { \translator {
+	    \StaffContext \consists "Horizontal_bracket_engraver"
+	}}}
+@end lilypond
+
 @c .  {Ornaments}
 @node Ornaments
 @section Ornaments
@@ -2865,7 +2892,7 @@ Piano pedal instruction can be expressed using
 The symbols that are printed can be modified by setting
 @code{pedal@var{X}Strings}, where @var{X} is one of the pedal types:
 Sustain, Sostenuto or UnaCorda.  Refer to the generated documentation of
-@rgrob{SustainPedal}, for example, for more information.
+@internalsref{SustainPedal}, for example, for more information.
 
 Pedals can also be indicated by a sequence of brackets, by setting the 
 @code{pedal-type} property of SustainPedal objects: