Merge branch 'lilypond/translation'

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

diff --git a/Documentation/notation/percussion.itely b/Documentation/notation/percussion.itely
index ebcdb12dfad345fd37aaa49eea07e9856e65af64..1048b387bce5e3e8d52f8fc984423605ec064bdd 100644 (file)
--- a/Documentation/notation/percussion.itely
+++ b/Documentation/notation/percussion.itely
@@ -3,10 +3,11 @@
     Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
 
     When revising a translation, copy the HEAD committish of the
-    version that you are working on.  See TRANSLATION for details.
+    version that you are working on.  For details, see the Contributors'
+    Guide, node Updating translation committishes..
 @end ignore
 
-@c \version "2.12.0"
+@c \version "2.13.36"
 
 @node Percussion
 @section Percussion
@@ -89,10 +90,24 @@ Each piece of percussion has a full name and an abbreviated name,
 and both can be used in input files.  The full list of percussion
 note names may be found in @ref{Percussion notes}.
 
-Note that the normal notation of pitches (such as @code{cis4}) in
-a @code{DrumStaff} context will cause an error message.
-Percussion clefs are added automatically to a @code{DrumStaff}
-contex, but other clefs may also be used.
+@cindex clef, percussion
+@cindex percussion clef
+
+Note that the normal notation of pitches (such as @code{cis4}) in a
+@code{DrumStaff} context will cause an error message.  Percussion clefs
+are added automatically to a @code{DrumStaff} context but they can also
+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
+}
+@end lilypond
+
 
 There are a few issues concerning MIDI support for percussion
 instruments; for details please see @ref{Percussion in MIDI}.
@@ -214,7 +229,7 @@ There are also other layout possibilities.  To use these, set the
 property @code{drumStyleTable} in context @code{DrumVoice}.  The
 following variables have been predefined:
 
-@c FIXME: decide what to do about this table.  (ie verbatim or not)
+@c TODO: decide what to do about this table.  (ie verbatim or not)
 @table @code
 
 @item drums-style
@@ -234,7 +249,6 @@ mus = \drummode {
        \remove Time_signature_engraver
        \override Stem #'transparent = ##t
        \override Stem #'Y-extent = ##f
-       \override VerticalAxisGroup #'minimum-Y-extent = #'(-4.0 . 5.0)
      } \mus
      \new Lyrics \nam
   >>
@@ -363,12 +377,13 @@ own list at the top of your file.
 
 @lilypond[quote,verbatim]
 #(define mydrums '(
-         (bassdrum     default   #f         -1)
-         (snare        default   #f         0)
-         (hihat        cross     #f         1)
-         (pedalhihat   xcircle   "stopped"  2)
-         (lowtom       diamond   #f         3)))
-up = \drummode { hh8 hh hh hh hhp4 hhp }
+         (bassdrum        default   #f           -1)
+         (snare           default   #f           0)
+         (hihat           cross     #f           1)
+         (halfopenhihat   cross     "halfopen"   1)
+         (pedalhihat      xcircle   "stopped"    2)
+         (lowtom          diamond   #f           3)))
+up = \drummode { hh8 hh hhho hhho hhp4 hhp }
 down = \drummode { bd4 sn bd toml8 toml }
 
 \new DrumStaff <<
@@ -381,7 +396,7 @@ down = \drummode { bd4 sn bd toml8 toml }
 
 @snippets
 
-FIXME: MOVE ALL THESE TO LSR!  -gp
+@c TODO: MOVE ALL THESE TO LSR!  -gp
 
 Here are some examples:
 
@@ -399,7 +414,7 @@ woodstaff = {
   % It also defines the positions of the two lines.
   \override Staff.StaffSymbol #'line-positions = #'(-2 3)
 
-  % This is neccessary; if not entered, the barline would be too short!
+  % This is necessary; if not entered, the barline would be too short!
   \override Staff.BarLine #'bar-size = #3
 }
 
@@ -573,7 +588,7 @@ Ghost notes for drums and percussion may be created using the
 However, the default @code{\drummode} does not include the
 @code{Parenthesis_engraver} plugin which allows this.
 
-@lilypond[quote,ragged-right,verbatim,fragment]
+@lilypond[quote,ragged-right,verbatim]
 \new DrumStaff \with {
   \consists "Parenthesis_engraver"
 }