]> git.donarmstrong.com Git - lilypond.git/commitdiff
Doc-fr: notation-simultaneous
authorJean-Charles Malahieude <lolyfan@wanadoo.fr>
Sun, 16 Aug 2009 19:12:06 +0000 (21:12 +0200)
committerJean-Charles Malahieude <lolyfan@wanadoo.fr>
Sun, 16 Aug 2009 19:12:06 +0000 (21:12 +0200)
* simultaneous.itely: complete review
* associated texidocs

Documentation/fr/notation/simultaneous.itely
Documentation/fr/texidocs/additional-voices-to-avoid-collisions.texidoc [new file with mode: 0644]
Documentation/fr/texidocs/changing-partcombine-texts.texidoc [new file with mode: 0644]
Documentation/fr/texidocs/combining-two-parts-on-the-same-staff.texidoc [new file with mode: 0644]
Documentation/fr/texidocs/forcing-horizontal-shift-of-notes.texidoc [new file with mode: 0644]

index eac626a57df6f77b7155199d26196c537d65224c..9c3b13192e8b9693f4808544a4b0d92b9e0e1a50 100644 (file)
@@ -1,6 +1,6 @@
-@c -*- coding: utf-8; mode: texinfo; -*-
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @ignore
-    Translation of GIT committish: 33ba8d40c3493011a4b39ab8b1369701f8013bd6
+    Translation of GIT committish: c39256c433c9e0d80429fb768cde5834541524f8
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
@@ -8,7 +8,7 @@
 
 @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
@@ -34,6 +34,7 @@ portée.
 
 @menu
 * Notes en accords::                      
+* Expressions simultanées::                      
 * Clusters::                    
 @end menu
 
@@ -42,16 +43,82 @@ portée.
 @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.
 
-@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 :
+@rlearning{Combinaison de 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
 
-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
@@ -60,32 +127,48 @@ Pour plus d'information à propos des accords, voir @ref{Notation des accords}.
 
 @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
-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
-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 
-@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
@@ -93,211 +176,432 @@ seront pas imprimées de façon acceptable.  utilisez plutôt
 @translationof Multiple voices
 
 @menu
-* Polyphonie basique::             
+* Polyphonie sur une portée::             
+* Style de voix::             
 * 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
-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ères et troisièmes
+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
 
-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
-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 porter 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
 
-@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
 
-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},
+@rlearning{Autres sources d'information}.
+
+Morceaux choisis :
+@rlsr{Simultaneous notes}.
 
 
 @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
 
-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
 
-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
 
+
+
+
 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
-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
 
+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
-@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},
-@funindex \shiftOnn
 @code{\shiftOnn},
-@funindex \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
 
 
-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
-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
 
-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
@@ -309,8 +613,14 @@ voir @ref{Clusters}.
 @node Regroupement automatique de parties
 @unnumberedsubsubsec Regroupement automatique de parties
 @translationof Automatic part combining
+
 @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
@@ -323,77 +633,92 @@ ressortir les solos et parties @emph{a due}.
 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
 
-
 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
 
-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
-  \relative @dots{} @var{musicexpr1}
-  \relative @dots{} @var{musicexpr2}
+  \relative @dots{} @var{expression_musicale_1}
+  \relative @dots{} @var{expression_musicale_2}
 @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}.
+
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{combining-two-parts-on-the-same-staff.ly}
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{changing-partcombine-texts.ly}
 
 
 @seealso
-Référence du programme : @rinternals{PartCombineMusic}.
+Music Glossary:
+@rglos{a due},
+@rglos{part}.
+
+Notation Reference:
+@ref{Writing parts}.
+
+Snippets:
+@rlsr{Simultaneous notes}.
+
+Internals Reference:
+@rinternals{PartCombineMusic},
+@rinternals{Voice}.
 
 
 @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.
@@ -406,7 +731,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
-é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
@@ -417,61 +749,113 @@ changent pour d'autres noms de contexte @rinternals{Voice}, les
 @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 Staff \new Voice \voiceA
