]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/fr/notation/simultaneous.itely
Show how to properly support the Gonville font.
[lilypond.git] / Documentation / fr / notation / simultaneous.itely
index eac626a57df6f77b7155199d26196c537d65224c..3fdeef18bc111bd736f869ca6a76a6e81e84cdaa 100644 (file)
@@ -1,14 +1,15 @@
-@c -*- coding: utf-8; mode: texinfo; -*-
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @ignore
 @ignore
-    Translation of GIT committish: 33ba8d40c3493011a4b39ab8b1369701f8013bd6
+    Translation of GIT committish: c39256c433c9e0d80429fb768cde5834541524f8
 
     When revising a translation, copy the HEAD committish of the
 
     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"
 
 @end ignore
 
 @c \version "2.12.0"
 
-@c Translators: Frédéric Chiasson, Valentin Villenave
+@c Translators: Frédéric Chiasson, Valentin Villenave, Jean-Charles Malahieude
 @c Translation checkers: Jean-Charles Malahieude, John Mandereau
 
 @node Notes simultanées
 @c Translation checkers: Jean-Charles Malahieude, John Mandereau
 
 @node Notes simultanées
@@ -34,6 +35,7 @@ portée.
 
 @menu
 * Notes en accords::                      
 
 @menu
 * Notes en accords::                      
+* Expressions simultanées::                      
 * Clusters::                    
 @end menu
 
 * Clusters::                    
 @end menu
 
@@ -42,16 +44,82 @@ portée.
 @translationof Chorded notes
 
 @cindex accords
 @translationof Chorded notes
 
 @cindex accords
+@cindex chevrons
+@cindex hauteur relative et accords
+
+@funindex <
+@funindex >
+@funindex <...>
 
 Un accord est formé en mettant une série de hauteurs entre @code{<}
 et @code{>}.  Un accord peut être suivi d'une durée et d'indications
 d'articulation, comme une simple note.
 
 
 Un accord est formé en mettant une série de hauteurs entre @code{<}
 et @code{>}.  Un accord peut être suivi d'une durée et d'indications
 d'articulation, comme une simple note.
 
-@lilypond[verbatim,ragged-right,fragment,quote,relative=1]
-<c e g>4 <c>8
+@lilypond[verbatim,quote,relative=1]
+<c e g>2 <c f a>4-> <e g c>-.
+@end lilypond
+
+Les accords peuvent être saisis en mode relatif.  Dans un accord,
+l'octave de chaque hauteur saisie est fonction de la précédente, à
+l'exception de la première qui, elle, sera positionnée en fonction de la
+première hauteur mentionnée dans l'accord précédent.
+
+Pour plus d'information à propos des accords, voir 
+@ref{Notation des accords}.
+
+
+@seealso
+Glossaire musical :
+@rglos{chord}.
+
+Manuel d'initiation :
+@ref{Notes en accords}.
+
+Manuel de notation :
+@ref{Notation des accords}.
+
+Morceaux choisis :
+@rlsr{Simultaneous notes}.
+
+
+@node Expressions simultanées
+@unnumberedsubsubsec Expressions simultanées
+@translationof Simultaneous expressions
+
+Lorsqu'une ou plusieurs expressions musicales sont encadrées par des
+doubles chevrons, elles sont considérées comme étant simultanées.  Si la
+première expression débute par une note unique ou si l'intégralité de
+l'expression simultanée est explicitement rattachée à une voix en
+particulier, elle sera placée sur une seule portée.  Dans le cas
+contraire, les éléments d'une expression simultanée seront placés sur 
+des portées distinctes. 
+
+Voici deux exemples d'expression simultanée sur une même portée :
+
+@lilypond[quote,verbatim,relative=2]
+\new Voice {  % explicit single voice
+  << { a4 b g2 } { d4 g c,2 } >>
+}
+@end lilypond
+
+@lilypond[quote,verbatim,relative=2]
+% single first note
+a << { a4 b g } { d4 g c, } >>
 @end lilypond
 
 @end lilypond
 
-Pour plus d'information à propos des accords, voir @ref{Notation des accords}.
+Cette manière de procéder est utile lorsque les éléments de l'expression 
+ont des rythmes identiques.  Dès que vous tenterez d'attacher sur une
+même hampe des notes de durée différente, vous générerez des erreurs.
+
+Dans l'exemple suivant, l'expression simultanée génère implicitement
+plusieurs portées :
+
+@lilypond[quote,verbatim,relative=2]
+% no single first note
+<< { a4 b g2 } { d4 g2 c,4 } >>
+@end lilypond
+
+En pareil cas, des rythmes différents ne sont source d'aucun problème. 
 
 
 @node Clusters
 
 
 @node Clusters
@@ -60,32 +128,48 @@ Pour plus d'information à propos des accords, voir @ref{Notation des accords}.
 
 @cindex cluster
 
 
 @cindex cluster
 
