X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fsnippets%2Fnon-traditional-key-signatures.ly;h=de513d1681cfb3972fb32442bc6cbfbd52b43930;hb=c39d188d28fdc84cef8cbaea7b8d6e2fb718c30f;hp=1c6b5c0f37b0a6121550ebe49d20de166791713b;hpb=252ec5e71b5e121734a9c9897245137cb07e4a1f;p=lilypond.git

diff --git a/Documentation/snippets/non-traditional-key-signatures.ly b/Documentation/snippets/non-traditional-key-signatures.ly
index 1c6b5c0f37..de513d1681 100644
--- a/Documentation/snippets/non-traditional-key-signatures.ly
+++ b/Documentation/snippets/non-traditional-key-signatures.ly
@@ -4,147 +4,49 @@
 % and then run scripts/auxiliar/makelsr.py
 %
 % This file is in the public domain.
-%% Note: this file works from version 2.14.0
-\version "2.14.0"
+%% Note: this file works from version 2.19.7
+\version "2.19.7"
 
 \header {
-%% Translation of GIT committish: 6977ddc9a3b63ea810eaecb864269c7d847ccf98
-  doctitlees = "Armaduras de tonalidad no tradicionales"
-  texidoces = "
+  lsrtags = "contemporary-notation, pitches, really-cool, staff-notation, version-specific"
 
-La muy utilizada instrucción @code{\\key} establece la propiedad
-@code{keySignature} property, dentro del contexto @code{Staff}.
-
-Para crear armaduras de tonalidad no estándar, ajuste esta
-propiedad directamente.  El formato de esta instrucción es una
-lista:
-
-@code{\\set Staff.keySignature = #`(((octava . paso) . alteración)
-((octava . paso) . alteración) ...)} donde, para cada elemento
-dentro de la lista, @code{octava} especifica la octava
-(siendo@tie{}cero la octava desde el Do@tie{}central hasta el Si
-por encima), @code{paso} especifica la nota dentro de la octava
-(cero@tie{}significa@tie{}Do y 6@tie{}significa@tie{}Si), y
-@code{alteración} es @code{,SHARP ,FLAT ,DOUBLE-SHARP}
-etc. (observe la coma precedente.)
-
-De forma alternativa, para cada elemento de la lista el uso del
-formato más conciso @code{(paso . alteración)} especifica que la
-misma alteración debe estar en todas las octavas.
-
-He aquí un ejemplo de una posible armadura para generar una escala
-exátona:
-"
-
-
-%% Translation of GIT committish: bbf8fd2b5a3ebf20a1fdc91613dc49045a53a270
-  texidocit = "
-Il comando @code{\\key} comunemente usato imposta la proprietà
-@code{keySignature}, che fa parte del contesto @code{Staff}.
-
-Per creare armature di chiave non standard, tale proprietà va
-impostata esplicitamente.  Il formato di questo comando è
-una lista:
-
-@code{\\set Staff.keySignature = #`(((ottava . grado) . alterazione) ((ottava
-. grado) . alterazione) ...)} dove, per ogni elemento della lista,
-@code{ottava} indica l'ottava (0@tie{}è l'ottava dal Do@tie{}centrale
-al Si precedente), @code{grado} indica la nota all'interno
-dell'ottava (0@tie{}significa@tie{}Do e 6@tie{}significa@tie{}Si) e @code{alterazione}
-può essere @code{,SHARP ,FLAT ,DOUBLE-SHARP} etc.  (Si noti la virgola iniziale.)
-
-Altrimenti, usando, per ogni elemento della lista, il formato breve
-@code{(grado . alterazione)}, ciò indica che la stessa alterazione deve
-essere presente in tutte le ottave.
-
-Ecco un esempio di una possibile armatura per generare una scala
-a tono intero:
-"
-  doctitleit = "Armature di chiave non tradizionali"
-
-%% Translation of GIT committish: 0a868be38a775ecb1ef935b079000cebbc64de40
-  doctitlede = "Untypische Tonarten"
-  texidocde = "
-Der üblicherweise benutzte @code{\\key}-Befehl setzt die
-@code{keySignature}-Eigenschaft im @code{Staff}-Kontext.
-
-Um untypische Tonartenvorzeichen zu erstellen, muss man diese Eigenschaft
-direkt setzen.  Das Format für den Befehl ist eine Liste: @code{ \\set
-Staff.keySignature = #`(((Oktave . Schritt) . Alteration) ((Oktave
-. Schritt) . Alteration) ...)} wobei für jedes Element in der Liste
-@code{Oktave} die Oktave angibt (0@tie{}ist die Oktave vom
-eingestrichenen@tie{}C bis zum eingestrichenen@tie{}H), @code{Schritt} gibt
-die Note innerhalb der Oktave an (0@tie{}heißt@tie{}C und
-6@tie{}heißt@tie{}H), und @code{Alteration} ist @code{,SHARP ,FLAT
-,DOUBLE-SHARP} usw.  (Beachte das beginnende Komma.)
-
-Alternativ kann auch jedes Element der Liste mit dem allgemeineren Format
-@code{(Schritt . Alteration)} gesetzt werden, wobei dann die Einstellungen
-für alle Oktaven gelten.
-
-Hier ein Beispiel einer möglichen Tonart für eine Ganztonleiter:
-"
-
-%% Translation of GIT committish: 3b125956b08d27ef39cd48bfa3a2f1e1bb2ae8b4
-  texidocfr = "
-La commande @code{\\key} détermine la propriété @code{keySignature} d'un
-contexte @code{Staff}.
-
-Des armures inhabituelles peuvent être spécifiées en modifiant
-directement cette propriété. Il s'agit en l'occurence de définir une
-liste@tie{}:
-
-@code{\\set Staff.keySignature = #`(((octave . pas) . altération) ((octave
-. pas) . altération) @dots{})}
-
-dans laquelle, et pour chaque élément,
-@code{octave} spécifie l'octave (0@tie{}pour celle allant du
-do@tie{}médium au si supérieur), @code{pas} la note dans cette octave
-(0@tie{}pour@tie{}do et 6@tie{}pour@tie{}si), et @code{altération} sera
-@code{,SHARP ,FLAT ,DOUBLE-SHARP} etc.  (attention à la virgule en
-préfixe).
-
-Une formulation abrégée -- @code{(pas . altération)} -- signifie que
-l'altération de l'élément en question sera valide quel que soit l'octave.
+  texidoc = "
+The commonly used @code{\\key} command sets the @code{keyAlterations}
+property, in the @code{Staff} context.
 
