Subject: Documentation/fr updates

From: Jean-Charles <[email-masked]>
Date: Wed, 21 Feb 2007 21:56:29 +0100

Hi all!

I have run the script and done what had to be...

Please apply.

Jean-Charles
From c75d00779e8b10d7e591c719335ecac019c66b5f Mon Sep 17 00:00:00 2001
From: Jean-Charles <[email-masked]>
Date: Wed, 21 Feb 2007 21:36:01 +0100
Subject: [PATCH] French Documentation updates

---
 Documentation/fr/user/basic-notation.itely |  104 +++++++++++++++++++---------
 Documentation/fr/user/introduction.itely   |   14 ++--
 Documentation/fr/user/putting.itely        |   16 ++--
 Documentation/fr/user/templates.itely      |    6 +-
 Documentation/fr/user/working.itely        |    6 +-
 5 files changed, 93 insertions(+), 53 deletions(-)

diff --git a/Documentation/fr/user/basic-notation.itely b/Documentation/fr/user/basic-notation.itely
index bdd6014..1e545e2 100644
--- a/Documentation/fr/user/basic-notation.itely
+++ b/Documentation/fr/user/basic-notation.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: ac7d0e72b32b6a11470f598f2bee180b11402fe8
+    Translation of GIT committish: 0bf1e119501727ab8217767d8ce6c29dedf4fed1
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
@@ -20,7 +20,7 @@ De l'utilisation des fonctions de notation de base.
 @menu
 * Pitches::
 * Rhythms::
-* Multiple notes at once::
+* Polyphony::
 * Staff notation::
 * Connecting notes::
 * Expressive marks::
@@ -28,7 +28,6 @@ De l'utilisation des fonctions de notation de base.
 @end menu

-
 @node Pitches
 @section Pitches
 
@@ -39,7 +38,7 @@ De la manière de spécifier les hauteurs de notes.
 * Accidentals::
 * Cautionary accidentals::
 * Micro tones::
-* Notes names in other languages::
+* Note names in other languages::
 * Relative octaves::
 * Octave check::
 * Transpose::
@@ -76,8 +75,8 @@ c1
 @funindex ,
 
 L'octave précise peut être spécifiée sous forme d'une série