-  \new Staff \new Voice \voiceB
+  \new Staff << \voiceA \\ \voiceB >>
+  \new Staff { \clef bass \voiceC }
 >>
 @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]
-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 <<
-    \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
 
 
+@seealso
+Manuel d'initiation :
+@rlearning{Organisation du code source avec des variables}.
+
+Morceaux choisis :
+@rlsr{Simultaneous notes}.
diff --git a/Documentation/fr/texidocs/additional-voices-to-avoid-collisions.texidoc b/Documentation/fr/texidocs/additional-voices-to-avoid-collisions.texidoc
new file mode 100644 (file)
index 0000000..2b0aff2
--- /dev/null
@@ -0,0 +1,10 @@
+%% Translation of GIT committish: c39256c433c9e0d80429fb768cde5834541524f8
+  texidocfr = "
+Dans certains cas de musique polyphonie complexe, une voix
+supplémentaire peut permettre d'eviter les risques de collision.
+Lorsque quatre voix parallèles ne suffisent pas, la fonction Scheme
+@code{context-spec-music} permet d'ajouter des d'autres voix.
+
+"
+  doctitlefr = "Ajout de voix pour éviter les collisions"
+
diff --git a/Documentation/fr/texidocs/changing-partcombine-texts.texidoc b/Documentation/fr/texidocs/changing-partcombine-texts.texidoc
new file mode 100644 (file)
index 0000000..18f7ec5
--- /dev/null
@@ -0,0 +1,9 @@
+%% Translation of GIT committish: c39256c433c9e0d80429fb768cde5834541524f8
+  texidocfr = "
+Lorsque voue vou regroupez automatiquement des parties, vous pouvez
+modiffier le texte qui sera affiché pour les solos et pour les parties à
+l'unisson :
+
+"
+  doctitlefr = "Modification des indications de parties combinées"
+
diff --git a/Documentation/fr/texidocs/combining-two-parts-on-the-same-staff.texidoc b/Documentation/fr/texidocs/combining-two-parts-on-the-same-staff.texidoc
new file mode 100644 (file)
index 0000000..8db42e6
--- /dev/null
@@ -0,0 +1,20 @@
+%% Translation of GIT committish: c39256c433c9e0d80429fb768cde5834541524f8
+  texidocfr = "
+L'outil de combinaison de parties (la commande @code{\\partcombine})
+permet d'avoir deux parties différentes sur une même portée.  LilyPond
+ajoute automatiquement des indications textuelles, telles que @qq{solo}
+ou @qq{a2}.  Si votre intention n'est que de fusionner les parties, sans
+ajouter de texte, assignez faux à la propriété
+@code{printPartCombineTexts}.  Dans le cas de partitions vocales, et
+plus particulièrement d'hymnes, ces @qq{solo/a2} ne sont d'aucune
+utilité, aussi vuat-il mieux les désactiver.  Dans le cas où il y aurait
+alternance entre @emph{solo} et @emph{tutti}, il vaut mieux faire appel
+à de la musique polyphonique standard.
+
+Voici trois moyens d'imprimer deux parties sur un même portée : en
+polyphonie normale, avec @code{\\partcombine} sans indication
+supplémentaire, et avec @code{\\partcombine} commentée.
+
+"
+  doctitlefr = "Combinaison de deux parties sur une même portée"
+
diff --git a/Documentation/fr/texidocs/forcing-horizontal-shift-of-notes.texidoc b/Documentation/fr/texidocs/forcing-horizontal-shift-of-notes.texidoc
new file mode 100644 (file)
index 0000000..8277710
--- /dev/null
@@ -0,0 +1,10 @@
+%% Translation of GIT committish: c39256c433c9e0d80429fb768cde5834541524f8
+  texidocfr = "
+Quand LilyPond est dépassé, la propriété @code{force-hshift} de l'objet
+@code{NoteColumn}, et des silences à hauteur déterminée, peuvent
+s'avérer utiles pour dicter au programme les choix de placement.  On
+travaille ici en espace de portée.
+
+"
+  doctitlefr = "Cécalage horizontal forcé"
+