* scm/define-grobs.scm (all-grob-descriptions): reorganize in

[lilypond.git] / Documentation / user / advanced-notation.itely

diff --git a/Documentation/user/advanced-notation.itely b/Documentation/user/advanced-notation.itely
index 21774cba711bd22e1e117fbebb7fd9dbdbd023b8..6d3255042e8b1e591540093b5e7e809f4d3f0b11 100644 (file)
--- a/Documentation/user/advanced-notation.itely
+++ b/Documentation/user/advanced-notation.itely
@@ -1709,6 +1709,24 @@ To see all notehead styles, please see
 
 Program reference: @internalsref{NoteHead}.
 
+@node Pitched trills
+@subsection Pitched trills
+
+Trills that should be executed on an explicitly specified pitch can be
+typeset with the command @code{pitchedTrill}, 
+
+@lilypond[raggedright,verbatim]
+  \pitchedTrill c'4\startTrillSpan fis
+  f'\stopTrillSpan
+@end lilypond
+
+The first argument is the main note. The absolute pitch of the second
+is printed as a stemless note head in parentheses.
+
+@refbugs
+
+Relative octave mode ignores the octave of the second argument of
+@code{\pitchedTrill}.
 
 @node Feathered beams
 @subsection Feathered beams