Doc: NR section 3.5.x MIDI file creation tidy up

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

diff --git a/Documentation/notation/percussion.itely b/Documentation/notation/percussion.itely
index 3a0db13be44546f9d2682515b8622179d2f6b3e0..be6bc04c35662e688bdd0afbdc95e337fa274d1e 100644 (file)
--- a/Documentation/notation/percussion.itely
+++ b/Documentation/notation/percussion.itely
@@ -44,7 +44,7 @@ discussed in @ref{Showing melody rhythms}, and
 @ref{Instantiating new staves}.
 
 @item MIDI output is discussed in a separate section; please see
-@ref{Percussion in MIDI}.
+@ref{MIDI instruments}.
 
 @end itemize
 
@@ -52,7 +52,7 @@ discussed in @ref{Showing melody rhythms}, and
 Notation Reference:
 @ref{Showing melody rhythms},
 @ref{Instantiating new staves}.
-@ref{Percussion in MIDI}.
+@ref{MIDI instruments}.
 
 Snippets:
 @rlsr{Percussion}.
@@ -108,11 +108,11 @@ 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}.
+instruments; for details please see @ref{MIDI instruments}.
 
 @seealso
 Notation Reference:
-@ref{Percussion in MIDI},
+@ref{MIDI instruments},
 @ref{Percussion notes}.
 
 Installed Files:
@@ -173,11 +173,8 @@ 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
-@c pitched percussion sounds.  -gp
 Notation Reference:
-@ref{Percussion in MIDI}.
+@ref{MIDI instruments}.
 
 Snippets:
 @rlsr{Percussion}.
@@ -267,6 +264,37 @@ toms, simply select the toms that produce the desired result.  For
 example, to get toms on the three middle lines you use
 @code{tommh}, @code{tomml}, and @code{tomfh}.
 
+@item agostini-drums-style
+Invented by the French percussionist Dante Agostini in 1965, this notation is
+commonly employed in France but also elsewhere.
+
+@lilypond[quote,line-width=10.0\cm]
+nam = \lyricmode {
+  cymc cyms cymr hh hhc hho hhho hhp
+  cb hc bd sn ss tomh tommh tomml toml tomfh tomfl }
+mus = \drummode {
+  cymc cyms cymr hh hhc hho hhho hhp \break
+  cb hc bd sn ss tomh tommh tomml toml tomfh tomfl s16 }
+\score {
+  << \new DrumStaff \with {
+       \remove "Bar_engraver"
+       \remove "Time_signature_engraver"
+       \hide Stem
+       \override Stem.Y-extent = ##f
+       drumStyleTable = #agostini-drums-style
+     } \mus
+     \new Lyrics \nam
+  >>
+  \layout {
+    \context {
+      \Score
+      \override LyricText.font-family = #'typewriter
+      \override BarNumber.transparent =##T
+    }
+  }
+}
+@end lilypond
+
 @item timbales-style
 This typesets timbales on a two line staff:
 
@@ -584,13 +612,9 @@ Internals Reference:
 
 Ghost notes for drums and percussion may be created using the
 @code{\parenthesize} command detailed in @ref{Parentheses}.
-However, the default @code{\drummode} does not include the
-@code{Parenthesis_engraver} plugin which allows this.
 
 @lilypond[quote,ragged-right,verbatim]
-\new DrumStaff \with {
-  \consists "Parenthesis_engraver"
-}
+\new DrumStaff
 <<
   \context DrumVoice  = "1" { s1 }
   \context DrumVoice  = "2" { s1 }