Merge branch 'master' of ssh+git://git.sv.gnu.org/srv/git/lilypond

[lilypond.git] / Documentation / notation / staff.itely

diff --git a/Documentation/notation/staff.itely b/Documentation/notation/staff.itely
index c9a8254d901e65014e10227bc65f03de8852f7f4..64897821755a72c4804032b3fe60be568a4dbafb 100644 (file)
--- a/Documentation/notation/staff.itely
+++ b/Documentation/notation/staff.itely
@@ -750,9 +750,15 @@ hide empty staves in ancient music contexts.  Similarly,
 Music Glossary:
 @rglos{Frenched staff}.
 
+Learning Manual:
+@rlearning{Visibility and color of objects}.
+
 Notation Reference:
 @ref{Staff symbol},
-@ref{Ossia staves}.
+@ref{Ossia staves},
+@ref{Hidden notes},
+@ref{Invisible rests},
+@ref{Visibility of objects}.
 
 Snippets:
 @rlsr{Staff notation}.
@@ -1312,6 +1318,26 @@ It is possible to tag cued parts with unique names in order to
 process them in different ways.  For details about this procedure,
 see @ref{Using tags}.
 
+@cindex notes, smaller
+@cindex smaller notes
+
+A @code{CueVoice} context may be created explicitly if notes of a
+smaller size are required, for example to set an alternative
+sequence of notes more suitable for a higher or lower voice.
+
+@lilypond[verbatim,relative=2]
+\time 12/8
+\key ees \major
+g4 ees8 f4 g8
+\stemDown
+<<
+  { d4. bes4 c8 }
+  \new CueVoice 
+  { g'4. f4 ees8 }
+>>
+\stemUp
+d2. d2.
+@end lilypond
 
 @seealso
 Notation Reference: