Doc-fr: Learning Manual full update

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

diff --git a/Documentation/user/percussion.itely b/Documentation/user/percussion.itely
index d972e619748fdad47a9e0cd8ced3a4df174d45d8..f182b78a9ac80c0f0ee332199fe05bd8e16dda39 100644 (file)
--- a/Documentation/user/percussion.itely
+++ b/Documentation/user/percussion.itely
@@ -6,13 +6,13 @@
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 

-@c \version "2.11.51"
+@c \version "2.12.0"

 
 @node Percussion
 @section Percussion
 
 @menu
 
 @node Percussion
 @section Percussion
 
 @menu

-* Common notation for percussion::  
+* Common notation for percussion::

 @end menu
 
 @node Common notation for percussion
 @end menu
 
 @node Common notation for percussion


@@ -22,17 +22,17 @@ Rhythmic music is primarily used for percussion and drum notation, but it can
 also be used to show the rhythms of melodies.
 
 @menu
 also be used to show the rhythms of melodies.
 
 @menu

-* References for percussion::   
-* Basic percussion notation::   
-* Drum rolls::                  
-* Pitched percussion::          
-* Percussion staves::           
-* Custom percussion staves::    
-* Ghost notes::                 
+* References for percussion::
+* Basic percussion notation::
+* Drum rolls::
+* Pitched percussion::
+* Percussion staves::
+* Custom percussion staves::
+* Ghost notes::

 @end menu
 
 @node References for percussion
 @end menu
 
 @node References for percussion

-@subsubsection References for percussion
+@unnumberedsubsubsec References for percussion

 
 TODO add more.
 
 
 TODO add more.
 


@@ -47,8 +47,8 @@ discussed in @ref{Showing melody rhythms}, and
 
 @end itemize
 
 
 @end itemize
 

-@seealso

 
 

+@seealso

 Notation Reference:
 @ref{Showing melody rhythms},
 @ref{Instantiating new staves}.
 Notation Reference:
 @ref{Showing melody rhythms},
 @ref{Instantiating new staves}.


@@ -58,7 +58,7 @@ Snippets: @rlsr{Percussion}.
 
 
 @node Basic percussion notation
 
 
 @node Basic percussion notation

-@subsubsection Basic percussion notation
+@unnumberedsubsubsec Basic percussion notation

 
 @cindex percussion
 @cindex drums
 
 @cindex percussion
 @cindex drums


@@ -96,8 +96,8 @@ contex, but other clefs may also be used.
 There are a few issues concerning MIDI support for percussion
 instruments; for details please see @ref{Percussion in MIDI}.
 
 There are a few issues concerning MIDI support for percussion
 instruments; for details please see @ref{Percussion in MIDI}.
 

-@seealso

 
 

+@seealso

 Notation Reference: @ref{Percussion in MIDI}, @ref{Percussion notes}.
 
 File: @file{ly/@/drumpitch@/-init@/.ly}
 Notation Reference: @ref{Percussion in MIDI}, @ref{Percussion notes}.
 
 File: @file{ly/@/drumpitch@/-init@/.ly}


@@ -106,7 +106,7 @@ Snippets: @rlsr{Percussion}.
 
 
 @node Drum rolls
 
 
 @node Drum rolls

-@subsubsection Drum rolls
+@unnumberedsubsubsec Drum rolls

 
 Drum rolls are indicated with three slashes across the stem.  For
 quarter notes or longer the three slashes are shown explicitly,
 
 Drum rolls are indicated with three slashes across the stem.  For
 quarter notes or longer the three slashes are shown explicitly,


@@ -138,20 +138,20 @@ overridden to achieve a pleasing baseline.
 }
 @end lilypond
 
 }
 @end lilypond
 

-@seealso

 
 

+@seealso

 Snippets: @rlsr{Percussion}.
 
 
 @node Pitched percussion
 Snippets: @rlsr{Percussion}.
 
 
 @node Pitched percussion

-@subsubsection Pitched percussion
+@unnumberedsubsubsec Pitched percussion

 
 Certain pitched percussion instruments (e.g. xylophone,
 
 Certain pitched percussion instruments (e.g. xylophone,

-vibraphone, and timpani) are written using with normal staffs.
+vibraphone, and timpani) are written using normal staves.

 This is covered in other sections of the manual.
 
 This is covered in other sections of the manual.
 

-@seealso

 
 

+@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
 @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


@@ -161,7 +161,7 @@ Snippets: @rlsr{Percussion}.
 
 
 @node Percussion staves
 
 
 @node Percussion staves

-@subsubsection Percussion staves
+@unnumberedsubsubsec Percussion staves

 
 @cindex percussion
 @cindex drums
 
 @cindex percussion
 @cindex drums


@@ -227,7 +227,7 @@ mus = \drummode {
        \remove Bar_engraver
        \remove Time_signature_engraver
        \override Stem #'transparent = ##t
        \remove Bar_engraver
        \remove Time_signature_engraver
        \override Stem #'transparent = ##t

-       \override Stem #'Y-extent-callback = ##f
+       \override Stem #'Y-extent = ##f

        \override VerticalAxisGroup #'minimum-Y-extent = #'(-4.0 . 5.0)
      } \mus
      \new Lyrics \nam
        \override VerticalAxisGroup #'minimum-Y-extent = #'(-4.0 . 5.0)
      } \mus
      \new Lyrics \nam


@@ -259,7 +259,7 @@ mus = \drummode { timh ssh timl ssl cb s16 }
     \remove Bar_engraver
     \remove Time_signature_engraver
     \override Stem #'transparent = ##t
     \remove Bar_engraver
     \remove Time_signature_engraver
     \override Stem #'transparent = ##t

-    \override Stem #'Y-extent-callback = ##f
+    \override Stem #'Y-extent = ##f

     \override StaffSymbol #'line-count = #2
     \override StaffSymbol #'staff-space = #2
     \override VerticalAxisGroup #'minimum-Y-extent = #'(-3.0 . 4.0)
     \override StaffSymbol #'line-count = #2
     \override StaffSymbol #'staff-space = #2
     \override VerticalAxisGroup #'minimum-Y-extent = #'(-3.0 . 4.0)


@@ -289,7 +289,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
     %% this sucks; it will lengthen stems.
     \override StaffSymbol #'staff-space = #2
     \override Stem #'transparent = ##t

-    \override Stem #'Y-extent-callback = ##f
+    \override Stem #'Y-extent = ##f

   } \mus
   \new Lyrics {
     \override LyricText #'font-family = #'typewriter
   } \mus
   \new Lyrics {
     \override LyricText #'font-family = #'typewriter


@@ -315,7 +315,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
     %% this sucks; it will lengthen stems.
     \override StaffSymbol #'staff-space = #2
     \override Stem #'transparent = ##t

-    \override Stem #'Y-extent-callback = ##f
+    \override Stem #'Y-extent = ##f

   } \mus
   \new Lyrics {
     \override LyricText #'font-family = #'typewriter
   } \mus
   \new Lyrics {
     \override LyricText #'font-family = #'typewriter


@@ -338,7 +338,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 StaffSymbol #'line-count = #1
     \remove Time_signature_engraver
     \override Stem #'transparent = ##t

-    \override Stem #'Y-extent-callback = ##f
+    \override Stem #'Y-extent = ##f

   } \mus
   \new Lyrics {
     \override LyricText #'font-family = #'typewriter
   } \mus
   \new Lyrics {
     \override LyricText #'font-family = #'typewriter


@@ -350,7 +350,7 @@ mus = \drummode { tri trio trim gui guis guil cb cl tamb cab mar hc s16 }
 
 
 @node Custom percussion staves
 
 
 @node Custom percussion staves

-@subsubsection Custom percussion staves
+@unnumberedsubsubsec Custom percussion staves

 
 If you do not like any of the predefined lists you can define your
 own list at the top of your file.
 
 If you do not like any of the predefined lists you can define your
 own list at the top of your file.


@@ -393,15 +393,15 @@ woodstaff = {
   % It also defines the positions of the two lines.
   \override Staff.StaffSymbol #'line-positions = #'(-2 3)
 
   % It also defines the positions of the two lines.
   \override Staff.StaffSymbol #'line-positions = #'(-2 3)
 

-  % This is neccessary; if not entered, the barline wuld be too short!
+  % This is neccessary; if not entered, the barline would be too short!

   \override Staff.BarLine #'bar-size = #3
 }
   \override Staff.BarLine #'bar-size = #3
 }

- 
+

 \new DrumStaff {
 \new DrumStaff {

-  \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums) 
+  \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)

 
   % with this you load your new drum style table
 
   % with this you load your new drum style table

