Run scripts/auxiliar/update-with-convert-ly.sh

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

diff --git a/Documentation/notation/pitches.itely b/Documentation/notation/pitches.itely
index 4bc237094ac9061cb3d0a60978cda36b86bdc02f..0b2271e71bd72e7843cdf2677e535862f76a30c5 100644 (file)
--- a/Documentation/notation/pitches.itely
+++ b/Documentation/notation/pitches.itely
@@ -7,7 +7,7 @@
     Guide, node Updating translation committishes..
 @end ignore
 
     Guide, node Updating translation committishes..
 @end ignore
 

-@c \version "2.15.20"
+@c \version "2.16.0"

 
 
 @node Pitches
 
 
 @node Pitches


@@ -820,15 +820,16 @@ rather than e-triple-flat).
 @cindex operation, inversion
 @funindex \inversion
 
 @cindex operation, inversion
 @funindex \inversion
 

-A music expression can be inverted with:
+A music expression can be inverted and transposed in a single
+operation with:

 
 @example
 
 @example

-\inversion @var{from-pitch} @var{to-pitch} @var{musicexpr}
+\inversion @var{around-pitch} @var{to-pitch} @var{musicexpr}

 @end example
 
 @end example
 

-The @code{@var{musicexpr}} is inverted interval-by-interval,
-and then transposed so that @code{@var{from-pitch}} is mapped
-to @code{@var{to-pitch}}.
+The @code{@var{musicexpr}} is inverted interval-by-interval around
+@code{@var{around-pitch}}, and then transposed so that
+@code{@var{around-pitch}} is mapped to @code{@var{to-pitch}}.

 
 @lilypond[verbatim,quote]
 music = \relative c' { c d e f }
 
 @lilypond[verbatim,quote]
 music = \relative c' { c d e f }


@@ -839,6 +840,10 @@ music = \relative c' { c d e f }
 }
 @end lilypond
 
 }
 @end lilypond
 

+@warning{Motifs to be inverted should be expressed in absolute form
+or be first converted to absolute form by enclosing them in a 
+@code{\relative} block.}
+

 @seealso
 Notation Reference:
 @ref{Modal transformations},
 @seealso
 Notation Reference:
 @ref{Modal transformations},


@@ -1397,7 +1402,7 @@ clarinet.
 \transposition a
 c d e f
 \textLengthOn
 \transposition a
 c d e f
 \textLengthOn

-s1*0^\markup { Switch to B\flat clarinet }
+<>^\markup { Switch to B\flat clarinet }

 R1
 
 \key bes \major
 R1
 
 \key bes \major


