Correct vocal ensemble template from LSR

[lilypond.git] / Documentation / snippets / new / non-traditional-key-signatures.ly

diff --git a/Documentation/snippets/new/non-traditional-key-signatures.ly b/Documentation/snippets/new/non-traditional-key-signatures.ly
index b0f2a629b35cf96d1706fb962d8d2d8459d48145..5559898bec44e98b01c798deb76b3137084ea56f 100644 (file)
--- a/Documentation/snippets/new/non-traditional-key-signatures.ly
+++ b/Documentation/snippets/new/non-traditional-key-signatures.ly
@@ -1,36 +1,44 @@
-\version "2.13.0"
+\version "2.19.7"
 
 \header {
-  lsrtags = "pitches, staff-notation"
+  lsrtags = "contemporary-notation, pitches, really-cool, staff-notation, version-specific"
+
   texidoc = "
-The commonly used @code{\\key} command sets the @code{keySignature}
+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
+To create non-standard key signatures, set this property directly. The
 format of this command is a list:
 
-@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.)
+@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.)
+
 
 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.
+@code{(step . alter)} specifies that the same alteration should hold in
+all octaves.
+
+
+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.
+
+
+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"
 }
 
+
 \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
 }
-