X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fsnippets%2Ftweaking-clef-properties.ly;h=5d1e69c13a328ed61686be8ba5945e60815aad58;hb=77320a48ed671c658f04256d087880c1701eb746;hp=09e42925233a2a30c478beafbd9faf799a293f24;hpb=a053d30d641f10d924675ba6cdc856d62aaec8e5;p=lilypond.git

diff --git a/Documentation/snippets/tweaking-clef-properties.ly b/Documentation/snippets/tweaking-clef-properties.ly
index 09e4292523..5d1e69c13a 100644
--- a/Documentation/snippets/tweaking-clef-properties.ly
+++ b/Documentation/snippets/tweaking-clef-properties.ly
@@ -1,179 +1,29 @@
 %% DO NOT EDIT this file manually; it is automatically
-%% generated from LSR http://lsr.dsi.unimi.it
+%% generated from LSR http://lsr.di.unimi.it
 %% Make any changes in LSR itself, or in Documentation/snippets/new/ ,
 %% and then run scripts/auxiliar/makelsr.py
 %%
 %% This file is in the public domain.
-\version "2.14.0"
+\version "2.18.0"
 
 \header {
   lsrtags = "pitches, staff-notation, tweaks-and-overrides"
 
-%% Translation of GIT committish: 6977ddc9a3b63ea810eaecb864269c7d847ccf98
-  doctitlees = "Trucaje de las propiedades de clave"
-  texidoces = "
-La instrucción @code{\\clef \"treble_8\"} equivale a un ajuste de
-@code{clefGlyph}, @code{clefPosition} (que controla la posición
-vertical de la clave), @code{middleCPosition} y
-@code{clefOctavation}.  Se imprime una clave cada vez que se
-modifica cualquiera de las propiedades excepto
-@code{middleCPosition}.
-
-Observe que la modificación del glifo, la posición de la clave o
-su octavación, no cambian 'per se' la posición de las siguientes
-notas del pentagrama: para hacer esto también se debe especificar
-la posición del Do central.  Los parámetros posicionales están en
-relación con la tercera línea del pentagrama, los números
-positivos desplazan hacia arriba, contando una unidad por cada
-línea y espacio.  El valor de @code{clefOctavation} se
-establecería normalmente a 7, -7, 15 or -15, pero son válidos
-otros valores.
-
-Cuando se produce un cambio de clave en el salto de línea se
-imprime la clave nueva tanto al final de la línea anterior como al
-principio de la nueva, de forma predeterminada.  Si no se necesita
-la clave de advertencia al final de la línea anterior, se puede
-quitar estableciendo el valor de la propiedad
-@code{explicitClefVisibility} de @code{Staff}, a
-@code{end-of-line-invisible}.  El comportamiento predeterminado se
-puede recuperar con @code{\\unset Staff.explicitClefVisibility}.
-
-Los siguientes ejemplos muestran las posibilidades cuando se
-ajustan estas propiedades manualmente.  En la primera línea, los
-cambios manuales preservan el posicionamiento relativo estándar de
-las claves y las notas, pero no lo hacen en la segunda línea.
-"
-
-
-%% Translation of GIT committish: bbf8fd2b5a3ebf20a1fdc91613dc49045a53a270
-  texidocit = "
-Il comando @code{\\clef \"treble_8\"} equivale a impostare
-@code{clefGlyph}, @code{clefPosition} (che regola la posizione
-verticale della chiave), @code{middleCPosition} e
-@code{clefOctavation}. Viene stampata una chiave quando cambia una
-di queste proprietà, eccetto @code{middleCPosition}.
-
-
-La modifica del glifo, della posizione della chiave o
-dell'ottavazione non è sufficiente per cambiare la posizione delle
-note che seguono sul rigo: bisogna anche specificare la posizione
-del Do centrale (middle C). I parametri di posizione sono relativi
-alla linea centrale del rigo, con i numeri positivi che indicano
-la parte superiore: ogni linea e spazio valgono uno.  Il valore
-@code{clefOctavation} di norma è impostato su 7, -7, 15
-o -15, ma altri valori sono considerati validi.
-
-
-Quando un cambio di chiave avviene in corrispondenza di un'interruzione di
-linea, di norma il simbolo della nuova chiave viene inserito sia alla fine
-del rigo precedente sia all'inizio di quello successivo.  Se la
-chiave di avvertimento a fine rigo non fosse necessaria,
-può essere nascosta impostando la proprietà @code{explicitClefVisibility}
-del contesto @code{Staff} su @code{end-of-line-invisible}. Il comportamento
-predefinito può essere ripristinato con @code{\\unset Staff.explicitClefVisibility}.
-
-Gli esempi seguenti mostrano le possibilità date dall'impostazione
-manuale di tali proprietà. Sulla prima linea le modifiche manuali preservano
-il posizionamento relativo standard di chiavi e note, mentre sulla seconda
-linea non lo fanno.
-
-
-"
-  doctitleit = "Modifiche manuali della proprietà della chiave"
-
-%% Translation of GIT committish: 0a868be38a775ecb1ef935b079000cebbc64de40
-  doctitlede = "Eigenschaften des Schlüssels optimieren"
-  texidocde = "
-Der Befehl @code{\\clef \"treble_8\"} ist gleichbedeutend mit einem
-expliziten Setzen der Eigenschaften von @code{clefGlyph},
-@code{clefPosition} (welche die vertikale Position des Schlüssels bestimmt),
-@code{middleCPosition} und @code{clefOctavation}.  Ein Schlüssel wird
-ausgegeben, wenn eine der Eigenschaften außer @code{middleCPosition} sich
-ändert.
-
-Eine Änderung des Schriftzeichens (Glyph), der Schlüsselposition oder der
-Oktavierung selber ändert noch nicht die Position der darauf folgenden Noten
-auf dem System: das geschieht nur, wenn auch die Position des
-eingestrichenen@tie{}C (middleCPosition) angegeben wird.  Die
-Positionsparameter sind relativ zur Mittellinie des Systems, dabei versetzen
-positive Zahlen die Position nach oben, jeweils eine Zahl für jede Linie
-plus Zwischenraum.  Der @code{clefOctavation}-Wert ist normalerweise auf 7,
--7, 15 oder -15 gesetzt, aber auch andere Werte sind gültig.
-
-Wenn ein Schlüsselwechsel an einem Zeilenwechsel geschieht, wird das neue
-Symbol sowohl am Ende der alten Zeilen als auch am Anfang der neuen Zeile
-ausgegeben.  Wenn der Warnungs-Schlüssel am Ende der alten Zeile nicht
-erforderlich ist, kann er unterdrückt werden, indem die
-@code{explicitClefVisibility}-Eigenschaft des @code{Staff}-Kontextes auf den
-Wert @code{end-of-line-invisible} gesetzt wird.  Das Standardverhalten kann
-mit @code{\\unset Staff.explicitClefVisibility} wieder hergestellt werden.
-
-Die folgenden Beispiele zeigen die Möglichkeiten, wenn man diese
-Eigenschaften manuell setzt.  Auf der ersten Zeile erhalten die manuellen
-Änderungen die ursprüngliche relative Positionierung von Schlüssel und
-Noten, auf der zweiten Zeile nicht.
-"
-
-%% Translation of GIT committish: 3b125956b08d27ef39cd48bfa3a2f1e1bb2ae8b4
-  texidocfr = "
-La commande @code{\\clef \"treble_8\"} équivaut à définir @code{clefGlyph},
-@code{clefPosition} -- qui contrôle la position verticale de la clé --
-@code{middleCPosition} et @code{clefOctavation}.  Une clé est imprimée
-lorsque l'une de ces propriétés, hormis @code{middleCPosition}, est
-modifiée.  Les exemples suivant font apparaître des possibilités de
-réglage manuel de ces propriétés.
-
-
-Modifier le glyphe, la position de la clef ou son octaviation ne
-changera pas la position des notes@tie{}; il faut pour y parvenir
-modifier aussi la position du do médium.  Le positionnement est relatif
-à la ligne médiane, un nombre positif faisant monter, chaque ligne ou
-interligne comptant pour@tie{}1.  La valeur de @code{clefOctavation}
-devrait être de 7, -7, 15 ou -15, bien que rien ne vous empêche de lui
-affecter une autre valeur.
-
-
-Lorsqu'un changement de clef intervient en même temps qu'un saut de
-ligne, la nouvelle clef est imprimée à la fois en fin de ligne et au
-début de la suivante.  Vous pouvez toujours supprimer cette @qq{clef de
-précaution} en affectant la valeur @code{end-of-line-invisible} à la
-propriété @code{explicitClefVisibility} du contexte @code{Staff}.  Le
-comportement par défaut sera réactivé par
-@w{@code{\\unset@tie{}Staff.explicitClefVisibility}}.
-
-
-Les exemples qui suivent illustrent les différentes possibilités de
-définir ces propriétés manuellement.  Sur la première ligne, la
-position relative des notes par rapport aux clefs est préservée, ce
-qui n'est pas le cas pour la deuxième ligne.
-
-"
-  doctitlefr = "Affinage des propriétés d'une clef"
-
   texidoc = "
-The command @code{\\clef \"treble_8\"} is equivalent to setting
-@code{clefGlyph}, @code{clefPosition} (which controls the vertical
-position of the clef), @code{middleCPosition} and
-@code{clefOctavation}. A clef is printed when any of the properties
-except @code{middleCPosition} are changed.
-
+Changing the Clef glyph, its position, or the ottavation does not
+change the position of subsequent notes on the staff.  To get key
+signatures on their correct staff lines @code{middleCClefPosition} must
+also be specified, with positive or negative values moving @code{middle
+C} up or down respectively, relative to the staff's center line.
 
-Note that changing the glyph, the position of the clef, or the
-octavation does not in itself change the position of subsequent notes
-on the staff: the position of middle C must also be specified to do
-this. The positional parameters are relative to the staff center line,
-positive numbers displacing upwards, counting one for each line and
-space. The @code{clefOctavation} value would normally be set to 7, -7,
-15 or -15, but other values are valid.
 
+For example, @code{\\clef \"treble_8\"} is equivalent to setting the
+@code{clefGlyph}, @code{clefPosition} (the vertical position of the
+clef itself on the staff), @code{middleCPosition} and
+@code{clefTransposition}. Note that when any of these properties
+(except @code{middleCPosition}) are changed a new clef symbol is
+printed.
 
-When a clef change takes place at a line break the new clef symbol is
-printed at both the end of the previous line and the beginning of the
-new line by default. If the warning clef at the end of the previous
-line is not required it can be suppressed by setting the @code{Staff}
-property @code{explicitClefVisibility} to the value
-@code{end-of-line-invisible}. The default behavior can be recovered
-with  @code{\\unset Staff.explicitClefVisibility}.
 
 The following examples show the possibilities when setting these
 properties manually. On the first line, the manual changes preserve the
@@ -184,35 +34,43 @@ line, they do not.
   doctitle = "Tweaking clef properties"
 } % begin verbatim
 
-\layout { ragged-right = ##t }
-
 {
   % The default treble clef
+  \key f \major
   c'1
   % The standard bass clef
   \set Staff.clefGlyph = #"clefs.F"
   \set Staff.clefPosition = #2
   \set Staff.middleCPosition = #6
+  \set Staff.middleCClefPosition = #6
+  \key g \major
   c'1
   % The baritone clef
   \set Staff.clefGlyph = #"clefs.C"
   \set Staff.clefPosition = #4
   \set Staff.middleCPosition = #4
+  \set Staff.middleCClefPosition = #4
+  \key f \major
   c'1
   % The standard choral tenor clef
   \set Staff.clefGlyph = #"clefs.G"
   \set Staff.clefPosition = #-2
-  \set Staff.clefOctavation = #-7
+  \set Staff.clefTransposition = #-7
   \set Staff.middleCPosition = #1
+  \set Staff.middleCClefPosition = #1
+  \key f \major
   c'1
   % A non-standard clef
   \set Staff.clefPosition = #0
-  \set Staff.clefOctavation = #0
+  \set Staff.clefTransposition = #0
   \set Staff.middleCPosition = #-4
+  \set Staff.middleCClefPosition = #-4
+  \key g \major
   c'1 \break
 
   % The following clef changes do not preserve
-  % the normal relationship between notes and clefs:
+  % the normal relationship between notes, key signatures
+  % and clefs:
 
   \set Staff.clefGlyph = #"clefs.F"
   \set Staff.clefPosition = #2
@@ -221,9 +79,9 @@ line, they do not.
   c'1
   \set Staff.clefGlyph = #"clefs.C"
   c'1
-  \set Staff.clefOctavation = #7
+  \set Staff.clefTransposition = #7
   c'1
-  \set Staff.clefOctavation = #0
+  \set Staff.clefTransposition = #0
   \set Staff.clefPosition = #0
   c'1
 
@@ -232,4 +90,3 @@ line, they do not.
   \set Staff.middleCPosition = #0
   c'1
 }
-