@@ -1477,11 +1482,11 @@ musicB = {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {

-      <fis, a cis>8 <fis a cis>
+      <fis, a cis>8[ <fis a cis>

       \change Staff = up
       cis' cis
       \change Staff = down
       \change Staff = up
       cis' cis
       \change Staff = down

-      <fis, a> <fis a>
+      <fis, a> <fis a>]

       \showStaffSwitch
       \change Staff = up
       dis'4 |
       \showStaffSwitch
       \change Staff = up
       dis'4 |


@@ -1560,11 +1565,11 @@ musicB = {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {

-      <fis, a cis>8 <fis a cis>
+      <fis, a cis>8[ <fis a cis>

       \change Staff = up
       cis' cis
       \change Staff = down
       \change Staff = up
       cis' cis
       \change Staff = down

-      <fis, a> <fis a>
+      <fis, a> <fis a>]

       \showStaffSwitch
       \change Staff = up
       dis'4 |
       \showStaffSwitch
       \change Staff = up
       dis'4 |


@@ -1633,11 +1638,11 @@ musicB = {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {

-      <fis, a cis>8 <fis a cis>
+      <fis, a cis>8[ <fis a cis>

       \change Staff = up
       cis' cis
       \change Staff = down
       \change Staff = up
       cis' cis
       \change Staff = down

-      <fis, a> <fis a>
+      <fis, a> <fis a>]

       \showStaffSwitch
       \change Staff = up
       dis'4 |
       \showStaffSwitch
       \change Staff = up
       dis'4 |


@@ -1699,11 +1704,11 @@ musicB = {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {

-      <fis, a cis>8 <fis a cis>
+      <fis, a cis>8[ <fis a cis>

       \change Staff = up
       cis' cis
       \change Staff = down
       \change Staff = up
       cis' cis
       \change Staff = down

-      <fis, a> <fis a>
+      <fis, a> <fis a>]

       \showStaffSwitch
       \change Staff = up
       dis'4 |
       \showStaffSwitch
       \change Staff = up
       dis'4 |


@@ -1763,11 +1768,11 @@ musicB = {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {

-      <fis, a cis>8 <fis a cis>
+      <fis, a cis>8[ <fis a cis>

       \change Staff = up
       cis' cis
       \change Staff = down
       \change Staff = up
       cis' cis
       \change Staff = down

-      <fis, a> <fis a>
+      <fis, a> <fis a>]

       \showStaffSwitch
       \change Staff = up
       dis'4 |
       \showStaffSwitch
       \change Staff = up
       dis'4 |


@@ -1830,11 +1835,11 @@ musicB = {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {

-      <fis, a cis>8 <fis a cis>
+      <fis, a cis>8[ <fis a cis>

       \change Staff = up
       cis' cis
       \change Staff = down
       \change Staff = up
       cis' cis
       \change Staff = down

-      <fis, a> <fis a>
+      <fis, a> <fis a>]

       \showStaffSwitch
       \change Staff = up
       dis'4 |
       \showStaffSwitch
       \change Staff = up
       dis'4 |


@@ -1891,11 +1896,11 @@ musicB = {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {

-      <fis, a cis>8 <fis a cis>
+      <fis, a cis>8[ <fis a cis>

       \change Staff = up
       cis' cis
       \change Staff = down
       \change Staff = up
       cis' cis
       \change Staff = down

-      <fis, a> <fis a>
+      <fis, a> <fis a>]

       \showStaffSwitch
       \change Staff = up
       dis'4 |
       \showStaffSwitch
       \change Staff = up
       dis'4 |


@@ -1956,11 +1961,11 @@ musicB = {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {

-      <fis, a cis>8 <fis a cis>
+      <fis, a cis>8[ <fis a cis>

       \change Staff = up
       cis' cis
       \change Staff = down
       \change Staff = up
       cis' cis
       \change Staff = down

-      <fis, a> <fis a>
+      <fis, a> <fis a>]

       \showStaffSwitch
       \change Staff = up
       dis'4 |
       \showStaffSwitch
       \change Staff = up
       dis'4 |


@@ -2016,11 +2021,11 @@ musicB = {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {

-      <fis, a cis>8 <fis a cis>
+      <fis, a cis>8[ <fis a cis>

       \change Staff = up
       cis' cis
       \change Staff = down
       \change Staff = up
       cis' cis
       \change Staff = down

-      <fis, a> <fis a>
+      <fis, a> <fis a>]

       \showStaffSwitch
       \change Staff = up
       dis'4 |
       \showStaffSwitch
       \change Staff = up
       dis'4 |


@@ -2075,11 +2080,11 @@ musicB = {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {

-      <fis, a cis>8 <fis a cis>
+      <fis, a cis>8[ <fis a cis>

       \change Staff = up
       cis' cis
       \change Staff = down
       \change Staff = up
       cis' cis
       \change Staff = down

-      <fis, a> <fis a>
+      <fis, a> <fis a>]

       \showStaffSwitch
       \change Staff = up
       dis'4 |
       \showStaffSwitch
       \change Staff = up
       dis'4 |


@@ -2132,11 +2137,11 @@ musicB = {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {

-      <fis, a cis>8 <fis a cis>
+      <fis, a cis>8[ <fis a cis>

       \change Staff = up
       cis' cis
       \change Staff = down
       \change Staff = up
       cis' cis
       \change Staff = down

-      <fis, a> <fis a>
+      <fis, a> <fis a>]

       \showStaffSwitch
       \change Staff = up
       dis'4 |
       \showStaffSwitch
       \change Staff = up
       dis'4 |


@@ -2192,11 +2197,11 @@ musicB = {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {

-      <fis, a cis>8 <fis a cis>
+      <fis, a cis>8[ <fis a cis>

       \change Staff = up
       cis' cis
       \change Staff = down
       \change Staff = up
       cis' cis
       \change Staff = down

-      <fis, a> <fis a>
+      <fis, a> <fis a>]

       \showStaffSwitch
       \change Staff = up
       dis'4 |
       \showStaffSwitch
       \change Staff = up
       dis'4 |


@@ -2249,11 +2254,11 @@ musicB = {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {

-      <fis, a cis>8 <fis a cis>
+      <fis, a cis>8[ <fis a cis>

       \change Staff = up
       cis' cis
       \change Staff = down
       \change Staff = up
       cis' cis
       \change Staff = down

-      <fis, a> <fis a>
+      <fis, a> <fis a>]

       \showStaffSwitch
       \change Staff = up
       dis'4 |
       \showStaffSwitch
       \change Staff = up
       dis'4 |


@@ -2309,11 +2314,11 @@ musicB = {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {

-      <fis, a cis>8 <fis a cis>
+      <fis, a cis>8[ <fis a cis>

       \change Staff = up
       cis' cis
       \change Staff = down
       \change Staff = up
       cis' cis
       \change Staff = down

-      <fis, a> <fis a>
+      <fis, a> <fis a>]

       \showStaffSwitch
       \change Staff = up
       dis'4 |
       \showStaffSwitch
       \change Staff = up
       dis'4 |


@@ -2351,7 +2356,7 @@ Accidentals are printed like with @code{modern}, but cautionary
 accidentals are added for all sharp or flat tones specified by the
 key signature, except if the note is immediately repeated.
 
 accidentals are added for all sharp or flat tones specified by the
 key signature, except if the note is immediately repeated.
 

-@lilypond[quote]
+@lilypond[quote,staffsize=18]

 musicA = {
   <<
     \relative c' {
 musicA = {
   <<
     \relative c' {


@@ -2370,11 +2375,11 @@ musicB = {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {

-      <fis, a cis>8 <fis a cis>
+      <fis, a cis>8[ <fis a cis>

       \change Staff = up
       cis' cis
       \change Staff = down
       \change Staff = up
       cis' cis
       \change Staff = down

-      <fis, a> <fis a>
+      <fis, a> <fis a>]

       \showStaffSwitch
       \change Staff = up
       dis'4 |
       \showStaffSwitch
       \change Staff = up
       dis'4 |


@@ -2431,11 +2436,11 @@ musicB = {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {

-      <fis, a cis>8 <fis a cis>
+      <fis, a cis>8[ <fis a cis>

       \change Staff = up
       cis' cis
       \change Staff = down
       \change Staff = up
       cis' cis
       \change Staff = down

-      <fis, a> <fis a>
+      <fis, a> <fis a>]

       \showStaffSwitch
       \change Staff = up
       dis'4 |
       \showStaffSwitch
       \change Staff = up
       dis'4 |


@@ -2490,11 +2495,11 @@ musicB = {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {
   \clef bass
   \new Voice {
     \voiceTwo \relative c' {

-      <fis, a cis>8 <fis a cis>
+      <fis, a cis>8[ <fis a cis>

       \change Staff = up
       cis' cis
       \change Staff = down
       \change Staff = up
       cis' cis
       \change Staff = down

-      <fis, a> <fis a>
+      <fis, a> <fis a>]

       \showStaffSwitch
       \change Staff = up
       dis'4 |
       \showStaffSwitch
       \change Staff = up
       dis'4 |


@@ -2572,7 +2577,7 @@ the accidental style to @code{forget}:
 @lilypond[verbatim,quote]
 forget = #(define-music-function (parser location music) (ly:music?) #{
   \accidentalStyle "forget"
 @lilypond[verbatim,quote]
 forget = #(define-music-function (parser location music) (ly:music?) #{
   \accidentalStyle "forget"

-  $music
+  #music

   \accidentalStyle "modern"
 #})
 {
   \accidentalStyle "modern"
 #})
 {