-  \woodstaff 
+  \woodstaff

 
   \drummode {
     \time 2/4
 
   \drummode {
     \time 2/4


@@ -411,38 +411,37 @@ woodstaff = {
 }
 @end lilypond
 
 }
 @end lilypond
 

-@seealso
-

 Note that in this special case the length of the barline must
 altered with @code{\override Staff.BarLine #'bar-size #number}.
 Note that in this special case the length of the barline must
 altered with @code{\override Staff.BarLine #'bar-size #number}.

-Otherwise it would be too short. And You have also to define the
-positions of the to stafflines.  For more information about these
+Otherwise it would be too short.  And you have also to define the
+positions of the two stafflines.  For more information about these

 delicate things have a look at @ref{Staff symbol}.
 
 A tambourine, entered with @q{tamb}:
 
 @lilypond[quote,verbatim]
 delicate things have a look at @ref{Staff symbol}.
 
 A tambourine, entered with @q{tamb}:
 
 @lilypond[quote,verbatim]

+#(define mydrums '((tambourine default #t 0)))
+

 tambustaff = {
 tambustaff = {

-  \override Staff.StaffSymbol #'line-positions = #'( 0 )   
+  \override Staff.StaffSymbol #'line-positions = #'( 0 )

   \override Staff.BarLine #'bar-size = #3
   \override Staff.BarLine #'bar-size = #3

-  \set DrumStaff.instrumentName = "Tambourine"
+  \set DrumStaff.instrumentName = #"Tambourine"

 }
 
 \new DrumStaff {
 }
 
 \new DrumStaff {

-  \tambustaff 
-  % broken
-  % \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums) 
+  \tambustaff
+  \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)

 
   \drummode {
     \time 6/8
 
   \drummode {
     \time 6/8

-    \repeat "unfold" 2 { tamb8. tamb16 tamb8 tamb tamb tamb | }
+    tamb8. tamb16 tamb8 tamb tamb tamb |

     tamb4. tamb8 tamb tamb |
     % the trick with the scaled duration and the shorter rest
     % is neccessary for the correct ending of the trill-span!
     tamb2.*5/6 \startTrillSpan s8 \stopTrillSpan |
   }
 }
     tamb4. tamb8 tamb tamb |
     % the trick with the scaled duration and the shorter rest
     % is neccessary for the correct ending of the trill-span!
     tamb2.*5/6 \startTrillSpan s8 \stopTrillSpan |
   }
 }

-@end lilypond 
+@end lilypond

 
 Music for Tam-Tam (entered with @q{tt}):
 
 
 Music for Tam-Tam (entered with @q{tt}):
 


@@ -450,18 +449,18 @@ Music for Tam-Tam (entered with @q{tt}):
 #(define mydrums '((tamtam default #t 0)))
 
 tamtamstaff = {
 #(define mydrums '((tamtam default #t 0)))
 
 tamtamstaff = {

-  \override Staff.StaffSymbol #'line-positions = #'( 0 )   
+  \override Staff.StaffSymbol #'line-positions = #'( 0 )

   \override Staff.BarLine #'bar-size = #3
   \override Staff.BarLine #'bar-size = #3

-  \set DrumStaff.instrumentName = "Tamtam"
+  \set DrumStaff.instrumentName = #"Tamtam"

 }
 
 \new DrumStaff {
   \tamtamstaff
 }
 
 \new DrumStaff {
   \tamtamstaff

-  \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums) 
+  \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)

 
   \drummode {
 
   \drummode {

-    tt 1 \pp \laissezVibrer 
-  } 
+    tt 1 \pp \laissezVibrer
+  }

 }
 @end lilypond
 
 }
 @end lilypond
 


@@ -472,18 +471,18 @@ Two different bells, entered with @q{cb} (cowbell) and @q{rb} (ridebell)
                    (cowbell  default #t -2)))
 
 bellstaff = {
                    (cowbell  default #t -2)))
 
 bellstaff = {

-  \override DrumStaff.StaffSymbol #'line-positions = #'(-2 3)  
-  \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums) 
+  \override DrumStaff.StaffSymbol #'line-positions = #'(-2 3)
+  \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)

   \override Staff.BarLine #'bar-size = #3
   \override Staff.BarLine #'bar-size = #3

-  \set DrumStaff.instrumentName = "Different Bells"
+  \set DrumStaff.instrumentName = #"Different Bells"

 }
 }

- 
+

 \new DrumStaff {
   \bellstaff
   \drummode {
     \time 2/4
 \new DrumStaff {
   \bellstaff
   \drummode {
     \time 2/4

-    \repeat "unfold" 2 { rb8 rb cb cb16 rb-> ~ |
-                         rb16 rb8 rb16 cb8 cb | }
+    rb8 rb cb cb16 rb-> ~ |
+    rb16 rb8 rb16 cb8 cb |

   }
 }
 @end lilypond
   }
 }
 @end lilypond