-d'apostrophes (`@code{'}') ou d'une série de virgules
-(`@code{,}').  Chaque @code{'} hausse la note d'une octave ; chaque
+d'apostrophes (`@samp{'}') ou d'une série de virgules
+(`@samp{,}').  Chaque @code{'} hausse la note d'une octave ; chaque
 @code{,} baisse la note d'une octave.
 
 @lilypond[quote,ragged-right,fragment,verbatim]
@@ -129,7 +128,7 @@ a4 aes a2
 LilyPond interprète l'entrée @code{d e f} comme @qq{imprimer un ré
 naturel, un mi naturel et un fa naturel} sans tenir compte de
 l'armure.  Pour plus d'information à propos de la distinction entre le
-contenu musical et sa représentation, voir @ref{More about pitches}.
+contenu musical et sa représentation, voir @ref{Accidentalas and key signatures}.
 
 @lilypond[fragment,quote,ragged-right,verbatim,relative]
 \key d \major
@@ -173,9 +172,9 @@ Référence du programme : @internalsref{LedgerLineSpanner},
 Normalement, les altérations sont imprimées automatiquement, mais il
 se peut que vous vouliez les imprimer manuellement.  On peut forcer
 l'impression d'une altération , dite @qq{de précaution}, en ajoutant un
-point d'exclamation `@code{!}' après la hauteur de note.  Une
+point d'exclamation `@samp{!}' après la hauteur de note.  Une
 altération entre parenthèses peut être obtenue en ajoutant un point
-d'interrogation `@code{?}' après la hauteur de note.  Ces signes
+d'interrogation `@samp{?}' après la hauteur de note.  Ces signes
 peuvent aussi être utilisés pour imprimer des bécarres.
 
 @lilypond[quote,ragged-right,fragment,verbatim,relative=1]
@@ -214,8 +213,8 @@ et demi (trois quarts de ton en-dessous), donc le symbole de LilyPond
 n'est conforme à aucun standard.

-@node Notes names in other languages
-@subsection Notes names in other languages
+@node Note names in other languages
+@subsection Note names in other languages
 
 Vous disposez de jeux prédéfinis de noms de notes pour plusieurs autres
 langues.  Pour les utiliser, incluez le fichier d'initialisation
@@ -519,7 +518,7 @@ Référence du programme : @internalsref{Rest}.
 @funindex s
 
 Un silence invisible (que l'on pourrait appeler un @qq{saut}) peut être
-entré comme une note avec le nom de note `@code{s}' ou avec
+entré comme une note avec le nom de note `@samp{s}' ou avec
 @code{\skip @var{duration}}
 
 @lilypond[fragment,quote,ragged-right,verbatim,relative=2]
@@ -640,7 +639,7 @@ précédente.  La valeur par défaut pour la première note est une noire
 @funindex .
 
 Pour obtenir des notes pointées, ajoutez simplement un point
-(`@code{.}') au chiffre.  Les notes doublement pointées sont créées de
+(@samp{.}) au chiffre.  Les notes doublement pointées sont créées de
 la même façon.
 
 @lilypond[quote,ragged-right,fragment,verbatim]
@@ -780,7 +779,7 @@ Exemples: @inputfileref{input/@/regression,tuplet@/-nest@/.ly}.
 @subsection Scaling durations
 
 Vous pouvez altérer la durée des notes en lui joignant une fraction
-@var{N/M}, donnant `@code{*}@var{N/M}' (or `@code{*}@var{N}' if
+@var{N/M}, donnant @q{@code{*}@var{N/M}} (ou @q{@code{*}@var{N}} si
 @var{M=1}).  Ceci n'affectera pas l'apparence des notes ou silences
 produits.
 
@@ -808,7 +807,7 @@ Dans ce manuel : @ref{Tuplets}
 @funindex |
 
 Les tests de mesure aident à détecter les erreurs dans les durées.  Un
-test de mesure s'écrit avec une barre verticale, `@code{|}'.  Lors du
+test de mesure s'écrit avec une barre verticale, @samp{|}.  Lors du
 traitement, elle devrait tomber sur une barre de mesure.  Sinon, un
 avertissement est émis.  Dans l'exemple suivant, le deuxième test de
 mesure signalera une erreur.
@@ -906,8 +905,8 @@ Exemples : @inputfileref{input/@/regression,completion@/-heads@/.ly}.
 Référence du programme : @internalsref{Completion_heads_engraver}.

-@node Multiple notes at once
-@section Multiple notes at once
+@node Polyphony
+@section Polyphony
 
 La notion musicale de polyphonie fait référence au fait d'avoir plus
 d'une voix simultanément dans une pièce.  Dans LilyPond, la notion de
@@ -993,8 +992,8 @@ en séparant les voix avec @code{\\}
 @end lilypond
 
 Le séparateur permet aux @internalsref{Voice} contexts@footnote{Ces
-voix polyphoniques sont parfois appelées "couches" dans d'autres
-logiciels de notation.
+voix polyphoniques sont parfois appelées @qq{couches ou calques} dans
+d'autres logiciels de notation.
 @cindex layers
 d'être identifiées.  Elles portent les noms @code{"1"}, @code{"2"},
 etc.  Dans chacun de ces contextes, la direction verticale des
@@ -1046,6 +1045,7 @@ différentes.
 @code{noteD} est calculé relativement à @code{noteC}, pas à @code{noteB} ou
 @code{noteA}.
 
+
 @node Explicitly instantiating voices
 @subsection Explicitly instantiating voices
 
@@ -1117,7 +1117,7 @@ La définition correcte des voix permet à la mélodie d'être liée.
      \oneVoice
    }
    \new Voice { \voiceThree
-     s2.  s4 b4 c2
+     s2. s4 b4 c2
      \oneVoice
    }
@@ -1151,6 +1151,21 @@ naturelle de taper la musique.
 }
 @end lilypond
 
+Dans certaines circonstances de polyphonie complexe, vous pourrez être
+amené à recourir à des voix supplémentaires afin d'éviter des
+collisions de notes.  Ces voix additionnelles s'ajoutent en
+définissant un identificateur, comme le montre l'exemple suivant :
+
+@lilypond[quote,verbatim,ragged-right,relative=2]
+voiceFive = #(context-spec-music (make-voice-props-set 4) 'Voice)
+
+\relative c''' <<
+  { \voiceOne g4 ~  \stemDown g32[ f( es d c b a b64 )g] } \\
+  { \voiceThree  b4} \\
+  { \voiceFive d,} \\
+  { \voiceTwo g,}
+>>
+@end lilypond
 
 @node Collision Resolution
 @subsection Collision Resolution
@@ -1158,7 +1173,7 @@ naturelle de taper la musique.
 D'ordinaire, les têtes de notes pointées et non-pointées ne sont pas
 fusionnées, mais lorsque la propriété d'objet
 @code{merge-differently-dotted} est définie dans l'objet
-@internalsref{NoteCollision}, elles se trouvent fusionnées.
+@internalsref{NoteCollision}, elles se trouvent fusionnées :
 
 @lilypond[quote,verbatim,fragment,ragged-right,relative=2]
 \new Voice << {
@@ -1180,13 +1195,37 @@ croche, en définissant
 c8 c4.  } \\ { c2 c2 } >>
 @end lilypond
 
-LilyPond combine aussi verticalement les silences à l'opposé des
+LilyPond empile aussi les silences à l'opposé des
 hampes, par exemple
 
 @lilypond[quote,ragged-right,fragment,verbatim]
 \new Voice << c''4 \\ r4 >>
 @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 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 ancrée).  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}
+>>
+<<
+  { d'=''2 \shiftOn g2 } \\ 
+  { \oneVoice d=''8 c8 r4 e,8 c'8 r4 } \\
+  { \voiceFour e,,2 e'2}
+>>
+@end lilypond
+
 
 @refcommands
 
@@ -1208,7 +1247,7 @@ hampes, par exemple
 @funindex \shiftOnnn
 @code{\shiftOnnn},
 @funindex \shiftOff
-@code{\shiftOff}: toutes ces commandes précisent quels accords de la
+@code{\shiftOff} : toutes ces commandes précisent quels accords de la
 voix courante doivent être combinés.  Les voix externes
 (habituellement, les voix un et deux) sont en @code{\shiftOff}, alors
 que les voix internes (trois et quatre) sont en @code{\shiftOn}.
@@ -1428,7 +1467,7 @@ spécifiées en modifiant directement cette propriété.
 Les nouveaux utilisateurs s'embrouillent souvent dans les altérations
 et les armures, car des notes naturelles prendront ou non un bécarre,
 selon l'armure.  Pour plus d'information, voir @ref{Accidentals} ou
-@ref{More about pitches}.
+@ref{Accidentals and key signatures}.
 
 @lilypond[quote,ragged-right,verbatim,relative=2,fragment]
 \key g \major
@@ -1930,7 +1969,7 @@ Une liaison de tenue (ou de prolongation) relie deux notes adjacentes
 de même hauteur.  Dans les faits, une liaison de tenue prolonge la
 durée d'une note, et ne doit donc pas être confondue avec les liaisons
 d'articulation ou de phrasé.  Une liaison de tenue est indiquée au
-moyen du symbole appelé tilde @code{~}.
+moyen du symbole appelé tilde @samp{~}.
 
 @lilypond[quote,ragged-right,fragment,verbatim]
 e' ~ e' <c' e' g'> ~ <c' e' g'>
@@ -2349,9 +2388,8 @@ c4 \grace c16 c4
 Contrairement à @code{\acciaccatura} ou @code{\appoggiatura}, la 
 commande @code{\grace} n'entame pas de liaison.
 
-
 La durée des petites notes est interprétée par le programme en
-fonction d'une deuxième commande  @code{\grace} indiquant la durée
+fonction d'une deuxième commande @code{\grace} indiquant la durée
 sous forme de deux nombres rationnels : le premier indique le rythme
 réel, le second indique le rythme des petites notes.  Reprenons
 l'exemple ci-dessus en y ajoutant ces couples de nombres :
@@ -2636,10 +2674,8 @@ Voici la liste exhaustive de tous les symboles possibles :
 
 @lilypondfile[ragged-right,quote]{script-chart.ly}
 
-
 @commonprop
 
-
 Les symboles s'ordonnent verticalement suivant la propriété
 @code{script-priority}. Plus le nombre qui la définit est faible, plus
 le symbole se rapprochera de la note. Dans l'exemple suivant, l'objet
@@ -3163,7 +3199,6 @@ de noter ces reprises.
 @cindex repeats
 @funindex \repeat
 
-
 On peut indiquer des répétitions de toutes les façons suivantes :
 
 @table @code
@@ -3195,6 +3230,11 @@ déclarées dans un contexte @code{Voice}.
 
 @node Repeat syntax
 @subsection Repeat syntax
+
+@cindex volta
+@cindex prima volta
+@cindex seconda volta
+
 Tous les différents types de reprises se spécifient dans
 LilyPond avec une même construction syntaxique, qui est :
 
@@ -3203,7 +3243,6 @@ LilyPond avec une même construction syntaxique, qui est :
 \repeat @var{type_de_la_reprise} @var{nombre_de_répétitions} @var{fragment_à_répéter}
 @end example
 
-
 On peut ajouter, pour indiquer une fin alternative :
 @funindex \alternative
 @example
@@ -3250,7 +3289,7 @@ au début de l'exemple.
 \new Staff {
  \partial 4
  \repeat volta 4 { e | c2 d2 | e2 f2 | }
- \alternative { { g4 g g } { a | a a a a | b2.  } }
+ \alternative { { g4 g g } { a | a a a a | b2. } }
 }
 @end lilypond
 
@@ -3459,6 +3498,7 @@ D'autres exemples : @inputfileref{input/@/regression,chord@/-tremolo@/.ly},
 
 @cindex tremolo marks
 @funindex tremoloFlags
+
 Un trémolo peut être indiqué sur une seule note, en la faisant suivre
 de deux points et d'un nombre :
 
diff --git a/Documentation/fr/user/introduction.itely b/Documentation/fr/user/introduction.itely
index c21092e..d8f5879 100644
--- a/Documentation/fr/user/introduction.itely
+++ b/Documentation/fr/user/introduction.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: 76af76e80c0e336511ff223db0d10229a00534c6
+    Translation of GIT committish: 0bf1e119501727ab8217767d8ce6c29dedf4fed1
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
@@ -559,11 +559,11 @@ Dans cette situation, la portée et les altérations accidentelles sont
 partagées, mais les hampes, liaisons etc., sont spécifiques à chaque
 voix.  Par conséquent, les graveurs doivent être groupés.  Les
 graveurs des têtes de notes, hampes, liaisons etc., vont dans un
-groupe appelé « contexte de Voix »@footnote{``Voice context'' en
-anglais, ``Voice'' commence par une majuscule comme tous les noms de
+groupe appelé @qq{contexte de Voix} @footnote{@q{Voice context} en
+anglais, @q{Voice} commence par une majuscule comme tous les noms de
 contexte dans le programme LilyPond.}, alors que les graveurs des clés,
 altérations accidentelles, barres de mesure etc., vont dans un groupe
-appelé « contexte de Portée ». Dans le cas de la polyphonie, un seul
+appelé @qq{contexte de Portée}. Dans le cas de la polyphonie, un seul
 contexte de Portée contient plusieurs contextes de Voix.  De même,
 plusieurs contextes de Portée peuvent être inclus dans un seul
 contexte de Partition.  Le contexte de Partition est le contexte de
@@ -833,8 +833,8 @@ instruments MIDI, les noms de couleur, et la police Feta.
 
 @item
 Les
-@emph{@ref{Example templates}}
-procurent des modèles de pièces LilyPond.  Copiez et collez un modèle
+@emph{@ref{Templates}}
+de pièces LilyPond.  Copiez et collez un modèle
 dans un fichier, ajouter les notes, et c'est prêt!
 
 @item
@@ -965,7 +965,7 @@ aux fichiers d'exemple et d'initialisation.  Tout au long de ce
 manuel, nous donnons les emplacements des fichiers d'entrée
 relativement au répértoire racine de l'archive source.  Par exemple,
 @file{input/@/test/@/bla@/.ly} peut référer au fichier
-@file{lilypond@/-2.8.0/@/input/@/test/@/bla@/.ly}.  Dans les paquets
+@file{lilypond@/2.x.y/@/input/@/test/@/bla@/.ly}.  Dans les paquets
 binaires pour les plateformes Unix, la documentation et les exemples
 se trouvent généralement sous @file{/usr/@/share/@/doc/@/lilypond/}.
 Les fichiers d'initialisation, par exemple @file{scm/@/lily@/.scm}, ou
diff --git a/Documentation/fr/user/putting.itely b/Documentation/fr/user/putting.itely
index 4e28f9c..4a305cb 100644
--- a/Documentation/fr/user/putting.itely
+++ b/Documentation/fr/user/putting.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: 9abd9b4fa11d01ce3f2c22da7b2ab4d9d1afc3dc
+    Translation of GIT committish: 0bf1e119501727ab8217767d8ce6c29dedf4fed1
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
@@ -11,7 +11,7 @@
 @chapter Putting it all together
 
 Ce chapitre traite des principes généraux de LilyPond, et de
-la manière de créer des blocs @code{\score} @footnote{Le terme "score" signifie "partition" en anglais.}.
+la manière de créer des blocs @code{\score} @footnote{Le terme @qq{score} signifie partition en anglais.}.

 @menu
@@ -32,10 +32,10 @@ beau, mais que faire quand ils ne traitent pas ce que l'on veut précisément ?
 Commencez par le modèle qui vous semblera le plus proche de ce à quoi
 vous voulez aboutir.  Disons par exemple que vous voulez écrire une pièce
 pour soprano et violoncelle : dans ce cas l'on pourrait commencer par
-@q{Notes and lyrics}, pour la partie de soprano.
+@qq{Notes and lyrics}, pour la partie de soprano.
 
 @example
-\version "2.9.13"
+\version "2.10.10"
 melodie = \relative c' @{
   \clef treble
   \key c \major
@@ -62,10 +62,10 @@ texte = \lyricmode @{
 @end example
 
 Maintenant, on veut ajouter une partie de violoncelle.
-Jetons un coup d'oeil sur l'exemple @q{Notes only} :
+Jetons un coup d'oeil sur l'exemple @qq{Notes only} :
 
 @example
-\version "2.9.13"
+\version "2.10.10"
 melodie = \relative c' @{
   \clef treble
   \key c \major
@@ -102,7 +102,7 @@ Et puis, toujours tant qu'on y est, mettons le violoncelle en clé de Fa, comme
 le veut l'usage, et donnons-lui d'autres notes.
 
 @example
-\version "2.9.13"
+\version "2.10.10"
 musiqueSoprano = \relative c' @{
   \clef treble
   \key c \major
@@ -175,7 +175,7 @@ mettre un peu d'ordre dans l'indentation.  Voici le modèle pour
 soprano et violoncelle au complet :
 
 @lilypond[quote,verbatim,ragged-right]
-\version "2.9.13"
+\version "2.10.10"
 musiqueSoprano = \relative c' {
   \clef treble
   \key c \major
diff --git a/Documentation/fr/user/templates.itely b/Documentation/fr/user/templates.itely
index efe7bce..d792e1f 100644
--- a/Documentation/fr/user/templates.itely
+++ b/Documentation/fr/user/templates.itely
@@ -1,14 +1,14 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: ac7d0e72b32b6a11470f598f2bee180b11402fe8
+    Translation of GIT committish: 0bf1e119501727ab8217767d8ce6c29dedf4fed1
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 
-@node Example templates
-@appendix Example templates
+@node Templates
+@appendix Templates
 
 UNTRANSLATED NODE: IGNORE ME
 
diff --git a/Documentation/fr/user/working.itely b/Documentation/fr/user/working.itely
index 8271848..1b42dfd 100644
--- a/Documentation/fr/user/working.itely
+++ b/Documentation/fr/user/working.itely
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @c This file is part of lilypond.tely
 @ignore
-   Translation of GIT committish: d0b8b30fb1e461c215c7867ae0aafed730699403
+   Translation of GIT committish: 0bf1e119501727ab8217767d8ce6c29dedf4fed1
 
    When revising a translation, copy the HEAD committish of the
    version that you are working on.  See TRANSLATION for details.
@@ -70,7 +70,7 @@ en résoudre d'autres.
 @itemize @bullet
 @item @strong{Ajoutez le numéro de version dans chaque fichier}.
 Notez que chaque fichier modèle contient une ligne @code{\version
-"2.9.13"}.  Nous vous conseillons fortement d'inclure cette ligne,
+"2.10.10"}.  Nous vous conseillons fortement d'inclure cette ligne,
 même pour de petits fichiers.  Par expérience, il est très difficile
 de se rappeler quelle version de LilyPond on utilisait quelques
 années auparavant.  L'utilitaire @code{convert-ly} demande que vous
@@ -662,7 +662,7 @@ pouvez les décommenter au lieu de les resaisir.
 Il y a deux exceptions à cette règle du strict nécessaire :
 
 @itemize
-@item incluez le numéro de @code{\version},
+@item incluez le numéro de @code{\version} en début de fichier
 @item si possible, utilisez @code{\paper@{ ragged-right=##t @}} au
 début de votre exemple.
 @end itemize
-- 
1.5.0

---

From: John Mandereau <[email-masked]>
Date: Wed, 21 Feb 2007 22:56:24 +0100

> I have run the script and done what had to be...

Salut Jean-Charles,

as the Translation meister is currently a French translator, you needn't
bother -devel with French translation updates any more (excepted if
there is a relevant issue), simply send them to -user-fr.

I've applied your patch on stable/2.10 and cherry-picked all recent
French docs commits to master.

Han-Wen, Jan, if this kind of request is acceptable, I'm requesting to
delay the next release until Friday evening, as I want to have a deeper
look at the French updates and would like to update the fr/*.itely
skeletons with an ad-hoc script, so the French docs deserve an
announcement on lilypond.org: the whole learning manual excepted
tweaks.itely is translated, and the Basic notation chapter too!

Cheers
-- 
John Mandereau <[email-masked]>