Let \autochange accept optional arguments for the turning-point and clefs

[lilypond.git] / Documentation / notation / keyboards.itely

diff --git a/Documentation/notation/keyboards.itely b/Documentation/notation/keyboards.itely
index a8405b5274f29b9008be04c9afbaba92c08b5aa4..3d2919edc7391fe85ffc49991ba85c6d4ae1dca6 100644 (file)
--- a/Documentation/notation/keyboards.itely
+++ b/Documentation/notation/keyboards.itely
@@ -7,7 +7,7 @@
     Guide, node Updating translation committishes..
 @end ignore
 
     Guide, node Updating translation committishes..
 @end ignore
 

-@c \version "2.17.6"
+@c \version "2.19.25"

 
 @node Keyboard and other multi-staff instruments
 @section Keyboard and other multi-staff instruments
 
 @node Keyboard and other multi-staff instruments
 @section Keyboard and other multi-staff instruments


@@ -112,7 +112,7 @@ as shown in @rlearning{Other uses for tweaks}.
 @c @snippets
 @c @lilypondfile[verbatim,quote,texidoc,doctitle]
 @c {forcing-visibility-of-systems-with-multi-bar-rests-when-using-\RemoveEmptyStaffContext.ly}
 @c @snippets
 @c @lilypondfile[verbatim,quote,texidoc,doctitle]
 @c {forcing-visibility-of-systems-with-multi-bar-rests-when-using-\RemoveEmptyStaffContext.ly}

-@c http://lsr.dsi.unimi.it/LSR/Item?u=1&id=312
+@c http://lsr.di.unimi.it/LSR/Item?u=1&id=312

 
 @seealso
 Learning Manual:
 
 @seealso
 Learning Manual:


@@ -289,6 +289,21 @@ in advance.
 }
 @end lilypond
 
 }
 @end lilypond
 

+@noindent
+It is possible to specify other pitches for the turning point.
+If the staves are not instantiated explicitly, other clefs may be used.
+
+@lilypond[quote,verbatim]
+music = {
+  g8 b a c' b8 d' c'8 e'
+  d'8 r f' g' a'2
+}
+
+\autochange d' \music
+\autochange b \with { \clef soprano } \music
+\autochange d' \with { \clef alto } \with { \clef tenor } \music
+@end lilypond
+

 @cindex relative music and autochange
 @cindex autochange and relative music
 
 @cindex relative music and autochange
 @cindex autochange and relative music
 