@@ -501,12 +500,12 @@ global = {
   \time 3/8 s4.
   \time 2/4 s2
 }
   \time 3/8 s4.
   \time 2/4 s2
 }

- 
+

 drumsA = {
   \context DrumVoice <<
     { \global }
     { \drummode {
 drumsA = {
   \context DrumVoice <<
     { \global }
     { \drummode {

-        \autoBeamOff 
+        \autoBeamOff

         \stemDown sn8 \stemUp tamb s8 |
         sn4 \stemDown sn4 |
         \stemUp tamb8 \stemDown sn8 \stemUp sn16 \stemDown sn \stemUp sn8 |
         \stemDown sn8 \stemUp tamb s8 |
         sn4 \stemDown sn4 |
         \stemUp tamb8 \stemDown sn8 \stemUp sn16 \stemDown sn \stemUp sn8 |


@@ -522,12 +521,12 @@ drumsB = {
     s4 bd8 s2*2 s4 bd8 s4 bd8 s8
   }
 }
     s4 bd8 s2*2 s4 bd8 s4 bd8 s8
   }
 }

- 
+

 \layout {
   indent = #40
 \layout {
   indent = #40

-} 
+}

 
 

-\score { 
+\score {

   \new StaffGroup <<
     \new DrumStaff {
       \set DrumStaff.instrumentName = \markup {
   \new StaffGroup <<
     \new DrumStaff {
       \set DrumStaff.instrumentName = \markup {


@@ -539,27 +538,26 @@ drumsB = {
       }
       \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
       \drumsA
       }
       \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
       \drumsA

-    } 
+    }

 
    \new DrumStaff {
 
    \new DrumStaff {

-     \set DrumStaff.instrumentName = "Grosse Caisse"
+     \set DrumStaff.instrumentName = #"Grosse Caisse"

      \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
      \drumsB }
      \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums)
      \drumsB }

-  >> 
+  >>

 }
 @end lilypond
 
 }
 @end lilypond
 

-@seealso

 
 

+@seealso

 Snippets: @rlsr{Percussion}.
 
 Internals Reference: @rinternals{DrumStaff}, @rinternals{DrumVoice}.
 
 
 Snippets: @rlsr{Percussion}.
 
 Internals Reference: @rinternals{DrumStaff}, @rinternals{DrumVoice}.
 
 

-

 @c TODO: check name -gp
 @node Ghost notes
 @c TODO: check name -gp
 @node Ghost notes

-@subsubsection Ghost notes
+@unnumberedsubsubsec Ghost notes

 
 Ghost notes for drums and percussion may be created using the
 @code{\parenthesize} command detailed in @ref{Parentheses}.
 
 Ghost notes for drums and percussion may be created using the
 @code{\parenthesize} command detailed in @ref{Parentheses}.


@@ -569,16 +567,18 @@ However, the default @code{\drummode} does not include the
 @lilypond[quote,ragged-right,verbatim,fragment]
 \new DrumStaff \with {
   \consists "Parenthesis_engraver"
 @lilypond[quote,ragged-right,verbatim,fragment]
 \new DrumStaff \with {
   \consists "Parenthesis_engraver"

-} <<
-  \context DrumVoice  = "1"  { s1 *2 }
-  \context DrumVoice  = "2" { s1 *2 }
+}
+<<
+  \context DrumVoice  = "1" { s1 }
+  \context DrumVoice  = "2" { s1 }

   \drummode {
     <<
       {
         hh8[ hh] <hh sn> hh16
         < \parenthesize sn > hh
         < \parenthesize sn > hh8 <hh sn> hh
   \drummode {
     <<
       {
         hh8[ hh] <hh sn> hh16
         < \parenthesize sn > hh
         < \parenthesize sn > hh8 <hh sn> hh

-      } \\ {
+      } \\
+      {

         bd4 r4 bd8 bd r8 bd
       }
     >>
         bd4 r4 bd8 bd r8 bd
       }
     >>


@@ -590,6 +590,6 @@ However, the default @code{\drummode} does not include the
 Also note that you must add chords (@code{< >} brackets)
 around each @code{\parenthesize} statement.
 
 Also note that you must add chords (@code{< >} brackets)
 around each @code{\parenthesize} statement.
 

-@seealso

 
 

+@seealso

 Snippets: @rlsr{Percussion}.
 Snippets: @rlsr{Percussion}.