Doc-de: updating fretted-strings and new snippets

[lilypond.git] / Documentation / snippets / conducting-signs,-measure-grouping-signs.ly

diff --git a/Documentation/snippets/conducting-signs,-measure-grouping-signs.ly b/Documentation/snippets/conducting-signs,-measure-grouping-signs.ly
index d5e68a1bce2b818366af1197214219e1c21c4452..69b391a05dd0de560d13a0ce04d8cb89d471dd6a 100644 (file)
--- a/Documentation/snippets/conducting-signs,-measure-grouping-signs.ly
+++ b/Documentation/snippets/conducting-signs,-measure-grouping-signs.ly
@@ -1,29 +1,43 @@
-% Do not edit this file; it is automatically
+% DO NOT EDIT this file manually; it is automatically

 % generated from Documentation/snippets/new
 % generated from Documentation/snippets/new

+% Make any changes in Documentation/snippets/new/
+% and then run scripts/auxiliar/makelsr.py
+%

 % This file is in the public domain.
 % This file is in the public domain.

-%% Note: this file works from version 2.13.4
-\version "2.13.10"
+%% Note: this file works from version 2.13.36
+\version "2.13.36"

 
 \header {
 
 \header {

-%% Translation of GIT committish: b2d4318d6c53df8469dfa4da09b27c15a374d0ca
+%% Translation of GIT committish: 91eeed36c877fe625d957437d22081721c8c6345

   texidoces = "
   texidoces = "

-Las opciones para agrupar los pulsos de un compás están a nuestra
-disposición a través de la función de Scheme
-@code{set-time-signature}, que acepta tres argumentos: el número
-de pulsos, la longitud del pulso, y la agrupación interna de los
-pulsos dentro del compás.  Si se incluye el grabador
-@code{Measure_grouping_engraver}, la función crea también símbolos
-de agrupación @code{MeasureGrouping}.  Dichos símbolos facilitan
-la lectura de la música moderna de cierta complejidad rítmica.  En
-el ejemplo, el compás de 9/8 se subdivide en 2, 2, 2 y 3.  Esto se
-pasa a la función @code{set-time-signature} como tercer argumento:
-@code{'(2 2 2 3)}:
+La agrupación de pulsos dentro de un compás está controlada por la
+propiedad de contexto @code{beatStructure}.  Hay establecidos valores
+de @code{beatStructure} para muchos tipos de compases en
+@file{scm/time-signature-settings.scm}.  Los valores de
+@code{beatStructure} se pueden cambiar o establecer con @code{\\set}.
+Como alternativa, se puede usar la función de Scheme
+@code{set-time-signature} para establecer tanto el compás como la
+estructura de pulsos.  @code{set-time-signature} acepta tres
+argumentos: el número de pulsos, la longitud del pulso y la agrupación
+interna de los pulsos en el compás.  Tanto @code{\\time} como
+@code{set-time-signature} se aplican al contexto @code{Timing}, por lo
+que no restablecen los valores de @code{beatStructure} ni de
+@code{baseMoment} que se establezcan en otros contextos de nivel
+inferior, como @code{Voice}.
+
+Si el grabador @code{Measure_grouping_engraver} está incluido en uno
+de los contextos de presentación, se imprimirán signos de agrupación
+de pulsos.  Estos símbolos facilitan la lectura de música moderna
+rítmicamente compleja.  En este ejemplo, el compás de 9/8 se agrupa
+según dos patrones distintos utilizando los dos métodos, mientras que
+el compás de 5/8 se agrupa de acuerdo con el ajuste predeterminado que
+está en @file{scm/time-signature-settings.scm}:

 
 "
 
 "

-doctitlees = "Símbolos de dirección símbolos de agrupación de compás"
+doctitlees = "Símbolos de dirección y símbolos de agrupación de compás"

 
 
 
 

-%% Translation of GIT committish: d96023d8792c8af202c7cb8508010c0d3648899d
+%% Translation of GIT committish: 0a868be38a775ecb1ef935b079000cebbc64de40

   texidocde = "
 Optionen, mit denen die Balken in einem Takt gruppiert werden, sind
 durch die Scheme-Funktion @code{set-time-signature} erhältlich, die
   texidocde = "
 Optionen, mit denen die Balken in einem Takt gruppiert werden, sind
 durch die Scheme-Funktion @code{set-time-signature} erhältlich, die


@@ -37,54 +51,70 @@ der @code{set-time-signature}-Funktion als das dritte Argument mitgegeben:
 @code{'(2 2 2 3)}:
 
 "
 @code{'(2 2 2 3)}:
 
 "

-  doctitlede = "Dirigirzeichen Taktgruppenzeichen"
+  doctitlede = "Dirigierzeichen Taktgruppenzeichen"

 
 
 
 
 
 

-%% Translation of GIT committish: 7b70644b95f383b4281e9ffa146d315d2ada11d3
+%% Translation of GIT committish: 190a067275167c6dc9dd0afef683d14d392b7033

   texidocfr = "
 Les règles de ligature par mesure sont gérées par la propriété
   texidocfr = "
 Les règles de ligature par mesure sont gérées par la propriété

-@code{beamSettings}.  Elles peuvent être modifiées par la commande
-@code{\\overrideBeamSettings}.  
-Il existe des options qui permettent de grouper les ligatures au sein
-d'une mesure, grâce à la fonction Scheme @code{set-time-signature}.
-Celle-ci prend trois arguments : le nombre de pulsations, la durée de la
-pulsation et le regroupement des pulsations dans la mesure.  Si l'on
-fait appel au @code{Measure_grouping_engraver}, la fonction
+@code{beatStructure}.  Ses valeurs par défaut sont répertoriées, par
+métrique, dans le fichier @code{scm/@/time-@/signature@/-settings@/.scm}.  Elles
+sont modifiables grâce à la commande @code{\\set}.
+La fonction Scheme @code{set-time-signature} permet quant à elle de
+définir à la fois la métrique et la pulsation.  Celle-ci prend trois
+arguments@tie{}: le nombre de pulsations, la durée de la pulsation et le
+regroupement des pulsations dans la mesure.   @code{\\time} et
+@code{set-time-signature} s'appliquent tous deux au contexte
+@code{Timing}@tie{}; ils ne redéfiniront donc pas les valeurs de
+@code{beatStructure} ou @code{baseMoment} lorsque qu'elles sont
+modifiées dans un contexte de niveau inférieur comme @code{Voice} par
+exemple.
+Si l'on fait appel au @code{Measure_grouping_engraver}, la fonction

 @code{set-time-signature} créera aussi des symboles
 @code{MeasureGrouping}.  Ces symboles aident à la lecture des œuvres
 modernes à la rythmique complexe.  Dans l'exemple qui suit, la mesure à
 9/8 est divisée en 2, 2, 2 et 3, alors que la mesure à 5/8 répond aux
 @code{set-time-signature} créera aussi des symboles
 @code{MeasureGrouping}.  Ces symboles aident à la lecture des œuvres
 modernes à la rythmique complexe.  Dans l'exemple qui suit, la mesure à
 9/8 est divisée en 2, 2, 2 et 3, alors que la mesure à 5/8 répond aux

-règles par défaut contenues dans le fichier @w{@code{scm/beam-settings.scm}}.
+règles par défaut contenues dans le fichier @w{@code{scm/@/beam@/-settings@/.scm}}.

 
 "
   doctitlefr = "Signes de direction signes de sous-groupe"
 
   lsrtags = "rhythms"
   texidoc = "
 
 "
   doctitlefr = "Signes de direction signes de sous-groupe"
 
   lsrtags = "rhythms"
   texidoc = "

-Beat grouping within a bar is controlled by the default grouping
-established in @code{beamSettings}.  This grouping can be established
-by the use of @code{\\overrideBeamSettings}.  Alternatively, the
+Beat grouping within a measure is controlled by the context property
+@code{beatStructure}.  Values of @code{beatStructure} are
+established for many time signatures in
+@file{scm/time-signature-settings.scm}.  Values of @code{beatStructure}
+can be changed or set with @code{\\set}.
+Alternatively, the

 Scheme function @code{set-time-signature} can be used to both
 Scheme function @code{set-time-signature} can be used to both

-set the time signature and establish the default grouping rule.
+set the time signature and establish the beat structure.

 @code{set-time-signature}, takes three arguments: the
 number of beats, the beat length, and the internal grouping of beats in
 @code{set-time-signature}, takes three arguments: the
 number of beats, the beat length, and the internal grouping of beats in

-the measure.  If the @code{Measure_grouping_engraver} is included
+the measure.  @code{\\time} and @code{set-time-signature} both apply
+to the @code{Timing} context, so they will not reset values of
+@code{beatStructure} or @code{baseMoment} that are set in
+other lower-level contexts, such as @code{Voice}.
+
+If the @code{Measure_grouping_engraver} is included

 in one of the display contexts, measure grouping signs will be
 created.  Such signs ease reading rhythmically complex modern music.
 In the example, the 9/8 measure is grouped in two different
 patterns using the two different methods, while the 5/8 measure
 is grouped according to the default setting in
 in one of the display contexts, measure grouping signs will be
 created.  Such signs ease reading rhythmically complex modern music.
 In the example, the 9/8 measure is grouped in two different
 patterns using the two different methods, while the 5/8 measure
 is grouped according to the default setting in

-@file{scm/beam-settings.scm}:
+@file{scm/time-signature-settings.scm}:

 "
   doctitle = "Conducting signs measure grouping signs"
 } % begin verbatim
 
 
 "
   doctitle = "Conducting signs measure grouping signs"
 } % begin verbatim
 
 

+

 \score {
 \score {

-  \relative c'' {
+  \new Voice \relative c'' {

     \time 9/8
     \time 9/8

-    \overrideBeamSettings #'Score #'(9 . 8) #'end #'((* . (2 2 2 3)))
+    g8 g d d g g a( bes g) |
+    \set Timing.beatStructure = #'(2 2 2 3)

     g8 g d d g g a( bes g) |
     #(set-time-signature 9 8 '(4 5))
     g8 g d d g g a( bes g) |
     g8 g d d g g a( bes g) |
     #(set-time-signature 9 8 '(4 5))
     g8 g d d g g a( bes g) |