@@ -315,7 +330,7 @@ key signature in the lower staff:
   \new Staff = "up" {
     \new Voice = "melOne" {
       \key g \major
   \new Staff = "up" {
     \new Voice = "melOne" {
       \key g \major

-      \autochange \relative c' {
+      \autochange \relative {

         g8 b a c b d c e
         d8 r fis, g a2
       }
         g8 b a c b d c e
         d8 r fis, g a2
       }


@@ -373,11 +388,11 @@ staff based on the first note named in the chord construct.
 Whenever a voice switches to another staff, a line connecting the
 notes can be printed automatically:
 
 Whenever a voice switches to another staff, a line connecting the
 notes can be printed automatically:
 

-@lilypond[quote,verbatim,relative=1]
+@lilypond[quote,verbatim]

 \new PianoStaff <<
   \new Staff = "one" {
     \showStaffSwitch
 \new PianoStaff <<
   \new Staff = "one" {
     \showStaffSwitch

-    c1
+    c'1

     \change Staff = "two"
     b2 a
   }
     \change Staff = "two"
     b2 a
   }


@@ -487,13 +502,15 @@ produced: @notation{sustain}, @notation{sostenuto}
 (@notation{sos.}), and @notation{una corda} (@notation{U.C.}).
 Sustain pedals are also found on vibraphones and celestas.
 
 (@notation{sos.}), and @notation{una corda} (@notation{U.C.}).
 Sustain pedals are also found on vibraphones and celestas.
 

-@lilypond[quote,verbatim,relative=2]
-c4\sustainOn d e g
-<c, f a>1\sustainOff
-c4\sostenutoOn e g c,
-<bes d f>1\sostenutoOff
-c4\unaCorda d e g
-<d fis a>1\treCorde
+@lilypond[quote,verbatim]
+\relative {
+  c''4\sustainOn d e g
+  <c, f a>1\sustainOff
+  c4\sostenutoOn e g c,
+  <bes d f>1\sostenutoOff
+  c4\unaCorda d e g
+  <d fis a>1\treCorde
+}

 @end lilypond
 
 @cindex pedal indication styles
 @end lilypond
 
 @cindex pedal indication styles


@@ -512,15 +529,17 @@ There are three styles of pedal indications: text, bracket, and mixed.
 The sustain pedal and the una corda pedal use the text style by default
 while the sostenuto pedal uses mixed by default.
 
 The sustain pedal and the una corda pedal use the text style by default
 while the sostenuto pedal uses mixed by default.
 

-@lilypond[quote,verbatim,relative=2]
-c4\sustainOn g c2\sustainOff
-\set Staff.pedalSustainStyle = #'mixed
-c4\sustainOn g c d
-d\sustainOff\sustainOn g, c2\sustainOff
-\set Staff.pedalSustainStyle = #'bracket
-c4\sustainOn g c d
-d\sustainOff\sustainOn g, c2
-\bar "|."
+@lilypond[quote,verbatim]
+\relative {
+  c''4\sustainOn g c2\sustainOff
+  \set Staff.pedalSustainStyle = #'mixed
+  c4\sustainOn g c d
+  d\sustainOff\sustainOn g, c2\sustainOff
+  \set Staff.pedalSustainStyle = #'bracket
+  c4\sustainOn g c d
+  d\sustainOff\sustainOn g, c2
+  \bar "|."
+}

 @end lilypond
 
 The placement of the pedal commands matches the physical movement of the
 @end lilypond
 
 The placement of the pedal commands matches the physical movement of the


@@ -580,7 +599,7 @@ come into use to simplify the performance instructions.
 @snippets
 
 @lilypondfile[verbatim,quote,texidoc,doctitle]
 @snippets
 
 @lilypondfile[verbatim,quote,texidoc,doctitle]

-{accordion-registers.ly}
+{accordion-register-symbols.ly}

 
 @seealso
 Snippets:
 
 @seealso
 Snippets:


@@ -641,20 +660,20 @@ is controlled by a single pedal.  From the player's left to right, the
 pedals are D, C, and B on the left and E, F, G, and A on the right.
 The position of the pedals may be indicated with text marks:
 
 pedals are D, C, and B on the left and E, F, G, and A on the right.
 The position of the pedals may be indicated with text marks:
 

-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,verbatim,fragment]

 \textLengthOn
 \textLengthOn

-cis1_\markup \concat \vcenter {
+cis''1_\markup \concat \vcenter {

   [D \flat C \sharp B|E \sharp F \sharp G A \flat] }
   [D \flat C \sharp B|E \sharp F \sharp G A \flat] }

-c!1_\markup \concat \vcenter {
+c''!1_\markup \concat \vcenter {

   [ C \natural ] }
 @end lilypond
 
 or pedal diagrams:
 
   [ C \natural ] }
 @end lilypond
 
 or pedal diagrams:
 

-@lilypond[quote,verbatim,relative=2]
+@lilypond[quote,verbatim,fragment]

 \textLengthOn
 \textLengthOn

-cis1_\markup { \harp-pedal #"^v-|vv-^" }
-c!1_\markup { \harp-pedal #"^o--|vv-^" }
+cis''1_\markup { \harp-pedal #"^v-|vv-^" }
+c''!1_\markup { \harp-pedal #"^o--|vv-^" }

 @end lilypond
 
 The @code{\harp-pedal} command accepts a string of characters, where
 @end lilypond
 
 The @code{\harp-pedal} command accepts a string of characters, where