version that you are working on. See TRANSLATION for details.
@end ignore
-@c \version "2.11.51"
+@c \version "2.11.61"
@node Pitches
are three steps to this process: input, modification, and output.
@menu
-* Writing pitches::
-* Changing multiple pitches::
-* Displaying pitches::
-* Note heads::
+* Writing pitches::
+* Changing multiple pitches::
+* Displaying pitches::
+* Note heads::
@end menu
mode. In most cases, relative mode will be more convenient.
@menu
-* Absolute octave entry::
-* Relative octave entry::
-* Accidentals::
-* Note names in other languages::
+* Absolute octave entry::
+* Relative octave entry::
+* Accidentals::
+* Note names in other languages::
@end menu
d,, d, d c
@end lilypond
-@seealso
+@seealso
Music Glossary:
@rglos{Pitch names}.
@seealso
-
Music Glossary:
@rglos{fifth},
@rglos{interval},
@funindex \chordmode
@funindex \relative
+
@knownissues
The relative conversion will not affect @code{\transpose},
@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{preventing-extra-naturals-from-being-automatically-added.ly}
-@seealso
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{makam-example.ly}
+
+@seealso
Music Glossary:
@rglos{sharp},
@rglos{flat},
Notation Reference:
@ref{Automatic accidentals},
-@ref{Annotational accidentals},
+@ref{Annotational accidentals (musica ficta)},
@ref{Note names in other languages}.
Snippets:
@rlsr{Pitches}.
Internals Reference:
-@rinternals{Accidental_engraver},
+@rinternals{Accidental_engraver},
@rinternals{Accidental},
@rinternals{AccidentalCautionary},
@rinternals{accidental-interface}.
@cindex language, note names in other
@cindex language, pitch names in other
-There are predefined sets of note names for various other
-languages. To use them, include the language-specific init file.
-For example, to use English notes names, add
-@w{@code{\include "english.ly"}} to the top of the input file.
+There are predefined sets of note and accidental names for various
+other languages. To use them, include the language-specific init
+file listed below. For example, to use English notes names, add
+@code{@w{\include "english.ly"}} to the top of the input file.
+
The available language files and the note names they define are:
+@quotation
+@multitable {@file{nederlands.ly}} {do re mi fa sol la sib si}
+@headitem Language File
+ @tab Note Names
+@item @file{nederlands.ly}
+ @tab c d e f g a bes b
+@item @file{arabic.ly}
+ @tab do re mi fa sol la sib si
+@item @file{catalan.ly}
+ @tab do re mi fa sol la sib si
+@item @file{deutsch.ly}
+ @tab c d e f g a b h
+@item @file{english.ly}
+ @tab c d e f g a bf b
+@item @file{espanol.ly}
+ @tab do re mi fa sol la sib si
+@item @file{italiano.ly}
+ @tab do re mi fa sol la sib si
+@item @file{norsk.ly}
+ @tab c d e f g a b h
+@item @file{portugues.ly}
+ @tab do re mi fa sol la sib si
+@item @file{suomi.ly}
+ @tab c d e f g a b h
+@item @file{svenska.ly}
+ @tab c d e f g a b h
+@item @file{vlaams.ly}
+ @tab do re mi fa sol la sib si
+@end multitable
+@end quotation
+
+@noindent
+and the accidental suffixes they define are:
-@smallexample
-@multitable {nederlands.ly} {do re mi fa sol la sib si} {-iss/-is} {-ess/-es} {-ss/-x/-sharpsharp} {-essess/-eses}
-@headitem Language
- @tab Note names
+@quotation
+@multitable {@file{nederlands.ly}} {-s/-sharp} {-ess/-es} {-ss/-x/-sharpsharp} {-essess/-eses}
+@headitem Language File
@tab sharp @tab flat @tab double sharp @tab double flat
-@item nederlands.ly
- @tab c d e f g a bes b
+@item @file{nederlands.ly}
@tab -is @tab -es @tab -isis @tab -eses
-@item arabic.ly
- @tab do re mi fa sol la sib si
+@item @file{arabic.ly}
@tab -d @tab -b @tab -dd @tab -bb
-@item catalan.ly
- @tab do re mi fa sol la sib si
+@item @file{catalan.ly}
@tab -d/-s @tab -b @tab -dd/-ss @tab -bb
-@item deutsch.ly
- @tab c d e f g a b h
+@item @file{deutsch.ly}
@tab -is @tab -es @tab -isis @tab -eses
-@item english.ly
- @tab c d e f g a bf b
+@item @file{english.ly}
@tab -s/-sharp @tab -f/-flat @tab -ss/-x/-sharpsharp
@tab -ff/-flatflat
-@item espanol.ly
- @tab do re mi fa sol la sib si
+@item @file{espanol.ly}
@tab -s @tab -b @tab -ss @tab -bb
-@item italiano.ly
- @tab do re mi fa sol la sib si
+@item @file{italiano.ly}
@tab -d @tab -b @tab -dd @tab -bb
-@item norsk.ly
- @tab c d e f g a b h
+@item @file{norsk.ly}
@tab -iss/-is @tab -ess/-es @tab -ississ/-isis
@tab -essess/-eses
-@item portugues.ly
- @tab do re mi fa sol la sib si
+@item @file{portugues.ly}
@tab -s @tab -b @tab -ss @tab -bb
-@item suomi.ly
- @tab c d e f g a b h
+@item @file{suomi.ly}
@tab -is @tab -es @tab -isis @tab -eses
-@item svenska.ly
- @tab c d e f g a b h
+@item @file{svenska.ly}
@tab -iss @tab -ess @tab -ississ @tab -essess
-@item vlaams.ly
- @tab do re mi fa sol la sib si
+@item @file{vlaams.ly}
@tab -k @tab -b @tab -kk @tab -bb
@end multitable
-@end smallexample
+@end quotation
In Dutch, @code{aes} is contracted to @code{as}, but both forms
are accepted in LilyPond. Similarly, both @code{es} and
mean @q{half} and @q{one and a half}, respectively. For the other
languages, no special names have been defined yet.
-@smallexample
-@multitable {nederlands.ly} {do re mi fa sol la sib si} {-iss/-is} {-ess/-es} {-ississ/-isis} {-ississ/-isis}
-@headitem Language
- @tab Note names
+@quotation
+@multitable {@file{nederlands.ly}} {@b{semi-sharp}} {@b{semi-flat}} {@b{sesqui-sharp}} {@b{sesqui-flat}}
+@headitem Language File
@tab semi-sharp @tab semi-flat @tab sesqui-sharp @tab sesqui-flat
-@item nederlands.ly
- @tab c d e f g a bes b
+@item @file{nederlands.ly}
@tab -ih @tab -eh @tab -isih @tab -eseh
-@item arabic.ly
- @tab do re mi fa sol la sib si
+@item @file{arabic.ly}
@tab -sd @tab -sb @tab -dsd @tab -bsb
-@item deutsch.ly
- @tab c d e f g a b h
+@item @file{deutsch.ly}
@tab -ih @tab -eh @tab -isih @tab -eseh
-@item english.ly
- @tab c d e f g a bf b
+@item @file{english.ly}
@tab -qs @tab -qf @tab -tqs @tab -tqf
-@item italiano.ly
- @tab do re mi fa sol la sib si
+@item @file{italiano.ly}
@tab -sd @tab -sb @tab -dsd @tab -bsb
-@item portugues.ly
- @tab do re mi fa sol la sib si
+@item @file{portugues.ly}
@tab -sqt @tab -bqt @tab -stqt @tab -btqt
@end multitable
-@end smallexample
+@end quotation
@seealso
-
Music Glossary:
@rglos{Pitch names}.
This section discusses how to modify pitches.
@menu
-* Octave checks::
-* Transpose::
+* Octave checks::
+* Transpose::
@end menu
@node Octave checks
@seealso
-
Snippets:
@rlsr{Pitches}.
@seealso
-
Notation Reference:
@ref{Instrument transpositions}.
Internals Reference:
@rinternals{TransposedMusic}.
+
@funindex \transpose
@funindex \chordmode
@funindex \relative
This section discusses how to alter the output of pitches.
@menu
-* Clef::
-* Key signature::
-* Ottava brackets::
-* Instrument transpositions::
-* Automatic accidentals::
-* Ambitus::
+* Clef::
+* Key signature::
+* Ottava brackets::
+* Instrument transpositions::
+* Automatic accidentals::
+* Ambitus::
@end menu
@cindex clef, C
@cindex clef, F
@cindex clef, treble
-@cindex clef, violin
-@cindex clef, alto
+@cindex clef, violin
+@cindex clef, alto
@cindex clef, tenor
-@cindex clef, bass
-@cindex clef, french
-@cindex clef, soprano
-@cindex clef, mezzosoprano
-@cindex clef, baritone
-@cindex clef, varbaritone
-@cindex subbass clef, subbass
+@cindex clef, bass
+@cindex clef, french
+@cindex clef, soprano
+@cindex clef, mezzosoprano
+@cindex clef, baritone
+@cindex clef, varbaritone
+@cindex subbass clef, subbass
The clef may be altered. Middle C is shown in every example.
c2 c
@end lilypond
-Further supported clefs are described under @ref{Ancient clefs}.
+Further supported clefs are described under @ref{Mensural clefs}
+and @ref{Gregorian clefs}.
@cindex transposing clefs
@cindex clef, transposing
@seealso
-
Notation Reference:
-@ref{Ancient clefs}.
+@ref{Mensural clefs}, @ref{Gregorian clefs}.
Snippets:
@rlsr{Pitches}.
@seealso
-
Music Glossary:
@rglos{church mode},
@rglos{scordatura}.
@seealso
-
Music Glossary:
@rglos{octavation}.
@rinternals{ottava-bracket-interface}.
-
@node Instrument transpositions
@unnumberedsubsubsec Instrument transpositions
@seealso
-
Music Glossary:
@rglos{concert pitch},
@rglos{transposing instrument}.
@item piano-cautionary
-@funindex piano-cautionary
+@funindex piano-cautionary
@cindex accidentals, piano cautionary
@cindex cautionary accidentals, piano
@cindex piano cautionary accidentals
@end lilypond
+@item teaching
+
+@funindex teaching
+@cindex teaching accidental style
+@cindex accidental style, teaching
+
+This rule is intended for students, and makes it easy to create
+scale sheets with automagically created cautionary accidentals.
+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.
+
+@lilypond[quote]
+musicA = {
+ <<
+ \relative c' {
+ cis'8 fis, d'4 <a cis>8 f bis4 |
+ cis2. <c, g'>4 |
+ }
+ \\
+ \relative c' {
+ ais'2 cis, |
+ fis8 b a4 cis2 |
+ }
+ >>
+}
+
+musicB = {
+ \clef bass
+ \new Voice {
+ \voiceTwo \relative c' {
+ <fis, a cis>4
+ \change Staff = up
+ cis'
+ \change Staff = down
+ <fis, a>
+ \change Staff = up
+ dis' |
+ \change Staff = down
+ <fis, a cis>4 gis <f a d>2 |
+ }
+ }
+}
+
+\new PianoStaff {
+ <<
+ \context Staff = "up" {
+ \key fis \minor
+ #(set-accidental-style 'teaching)
+ \musicA
+ }
+ \context Staff = "down" {
+ \key fis \minor
+ #(set-accidental-style 'teaching)
+ \musicB
+ }
+ >>
+}
+@end lilypond
+
+
+
@item no-reset
@funindex no-reset
@seealso
-
Snippets:
@rlsr{Pitches}.
@seealso
-
Music Glossary:
@rglos{ambitus}.
This section suggests ways of altering note heads.
@menu
-* Special note heads::
-* Easy notation note heads::
-* Shape note heads::
-* Improvisation::
+* Special note heads::
+* Easy notation note heads::
+* Shape note heads::
+* Improvisation::
@end menu
@node Special note heads
@noindent
To see all note head styles, see @ref{Note head styles}.
-@seealso
+@seealso
Snippets:
@rlsr{Pitches}.
}
@end lilypond
-@predefined
+@predefined
@funindex \easyHeadsOn
+@code{\easyHeadsOn},
@funindex \easyHeadsOff
-@code{\easyHeadsOn}, @code{\easyHeadsOff}
+@code{\easyHeadsOff}.
+@endpredefined
-@seealso
+@seealso
Notation Reference:
@ref{Setting the staff size}.
Shapes are typeset according to the step in the scale, where the
base of the scale is determined by the @code{\key} command.
-@predefined
+@predefined
@funindex \aikenHeads
+@code{\aikenHeads},
@funindex \sacredHarpHeads
-@code{\aikenHeads}, @code{\sacredHarpHeads}
+@code{\sacredHarpHeads}.
+@endpredefined
+
@snippets
@noindent
To see all note head styles, see @ref{Note head styles}.
-@seealso
+@seealso
Snippets:
@rlsr{Pitches}.
@predefined
-
@funindex \improvisationOn
+@code{\improvisationOn},
@funindex \improvisationOff
+@code{\improvisationOff}.
+@endpredefined
-@code{\improvisationOn}, @code{\improvisationOff}
@seealso
-
Snippets:
@rlsr{Pitches}.