Imported Upstream version 2.16.0

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

diff --git a/Documentation/notation/percussion.itely b/Documentation/notation/percussion.itely
index f325de0abc5131908dcec3e823c8904d1b4b4306..ff6b22b31e6c30c6a943619a16bfceb0427a336f 100644 (file)
--- a/Documentation/notation/percussion.itely
+++ b/Documentation/notation/percussion.itely
@@ -7,7 +7,7 @@
     Guide, node Updating translation committishes..
 @end ignore
 
-@c \version "2.14.0"
+@c \version "2.16.0"
 
 @node Percussion
 @section Percussion
@@ -48,7 +48,6 @@ discussed in @ref{Showing melody rhythms}, and
 
 @end itemize
 
-
 @seealso
 Notation Reference:
 @ref{Showing melody rhythms},
@@ -100,11 +99,10 @@ be set explicitly.  Other clefs may be used as well.
 
 @lilypond[quote,ragged-right,verbatim]
 \drums {
-  \clef treble
-  hh4 hh hh hh
-  \break
   \clef percussion
   bd4 bd bd bd
+  \clef treble
+  hh4 hh hh hh
 }
 @end lilypond
 
@@ -112,14 +110,13 @@ be set explicitly.  Other clefs may be used as well.
 There are a few issues concerning MIDI support for percussion
 instruments; for details please see @ref{Percussion in MIDI}.
 
-
 @seealso
 Notation Reference:
 @ref{Percussion in MIDI},
 @ref{Percussion notes}.
 
-File:
-@file{ly/drumpitch-init.ly}
+Installed Files:
+@file{ly/drumpitch-init.ly}.
 
 Snippets:
 @rlsr{Percussion}.
@@ -133,8 +130,7 @@ quarter notes or longer the three slashes are shown explicitly,
 eighth notes are shown with two slashes (the beam being the
 third), and drum rolls shorter than eighths have one stem slash to
 supplement the beams.  This is achieved with the tremolo notation,
-@code{:32}, as described in @ref{Tremolo repeats}.  Here is an
-example of some snare rolls:
+as described in @ref{Tremolo repeats}.
 
 @lilypond[quote,verbatim]
 \drums {
@@ -146,20 +142,25 @@ example of some snare rolls:
 }
 @end lilypond
 
-Sticking can be indicated by placing @code{^"R"} or @code{^"L"}
-after the note.  The @code{staff-padding} property may be
-overridden to achieve a pleasing baseline.
+Sticking can be indicated by placing a markup for @code{"R"}
+or @code{"L"} above or below notes, as discussed in
+@ref{Direction and placement}.  The @code{staff-padding} property
+may be overridden to achieve a pleasing baseline.
 
 @lilypond[quote,verbatim]
 \drums {
   \repeat unfold 2 {
-    sn16 ^"L" sn^"R" sn^"L" sn^"L" sn^"R" sn^"L"  sn^"R" sn^"R"
+    sn16^"L" sn^"R" sn^"L" sn^"L" sn^"R" sn^"L" sn^"R" sn^"R"
+    \stemUp
+    sn16_"L" sn_"R" sn_"L" sn_"L" sn_"R" sn_"L" sn_"R" sn_"R"
   }
 }
 @end lilypond
 
-
 @seealso
+Notation Reference:
+@ref{Tremolo repeats}.
+
 Snippets:
 @rlsr{Percussion}.
 
@@ -171,7 +172,6 @@ Certain pitched percussion instruments (e.g. xylophone,
 vibraphone, and timpani) are written using normal staves.
 This is covered in other sections of the manual.
 
-
 @seealso
 @c TODO: possibly link to an alternate section of NR 3.5, if
 @c "percussion in MIDI" gets a separate subsubsection for
@@ -248,6 +248,7 @@ mus = \drummode {
        \remove Bar_engraver
        \remove Time_signature_engraver
        \override Stem #'transparent = ##t
+       \override Flag #'transparent = ##t
        \override Stem #'Y-extent = ##f
      } \mus
      \new Lyrics \nam
@@ -279,6 +280,7 @@ mus = \drummode { timh ssh timl ssl cb s16 }
     \remove Bar_engraver
     \remove Time_signature_engraver
     \override Stem #'transparent = ##t
+    \override Flag #'transparent = ##t
     \override Stem #'Y-extent = ##f
     \override StaffSymbol #'line-count = #2
     \override StaffSymbol #'staff-space = #2
@@ -309,6 +311,7 @@ mus = \drummode { cgh cgho cghm ssh cgl cglo cglm ssl s16 }
     %% this sucks; it will lengthen stems.
     \override StaffSymbol #'staff-space = #2
     \override Stem #'transparent = ##t
+    \override Flag #'transparent = ##t
     \override Stem #'Y-extent = ##f
   } \mus
   \new Lyrics {
@@ -335,6 +338,7 @@ mus = \drummode { boh boho bohm ssh bol bolo bolm ssl s16 }
     %% this sucks; it will lengthen stems.
     \override StaffSymbol #'staff-space = #2
     \override Stem #'transparent = ##t
+    \override Flag #'transparent = ##t
     \override Stem #'Y-extent = ##f
   } \mus
   \new Lyrics {
@@ -358,6 +362,7 @@ mus = \drummode { tri trio trim gui guis guil cb cl tamb cab mar hc s16 }
     \override StaffSymbol #'line-count = #1
     \remove Time_signature_engraver
     \override Stem #'transparent = ##t
+    \override Flag #'transparent = ##t
     \override Stem #'Y-extent = ##f
   } \mus
   \new Lyrics {
@@ -569,7 +574,6 @@ drumsB = {
 }
 @end lilypond
 
-
 @seealso
 Snippets:
 @rlsr{Percussion}.
@@ -614,7 +618,6 @@ However, the default @code{\drummode} does not include the
 Also note that you must add chords (@code{< >} brackets)
 around each @code{\parenthesize} statement.
 
-
 @seealso
 Snippets:
 @rlsr{Percussion}.