-Un cluster indique un agrégat de sons.  On peut le représenter par une
-plage limitée par un ambitus (notes extrêmes).  On obtient une telle notation en
-appliquant la fonction @code{makeClusters} à une séquence d'accords,
-comme  
-@lilypond[quote,ragged-right,relative=2,fragment,verbatim]
-\makeClusters { <c e > <b f'> }
+@funindex \makeClusters
+@funindex makeClusters
+
+Un cluster indique un agrégat de sons.  On peut le représenter par une 
+plage limitée par un ambitus (notes extrêmes).  On obtient une telle
+notation en appliquant la fonction @code{makeClusters} à une séquence
+d'accords, comme  
+
+@lilypond[quote,relative=2,verbatim]
+\makeClusters { <g b>2 <c g'> }
 @end lilypond
 
 Des notes ordinaires et des clusters peuvent cohabiter sur une même
 @end lilypond
 
 Des notes ordinaires et des clusters peuvent cohabiter sur une même
-portée, y compris simultanément --- en pareil cas, rien ne sera fait
+portée, y compris simultanément -- en pareil cas, rien ne sera fait
 pour tenter d'empécher les chevauchements entre notes et clusters.
 
 
 @seealso
 pour tenter d'empécher les chevauchements entre notes et clusters.
 
 
 @seealso
-Référence du programme : @rinternals{ClusterSpanner},
-@rinternals{ClusterSpannerBeacon},
-@rinternals{Cluster_spanner_engraver}.
+Glossaire musicologique :
+@rglos{cluster}.
 
 
-Exemples : @rlsr{Simultaneous notes}.
+Morceaux choisis : 
+@rlsr{Simultaneous notes}.
 
 
+Référence des propriétés internes : 
+@rinternals{ClusterSpanner},
+@rinternals{ClusterSpannerBeacon},
+@rinternals{Cluster_spanner_engraver}.
 
 @knownissues
 
 Les expressions musicales du type @code{<< @{ g8 e8 @} a4 >>} ne
 seront pas imprimées de façon acceptable.  utilisez plutôt 
 
 @knownissues
 
 Les expressions musicales du type @code{<< @{ g8 e8 @} a4 >>} ne
 seront pas imprimées de façon acceptable.  utilisez plutôt 
-@code{<g a>8 <e a>8} . 
+@code{<g a>8 <e a>8}. 
+
+Dans la mesure où un cluster ne possède pas de hampe, il n'y a aucun
+moyen d'en connaître la durée ; cependant la longueur du signe imprimé
+dépend directement de la durée affectée aux accords qui le définissent.
+
+Seul un silence peut séparer deux clusters.
+
+Les clusters ne sont pas reproduits en MIDI.
 
 
 @node Plusieurs voix
 
 
 @node Plusieurs voix
@@ -93,211 +177,432 @@ seront pas imprimées de façon acceptable.  utilisez plutôt
 @translationof Multiple voices
 
 @menu
 @translationof Multiple voices
 
 @menu
-* Polyphonie basique::             
+* Polyphonie sur une portée::             
+* Styles de voix::             
 * Résolution des collisions::        
 * Regroupement automatique de parties::    
 * Saisie de musique en parallèle::   
 @end menu
 
 * Résolution des collisions::        
 * Regroupement automatique de parties::    
 * Saisie de musique en parallèle::   
 @end menu
 
-@node Polyphonie basique
-@unnumberedsubsubsec Polyphonie basique
-@translationof Basic polyphony
+@node Polyphonie sur une portée
+@unnumberedsubsubsec Polyphonie sur une portée
+@translationof Single-staff polyphony
 
 
-@cindex polyphonie
+@cindex polyphonie, portée simple
+@cindex voix
+@cindex paroles assignées à une voix
+
+@funindex \voiceOne
+@funindex voiceOne
+@funindex \voiceOne ... \voiceFour
+@funindex Voice
+@funindex \oneVoice
+@funindex oneVoice
+
+@strong{@i{Instanciation explicite des voix}}
 
 La manière la plus facile d'entrer des fragments avec plus d'une voix
 
 La manière la plus facile d'entrer des fragments avec plus d'une voix
-sur une portée est d'entrer chaque voix comme une suite de notes
---- entre accolades : @code{@{...@}} --- puis de les combiner simultanément,
-en séparant les voix avec @code{\\}
+sur une portée est est la suivante :
 
 
-@funindex \\
+@lilypond[quote,relative=3,verbatim]
+\new Staff <<
+  \new Voice = "first"
+    { \voiceOne r8 r16 g e8. f16 g8[ c,] f e16 d }
+  \new Voice= "second"
+    { \voiceTwo d16 c d8~ d16 b c8~ c16 b c8~ c16 b8. }
+>>
+@end lilypond
 
 
-@lilypond[quote,verbatim,fragment]
-\new Staff \relative c' {
-  c16 d e f
-  <<
-    { g4 f e | d2 e2 } \\
-    { r8 e4 d c8 ~ | c b16 a b8 g ~ g2 } \\
-    { s2. | s4 b4 c2 }
-  >>
-}
+@noindent
+Vous constaterez que les voix sont créées  explicitement et qu'elles
+sont nommées.  Les commandes @code{\voiceOne} @dots{} @code{\voiceFour}
+déterminent les voix de telle sorte que les première et troisième
+auront des hampes vers le haut, et les deuxième et quatrième vers le
+bas.  D'utre prt, les notes des troisièmre et quatrième voix seront
+quelque peu décalées, tout comme leurs silences, afin d'éviter les
+collisions.  La commande @code{\oneVoice} permet de retrouver les
+réglages par défaut.
+
+@strong{@i{Polyphonie temporaire}}
+
+Un fragement temporairement polyphonique se construit de la manière
+suivante :
+
+@example
+<< @{ \voiceOne ... @}
+  \new Voice @{ \voiceTwo ... @}
+>> \oneVoice
+@end example
+
+@noindent
+En fait, la première expression d'une polyphonie temporaire reste dans
+le même contexte @code{Voice} que celui existant auparavant et qui
+perdurera àprès ce fragment.  Les autres expressions entre doubles
+chevrons seront assignées à des voix temporaires distinctes.  C'est la
+raison pour laquelle les paroles qui suivaient la voix avant la
+polyphonie continueront à le faire durant ce passage polyphonique et
+après lui.
+
+@lilypond[quote, verbatim, relative=2]
+<<
+  \new Voice = "melody" {
+    a4
+    <<
+      {
+        \voiceOne
+        g f
+      }
+      \new Voice {
+        \voiceTwo
+        d2
+      }
+    >>
+    \oneVoice
+    e4
+  }
+  \new Lyrics \lyricsto "melody" {
+  This is my song.
+  }
+>>
 @end lilypond
 
 @end lilypond
 
-Le séparateur permet aux contextes @rinternals{Voice}@footnote{Ces
-voix polyphoniques sont parfois appelées @qq{couches} ou @qq{calques} dans
-d'autres logiciels de notation.}
+@noindent
+Vous remarquerez que les commandes @code{\voiceOne} et @code{\voiceTwo}
+permettent d'obtenir des réglages différents pour chacune des voix.
+
+@strong{@i{La construction avec un double antislash}}
+
 @cindex couches
 @cindex calques
 @cindex couches
 @cindex calques
-d'être identifiés.  Les contextes de voix portent les noms @code{"1"},
-@code{"2"}, etc.  Dans chacun de ces contextes, la direction verticale
-des liaisons, hampes, etc. est réglée de manière appropriée.
-
-Ces voix sont toutes distinctes de la voix qui contient les notes en
-dehors de la construction @code{<< \\ >>}.  On doit le prendre en compte
-lorsqu'on fait des changements au niveau des voix.  Cela veut aussi dire
-que les liaisons de prolongation et d'articulation ne peuvent ni entrer
-ni sortir de la construction @code{<< \\ >>}.  À l'inverse, des voix
-parallèles venant de constructions @code{<< \\ >>} séparées sur la même
-portée sont dans les mêmes voix.  Voici le même exemple, avec des
-couleurs et têtes de note différentes pour chaque voix.  Notez que le
-changement de style de tête de note n'affecte pas l'intérieur des
-constructions @code{<< \\ >>}.  Aussi, le changement à la deuxième voix
-dans la première construction @code{<< \\ >>} l'affecte aussi dans la
-deuxième construction @code{<< \\ >>}, et la voix est liée entre les
-deux constructions.
 
 
+@funindex \\
+
+Une construction de la forme @code{<< @{...@} \\ @{...@} >>}, dans
+laquelle plusieurs expressions sont séparées par des doubles obliques
+inversées, se comporte différemment de celle sans séparateurs :
+@strong{tous} les membres de cette contruction seront assignés à de
+nouveaux contextes de voix.  Ces contextes de voix, créés implicitement,
+portent les noms @code{"1"}, @code{"2"}, etc.  Dans chacun de ces
+contextes, la direction verticale des liaisons, hampes, etc. est réglée
+de manière appropriée. En voici un exemple :
+
+@lilypond[quote,relative=3,verbatim]
+<<
+  { r8 r16 g e8. f16 g8[ c,] f e16 d }
+  \\
+  { d16 c d8~ d16 b c8~ c16 b c8~ c16 b8. }
+>>
+@end lilypond
+
+Cette syntaxe peut être utilisée dans la mesure où la création puis la
+disparition de voix temporaires sont sans conséquence.  Les réglages de
+ces voix créées implicitement sont les même que si elles avaient été
+créées à l'aide des commandes @code{\voiceOne} à @code{\voiceFour}, dans
+leur ordre d'apparition. 
+
+Dans l'exemple qui suit, la voix intermédiaire à des hampes vers le
+haut.   Nous la plaçons donc en troisième position, de telle sorte
+qu'elle adopte les réglages de @code{\voiceThree} qui correspondent à ce
+que nous voulons.  Grâce à des espaces invisibles, nous évitons de
+surcharger la portée avec des demis soupirs.
+
+@lilypond[quote,relative=3,verbatim]
+<<
+  { r8 g g  g g f16 ees f8 d }
+  \\
+  { ees,8 r ees r d r d r }
+  \\
+  { d'8 s c s bes s a s }
+>>
+@end lilypond
+
+En dehors des cas les plus simples, nous vous invitons à toujours créer
+les contextes de voix de manière explicite.  Voir à ce sujet
+@rlearning{Contextes et graveurs} et 
+@rlearning{Instanciation explicite des voix}.
+
+@strong{@i{Identité rythmique}}
+
+Lorsque l'on doît saisir des fragments de musique parallèle qui ont le
+même rythme, on peut les combiner dans un contexte de voix unique et par
+voie de conséquence former des accords.  Il suffit pour cela de les
+regrouper dans une construction de musique simultanée simple au sein
+d'une voix explicite :
+
+@lilypond[quote,relative=2,verbatim]
+\new Voice <<
+  { e4 f8 d e16 f g8 d4 }
+  { c4 d8 b c16 d e8 b4 }
+>>
+@end lilypond
+
+Prenez garde que les différents éléments doivent impérativement avoir la
+même structure rythmique, sous peine de ligature aléatoire et de
+messages d'avertissement.
+
+
+@predefined
+@code{\voiceOne},
+@code{\voiceTwo},
+@code{\voiceThree},
+@code{\voiceFour},
+@code{\oneVoice}.
+@endpredefined
+
+
+@seealso
+Manuel d'initiation :
+@rlearning{Les voix contiennent la musique},
+@rlearning{Instanciation explicite des voix}.
+
+Manuel de notation :
+@ref{Portées de percussion},
+@ref{Silences invisibles},
+@ref{Hampes}.
+
+Morceaux choisis :
+@rlsr{Simultaneous notes}.
+
+
+@node Styles de voix
+@unnumberedsubsubsec Styles de voix
+@translationof Voice styles
+
+@cindex voix, styles
+@cindex styles de voix
+@cindex colorier des voix
 @cindex têtes de note, styles
 
 @cindex têtes de note, styles
 
-@lilypond[quote,verbatim,fragment]
-\new Staff \relative c' {
-  \override NoteHead #'style = #'cross
-  \override NoteHead #'color = #red
-  c16 d e f
-  <<
-    { g4 f e } \\
-    { \override NoteHead #'style = #'triangle
-      \override NoteHead #'color = #blue
-    r8 e4 d c8 ~ }
-  >> |
-  <<
-    { d2 e2 } \\
-    { c8 b16 a b8 g ~ g2 } \\
-    { \override NoteHead #'style = #'slash 
-      \override NoteHead #'color = #green
-      s4 b4 c2 }
-  >>
-}
+@funindex \voiceOneStyle
+@funindex \voiceTwoStyle
+@funindex \voiceThreeStyle
+@funindex \voiceFourStyle
+@funindex \voiceNeutralStyle
+
+Opter pour des couleurs et des têtes de notes spécifiques selon la voix
+permet de les identifier plus facliement :
+
+@lilypond[quote,relative=2,verbatim]
+<<
+  { \voiceOneStyle d4 c2 b4 }
+  \\
+  { \voiceTwoStyle e,2 e }
+  \\
+  { \voiceThreeStyle b2. c4 }
+  \\
+  { \voiceFourStyle g'2 g }
+>>
 @end lilypond
 
 @end lilypond
 
-La polyphonie ne change pas la relation des notes dans un bloc
-@code{\relative @{ @}}.  Chaque note est calculée en fonction de la note
-qui la précède immédiatement, sans tenir compte des différentes voix.
+La commande @code{\voiceNeutralStyle} permet de revenir à la
+présentation normale.
 
 
-@example
-\relative @{ noteA << noteB \\ noteC >> noteD @}
-@end example
 
 
-@code{noteC} est calculé relativement à @code{noteB}, non pas à
-@code{noteA} ; @code{noteD} est calculé relativement à @code{noteC}, non
-pas à @code{noteB} ou @code{noteA}.
+@predefined
+@code{\voiceOneStyle},
+@code{\voiceTwoStyle},
+@code{\voiceThreeStyle},
+@code{\voiceFourStyle},
+@code{\voiceNeutralStyle}.
+@endpredefined
+
+
+@seealso
+Manuel d'initiation :
+@rlearning{J'entends des Voix},
+@ref{Autres sources d'information}.
+
+Morceaux choisis :
+@rlsr{Simultaneous notes}.
 
 
 @node Résolution des collisions
 @unnumberedsubsubsec Résolution des collisions
 @translationof Collision resolution
 
 
 
 @node Résolution des collisions
 @unnumberedsubsubsec Résolution des collisions
 @translationof Collision resolution
 
-D'ordinaire, les têtes de notes pointées et non-pointées ne sont pas
-fusionnées, mais lorsque la propriété @code{merge-differently-dotted} de
-l'objet @rinternals{NoteCollision} est définie, elles se trouvent
-fusionnées :
-
-@lilypond[quote,verbatim,fragment,ragged-right,relative=2]
-\new Voice << {
-  g8 g8
-  \override Staff.NoteCollision
-    #'merge-differently-dotted = ##t
-  g8 g8
-} \\ { g8.[ f16] g8.[ f16] } >>
+@cindex fusion de notes
+@cindex collision de notes
+@cindex collisions
+@cindex shift note
+@cindex multiples voix
+@cindex voix multiples
+@cindex polyphonie
+@cindex décélage de voix
+@cindex voix, décalage
+@cindex silences, décalage automatique
+
+@funindex \shiftOn
+@funindex shiftOn
+@funindex \shiftOnn
+@funindex shiftOnn
+@funindex \shiftOnnn
+@funindex shiftOnnn
+@funindex \shiftOff
+@funindex shiftOff
+@funindex \mergeDifferentlyDottedOn
+@funindex mergeDifferentlyDottedOn
+@funindex \mergeDifferentlyDottedOff
+@funindex mergeDifferentlyDottedOff
+@funindex \mergeDifferentlyHeadedOn
+@funindex mergeDifferentlyHeadedOn
+@funindex \mergeDifferentlyHeadedOff
+@funindex mergeDifferentlyHeadedOff
+
+
+Les notes de hauteur identique appartenant à des voix différentes, même
+si leur hampe sont opposées, verront leur tête automatiquement
+fusionnées.  Les notes dont la tête diffère ou bien qui ont la hampe dans
+la même direction ne seront pas automatiquement fusionnées.  Les
+silences, lorsqu'ils sont dans une autre voix et à l'opposé des
+hampes seront décalés verticalement.
+
+@lilypond[quote,verbatim,relative=2]
+<<
+  {
+    c8 d e d c d c4
+    g'2 fis
+  } \\ {
+    c2 c8. b16 c4
+    e,2 r
+  } \\ {
+    \oneVoice
+    s1
+    e8 a b c d2
+  }
+>>
 @end lilypond
 
 @end lilypond
 
-De même, vous pouvez fusionner une tête de blanche avec une tête de
-croche, en définissant @code{merge-differently-headed}
+Cependant, vous pouvez fusionner une tête de blanche avec une tête de
+croche :
 
 
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-\new Voice << {
-  c8 c4.
-  \override Staff.NoteCollision
-    #'merge-differently-headed = ##t
-c8 c4. } \\ { c2 c2 } >>
+@lilypond[quote,verbatim,relative=2]
+<<
+  {
+    \mergeDifferentlyHeadedOn
+    c8 d e d c d c4
+    g'2 fis
+  } \\ {
+    c2 c8. b16 c4
+    e,2 r
+  } \\ {
+    \oneVoice
+    s1
+    e8 a b c d2
+  }
+>>
 @end lilypond
 
 @end lilypond
 
-LilyPond décale aussi verticalement les silences à l'opposé des hampes,
-par exemple
+De même, vous pouvez fusionner les têtes de notes pointées et
+non-pointées : 
 
 
-@lilypond[quote,ragged-right,fragment,verbatim]
-\new Voice << c''4 \\ r4 >>
+@lilypond[quote,relative=2,verbatim]
+<<
+  {
+    \mergeDifferentlyHeadedOn
+    \mergeDifferentlyDottedOn
+    c8 d e d c d c4
+    g'2 fis
+  } \\ {
+    c2 c8. b16 c4
+    e,2 r
+  } \\ {
+    \oneVoice
+    s1
+    e8 a b c d2
+  }
+>>
 @end lilypond
 
 @end lilypond
 
+
+
+
 Lorsque trois notes ou plus s'agglutinent dans un même empilement,
 Lorsque trois notes ou plus s'agglutinent dans un même empilement,
-@code{merge-differently-headed} ne peut mener à bien la fusion des deux
+@code{\mergeDifferentlyHeadedOn} ne peut mener à bien la fusion des deux
 notes qui devraient l'être.  Pour obtenir une fusion optimale, appliquez
 notes qui devraient l'être.  Pour obtenir une fusion optimale, appliquez
-un décalage (@code{\shift}) à la note qui ne devrait pas s'empiler.
-Dans la première mesure de l'exemple suivant,
-@code{merge-differently-headed} ne fonctionne pas --- la tête de la
-blanche est noire.  Dans la seconde mesure, @code{\shiftOn} s'applique
-pour sortir le sol (@code{g}) de l'alignement, et
-@code{merge-differently-headed} fonctionne correctement.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\override Staff.NoteCollision #'merge-differently-headed = ##t
-<<
-  { d=''2 g2 } \\
-  { \oneVoice d=''8 c8 r4 e,8 c'8 r4 } \\
-  { \voiceFour e,,2 e'2}
->>
+un décalage (@code{\shift}) à la note qui ne devrait pas fusionner.
+Ici, on applique un @code{\shiftOn} pour décaler le @notation{sol} de
+l'empilement ; le rendement de @code{\mergeDifferentlyHeadedOn} est
+alors comme il faut.
+
+@lilypond[quote,relative=2,verbatim]
 <<
 <<
-  { d'=''2 \shiftOn g2 } \\ 
-  { \oneVoice d=''8 c8 r4 e,8 c'8 r4 } \\
-  { \voiceFour e,,2 e'2}
+  {
+    \mergeDifferentlyHeadedOn
+    \mergeDifferentlyDottedOn
+    c8 d e d c d c4
+    \shiftOn
+    g'2 fis
+  } \\ {
+    c2 c8. b16 c4
+    e,2 r
+  } \\ {
+    \oneVoice
+    s1
+    e8 a b c d2
+  }
+
 >>
 @end lilypond
 
 >>
 @end lilypond
 
+Les commandes @code{\shiftOn}, @code{\shiftOnn}, et @code{\shiftOnnn}
+déterminent le niveau de décalage des accords de la voix en cours.  
+Les voix externes -- habituellement, les voix une et deux -- ont
+@code{\shiftOff}, alors que les voix internes -- trois et quatre -- ont
+@code{\shiftOn}.  @code{\shiftOnn} et @code{\shiftOnnn} sont des niveaux
+supplémentaires de décalage. 
+
+
+Les têtes de notes ne seront fusionnées que dans la mesure où leur
+hampe sont opposées.
+
 
 @predefined
 
 @predefined
-@funindex \oneVoice
-@code{\oneVoice},
-@funindex \voiceOne
-@code{\voiceOne},
-@funindex \voiceTwo
-@code{\voiceTwo},
-@funindex \voiceThree
-@code{\voiceThree},
-@funindex \voiceFour
-@code{\voiceFour}.
+@code{\mergeDifferentlyDottedOn},
+@code{\mergeDifferentlyDottedOff},
+@code{\mergeDifferentlyHeadedOn},
+@code{\mergeDifferentlyHeadedOff}.
 
 
-@funindex \shiftOn
 @code{\shiftOn},
 @code{\shiftOn},
-@funindex \shiftOnn
 @code{\shiftOnn},
 @code{\shiftOnn},
-@funindex \shiftOnnn
 @code{\shiftOnnn},
 @code{\shiftOnnn},
-@funindex \shiftOff
-@code{\shiftOff} : toutes ces commandes précisent le degré de décalage
-des notes de la voix courante.  Les voix externes --- habituellement,
-les voix une et deux --- ont @code{\shiftOff}, alors que les voix
-internes --- trois et quatre --- ont @code{\shiftOn}.  @code{\shiftOnn}
-et @code{\shiftOnnn} sont des niveaux supplémentaires de décalage.
+@code{\shiftOff}.
 @endpredefined
 
 
 @endpredefined
 
 
-Quand LilyPond est dépassé, la propriété @code{force-hshift} de l'objet
-@rinternals{NoteColumn}, et des silences à hauteur déterminée, peuvent
-s'avérer utiles pour dicter au programme les choix de placement.
-
-@lilypond[quote,verbatim,ragged-right]
-\relative <<
-{
-  <d g>
-  <d g>
-} \\ {
-  <b f'>
-  \once \override NoteColumn #'force-hshift = #1.7
-  <b f'>
-} >>
-@end lilypond
+@snippets
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{additional-voices-to-avoid-collisions.ly}
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{forcing-horizontal-shift-of-notes.ly}
 
 
 @seealso
 
 
 @seealso
-Référence du programme : les objets appropriés pour résoudre les
-collisions sont @rinternals{NoteCollision} et
+Glossaire musicologique :
+@rglos{polyphony}.
+
+Manuel d'initiation :
+@rlearning{Multiple notes at once},
+@rlearning{Voices contain music},
+@rlearning{Collisions of objects}.
+
+Morceaux choisis :
+@rlsr{Simultaneous notes}.
+
+Référence des propriétés internes :
+@rinternals{NoteColumn},
+@rinternals{NoteCollision},
 @rinternals{RestCollision}.
 
 
 @knownissues
 
 @rinternals{RestCollision}.
 
 
 @knownissues
 
-Quand @code{merge-differently-headed} est utilisé avec une croche ou
-une valeur plus courte à hampe vers le haut, et une blanche hampe vers
-le bas, la croche se retrouve à la mauvaise place.
+@ignore
+@c TODO investigate! Sometimes it works, sometimes not. --FV
+The requirements for successfully merging different note heads that
+are at the same time differently dotted are not clear.
+@end ignore
 
 Il n'y a aucune prise en charge des agrégats dans lesquels une même note
 apparaît avec différentes altérations.  Il est conseillé d'avoir recours
 
 Il n'y a aucune prise en charge des agrégats dans lesquels une même note
 apparaît avec différentes altérations.  Il est conseillé d'avoir recours
@@ -309,8 +614,14 @@ voir @ref{Clusters}.
 @node Regroupement automatique de parties
 @unnumberedsubsubsec Regroupement automatique de parties
 @translationof Automatic part combining
 @node Regroupement automatique de parties
 @unnumberedsubsubsec Regroupement automatique de parties
 @translationof Automatic part combining
+
 @cindex regroupement automatique de parties
 @cindex parties, combiner des
 @cindex regroupement automatique de parties
 @cindex parties, combiner des
+@cindex a due
+@cindex solo
+
+@funindex \partcombine
+@funindex partcombine
 
 Le regroupement automatique de parties vous permet de fusionner deux
 pupitres sur une seule portée, ceci dans le but de créer des
 
 Le regroupement automatique de parties vous permet de fusionner deux
 pupitres sur une seule portée, ceci dans le but de créer des
@@ -323,77 +634,94 @@ ressortir les solos et parties @emph{a due}.
 Voici la syntaxe qui permet de combiner des parties :
 
 @example
 Voici la syntaxe qui permet de combiner des parties :
 
 @example
-\partcombine @var{musicexpr1} @var{musicexpr2}
+\partcombine @var{expression_musicale_1} @var{expression_musicale_2}
 @end example
 
 @end example
 
-
 L'exemple suivant illustre les fonctionnalités élémentaires du
 combinateur de parties : positionner les parties sur une portée, gérer
 L'exemple suivant illustre les fonctionnalités élémentaires du
 combinateur de parties : positionner les parties sur une portée, gérer
-la direction des hampes et de la polyphonie.
-
-@lilypond[quote,verbatim,ragged-right,fragment]
-\new Staff \partcombine
-  \relative g' { g g a( b) c c r r }
-  \relative g' { g g r4 r e e g g }
-@end lilypond
-
-Le premier @code{sol} n'apparaît qu'une seule fois, alors qu'il a été
-spécifié deux fois (une fois dans chacune des parties).  La direction
-des hampes et des liaisons de tenue ou de phrasé est gérée
-automatiquement, selon qu'il s'agisse d'un solo ou d'un unisson.  La
-première partie, dont le contexte s'appellera @code{one}, aura toujours
-ses hampes dirigées vers le haut et sera notée @q{Solo}, alors que la
-deuxième, appelée @code{two}, aura des hampes vers le bas et sera
-notée @q{Solo@tie{}II}.
-
-Si votre intention n'est que de fusionner les parties, sans ajouter de
-texte, assignez faux à la propriété @code{printPartCombineTexts}.
+la direction des hampes et de la polyphonie. Les identificateurs sont
+les mêmes pour la combinaison que pour les parties séparées.
 
 
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
-\new Staff <<
-  \set Staff.printPartCombineTexts = ##f
-  \partcombine
-    \relative g' { g a( b) r }
-    \relative g' { g r4 r f }
->>
-@end lilypond
+@lilypond[quote,verbatim]
+instrumentOne = \relative c' {
+  c4 d e f
+  R1
+  d'4 c b a
+  b4 g2 f4
+  e1
+}
 
 
-Le texte imprimé pour les sections solo ou à l'unisson se règle par
-les propriétés @code{soloText}, @code{soloIIText}, et @code{aDueText}. 
+instrumentTwo = \relative g' {
+  R1
+  g4 a b c
+  d c b a
+  g f( e) d
+  e1
+}
 
 
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
-\new Staff <<
-  \set Score.soloText = #"ichi"
-  \set Score.soloIIText = #"ni"
-  \set Score.aDueText = #"tachi"
-  \partcombine
-    \relative g' { g4 g a( b) r }
-    \relative g' { g4 g r r f }
+<<
+  \new Staff \instrumentOne
+  \new Staff \instrumentTwo
+  \new Staff \partcombine \instrumentOne \instrumentTwo
 >>
 @end lilypond
 
 >>
 @end lilypond
 
-LilyPond interprète dans un contexte @rinternals{Voice} les
-arguments fournis à @code{\partcombine}.  Si vous travaillez avec des
-octaves relatives, spécifiez @code{\relative} dans chacune des
-expressions musicales, comme ceci :
+Les notes de la troisième mesure n'apparaîssent qu'une seule fois,
+alors qu'elles ont été spécifiés deux fois (une fois dans chacune des
+parties).  La direction des hampes et des liaisons de tenue ou de phrasé
+est gérée automatiquement, selon qu'il s'agisse d'un solo ou d'un
+unisson.  La première partie, dont le contexte s'appellera @code{one},
+aura toujours ses hampes dirigées vers le haut et sera notée @qq{Solo},
+alors que la deuxième, appelée @code{two}, aura des hampes vers le bas
+et sera notée @qq{Solo@tie{}II}.  Les parties à l'unisson seront
+estampillées d'un @qq{a2} par défaut.
+
+LilyPond interprète dans un contexte @code{Voice} les arguments fournis
+à @code{\partcombine}.  Si vous travaillez avec des octaves relatives,
+spécifiez @code{\relative} dans chacune des expressions musicales, comme
+ceci : 
 
 @example
 \partcombine
 
 @example
 \partcombine
-  \relative @dots{} @var{musicexpr1}
-  \relative @dots{} @var{musicexpr2}
+  \relative @dots{} @var{expression_musicale_1}
+  \relative @dots{} @var{expression_musicale_2}
 @end example
 
 @noindent
 @end example
 
 @noindent
-Une section @code{\relative} en dehors de @code{\partcombine} sera
-sans effet sur les hauteurs de @var{musicexpr1} et @var{musicexpr2}.
+Une section @code{\relative} à l'extérieur du @code{\partcombine} restera
+sans effet sur les hauteurs de @var{expression_musicale_1} ou de 
+@var{expression_musicale_2}.
+
+
+@snippets
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{combining-two-parts-on-the-same-staff.ly}
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{changing-partcombine-texts.ly}
 
 
 @seealso
 
 
 @seealso
-Référence du programme : @rinternals{PartCombineMusic}.
+Glossaire musicologique :
+@rglos{a due},
+@rglos{part}.
+
+Manuel de notation :
+@ref{Écriture de parties séparées}.
+
+Morceaux choisis :
+@rlsr{Simultaneous notes}.
+
+Référence des propriétés internes :
+@rinternals{PartCombineMusic},
+@rinternals{Voice}.
 
 
 @knownissues
 
 
 
 @knownissues
 
+@code{\partcombine} ne prend en charge que deux voix.
+
 Lorsque @code{printPartCombineTexts} est actif et que les deux voix
 jouent souvent les mêmes notes, le combinateur peut afficher @code{a2}
 plus d'une fois par mesure.
 Lorsque @code{printPartCombineTexts} est actif et que les deux voix
 jouent souvent les mêmes notes, le combinateur peut afficher @code{a2}
 plus d'une fois par mesure.
@@ -406,7 +734,14 @@ En interne, @code{\partcombine} interprète les deux arguments en tant
 que @code{Voice}s, dénommées @code{one} et @code{two}, puis décide de
 quand les parties seront fusionnées.  Par conséquent, si les arguments
 changent pour d'autres noms de contexte @rinternals{Voice}, les
 que @code{Voice}s, dénommées @code{one} et @code{two}, puis décide de
 quand les parties seront fusionnées.  Par conséquent, si les arguments
 changent pour d'autres noms de contexte @rinternals{Voice}, les
-événements qu'ils contiendraient seront ignorés. 
+événements qu'ils contiendraient seront ignorés.  De la même manière, le
+combinateur n'est pas conçu pour travailler avec des paroles ; il
+s'arrête dès qu'il est explicitement fait appel à l'une des voix pour y
+attacher des paroles.  
+
+@code{\partcombine} n'examine que l'attaque des notes.  Il n'est donc
+pas en mesure de déterminer si une note attaquée précédemment est enore
+jouée ou non, ce qui peut engendrer quelques problèmes.
 
 
 @node Saisie de musique en parallèle
 
 
 @node Saisie de musique en parallèle
@@ -417,61 +752,113 @@ changent pour d'autres noms de contexte @rinternals{Voice}, les
 @cindex musique en parallèle
 @cindex musique entremêlée
 
 @cindex musique en parallèle
 @cindex musique entremêlée
 
-On peut écrire plusieurs voix de façon entremêlée :
+@funindex \parallelMusic
+@funindex parallelMusic
+
+On peut écrire plusieurs voix de façon entremêlée.  La fonction
+@code{\parallelMusic} prend en charge une liste des variables à créer,
+ainsi qu'une expression musicale.  Le contenu des différentes mesures de
+l'expression musicale deviennent les valeurs des variables respectives
+que vous pourrez ensuite utiliser pour imprimer la partition.
+
+@warning{Les contrôles de barre de mesure @code{|} sont obligatoires et
+le mesures doivent être de longueur identique.}
+
+@lilypond[quote,verbatim]
+\parallelMusic #'(voiceA voiceB voiceC) {
+  % Bar 1
+  r8 g'16 c'' e'' g' c'' e'' r8 g'16 c'' e'' g' c'' e'' |
+  r16 e'8.~   e'4            r16 e'8.~   e'4            |
+  c'2                        c'2                        |
+
+  % Bar 2
+  r8 a'16 d'' f'' a' d'' f'' r8 a'16 d'' f'' a' d'' f'' |
+  r16 d'8.~   d'4            r16 d'8.~   d'4            |
+  c'2                        c'2                        |
 
 
-@lilypond[quote,fragment,verbatim]
-\parallelMusic #'(voiceA voiceB) {
-  r8     g'16[ c''] e''[ g' c'' e''] r8     g'16[ c''] e''[ g' c'' e''] |
-  c'2                                c'2                                |
-  r8     a'16[ d''] f''[ a' d'' f''] r8     a'16[ d''] f''[ a' d'' f''] |
-  c'2                                c'2                                |
 }
 \new StaffGroup <<
 }
 \new StaffGroup <<
-  \new Staff \new Voice \voiceA
-  \new Staff \new Voice \voiceB
+  \new Staff << \voiceA \\ \voiceB >>
+  \new Staff { \clef bass \voiceC }
 >>
 @end lilypond
 
 >>
 @end lilypond
 
-Ceci fonctionne bien avec la musique pour piano :
+Vous pouvez travailler en mode relatif.  Notez cependant que la commande
+@code{\relative} n'apparaît pas au sein du bloc @code{\parallelMusic}.
+Le calcul des hauteurs relatives s'effectue voix par voix, et non au fil
+des lignes saisies ; en d'autre termes, les notes de la @code{voiceA}
+ignorent tout de celles de la @code{voiceB}.
 
 @lilypond[quote,verbatim]
 
 @lilypond[quote,verbatim]
-music = {
-  \key c \major
-  \time 4/4
-  \parallelMusic #'(voiceA voiceB voiceC voiceD) {
-    % Bar 1
-    r8  g'16[ c''] e''[ g' c'' e''] r8  g'16[ c''] e''[ g' c''
-e''] |
-    c'2                                 c'2 |
-    r8  a16[ d'] f'[ a d' f']       r8  a16[ d'] f'[ a d' f'] |
-    c2                                  c2 |
-
-    % Bar 2
-    a'8 b'      c'' d''    e'' f''    g'' a'' |
-    d'4         d'         d'         d' |
-    c16 d e f   d e f g    e f g a    f g a b |
-    a,4         a,4        a,4        a,4 |
-
-    % Bar 3 ...
-  }
+\parallelMusic #'(voiceA voiceB voiceC) {
+  % Bar 1
+  r8 g16 c e g, c e r8 g,16 c e g, c e  |
+  r16 e8.~ e4       r16 e8.~  e4        |
+  c2                c                   |
+
+  % Bar 2
+  r8 a,16 d f a, d f r8 a,16 d f a, d f |
+  r16 d8.~  d4       r16 d8.~  d4       |
+  c2                 c                  |
+
+ }
+\new StaffGroup <<
+  \new Staff << \relative c'' \voiceA \\ \relative c' \voiceB >>
+  \new Staff \relative c' { \clef bass \voiceC }
+>>
+@end lilypond
+
+Ceci fonctionne bien avec la musique pour piano.  L'exemple suivant
+affecte quatre mesures à quatre variables :
+
+@lilypond[quote,verbatim]
+global = {
+  \key g \major
+  \time 2/4
+}
+
+\parallelMusic #'(voiceA voiceB voiceC voiceD) {
+  % Bar 1
+  a8    b     c   d     |
+  d4          e         |
+  c16 d e fis d e fis g |
+  a4          a         |
+
+  % Bar 2
+  e8      fis  g     a   |
+  fis4         g         |
+  e16 fis g  a fis g a b |
+  a4           a         |
+
+  % Bar 3 ...
 }
 
 \score {
   \new PianoStaff <<
 }
 
 \score {
   \new PianoStaff <<
-    \music
-    \new Staff <<
-      \voiceA \\
-      \voiceB
-    >>
-    \new Staff {
-      \clef bass
-      <<
-        \voiceC \\
-        \voiceD
-      >>
-    }
+     \new Staff {
+       \global
+       <<
+         \relative c'' \voiceA
+         \\
+         \relative c'  \voiceB
+       >>
+     }
+     \new Staff {
+       \global \clef bass
+       <<
+         \relative c \voiceC
+         \\
+         \relative c \voiceD
+       >>
+     }
   >>
 }
 @end lilypond
 
 
   >>
 }
 @end lilypond
 
 
+@seealso
+Manuel d'initiation :
+@rlearning{Organisation du code source avec des variables}.
+
+Morceaux choisis :
+@rlsr{Simultaneous notes}.