+To create non-standard key signatures, set this property directly. The
+format of this command is a list:
 
-Voici, par exemple, comment générer une gamme par ton :
+@code{ \\set Staff.keyAlterations = #`(((octave . step) . alter) ((octave
+. step) . alter) ...) } where, for each element in the list,
+@code{octave} specifies the octave (0 being the octave from middle C to
+the B above), @code{step} specifies the note within the octave (0 means
+C and 6 means B), and @code{alter} is @code{,SHARP ,FLAT ,DOUBLE-SHARP}
+etc. (Note the leading comma.)
 
-"
-  doctitlefr = "Armures inhabituelles"
 
+Alternatively, for each item in the list, using the more concise format
+@code{(step . alter)} specifies that the same alteration should hold in
+all octaves.
 
-  lsrtags = "pitches, staff-notation"
-  texidoc = "
-The commonly used @code{\\key} command sets the @code{keySignature}
-property, in the @code{Staff} context.
 
-To create non-standard key signatures, set this property directly.  The
-format of this command is a list:
+For microtonal scales where a @qq{sharp} is not 100 cents, @code{alter}
+refers to the alteration as a proportion of a 200-cent whole tone.
 
-@code{\\set Staff.keySignature = #`(((octave . step) . alter) ((octave
-. step) . alter) ...)} where, for each element in the list,
-@code{octave} specifies the octave (0@tie{}being the octave from
-middle@tie{}C to the B above), @code{step} specifies the note within the
-octave (0@tie{}means@tie{}C and 6@tie{}means@tie{}B), and @code{alter} is
-@code{,SHARP ,FLAT ,DOUBLE-SHARP} etc.  (Note the leading comma.)
 
-Alternatively, for each item in the list, using the more concise format
-@code{(step . alter)} specifies that the same alteration should hold in all
-octaves.
+Here is an example of a possible key signature for generating a
+whole-tone scale:
 
-Here is an example of a possible key signature for generating a whole-tone
-scale:
 "
   doctitle = "Non-traditional key signatures"
 } % begin verbatim
 
 
+
 \relative c' {
-  \set Staff.keySignature = #`(((0 . 6) . ,FLAT)
-                               ((0 . 5) . ,FLAT)
-                               ((0 . 3) . ,SHARP))
+  \set Staff.keyAlterations = #`((6 . ,FLAT)
+                                 (5 . ,FLAT)
+                                 (3 . ,SHARP))
   c4 d e fis
   aes4 bes c2
 }
-