version that you are working on. See TRANSLATION for details.
@end ignore
-@c \version "2.11.61"
+@c \version "2.12.0"
@node Pitches
}
@end lilypond
+When @code{\relative} blocks are nested, the innermost
+@code{\relative} block applies.
+
+@lilypond[verbatim,quote]
+\relative c' {
+ c d e f
+ \relative c'' {
+ c d e f
+ }
+}
+@end lilypond
+
+@code{\relative} has no effect on @code{\chordmode} blocks.
+
+@lilypond[verbatim,quote]
+\new Staff {
+ \relative c''' {
+ \chordmode { c1 }
+ }
+ \chordmode { c1 }
+}
+@end lilypond
+
+@code{\relative} is not allowed inside of @code{\chordmode} blocks.
+
+Music inside a @code{\transpose} block is absolute unless a
+@code{\relative} is included.
+
+@lilypond[verbatim,quote]
+\relative c' {
+ d e
+ \transpose f g {
+ d e
+ \relative c' {
+ d e
+ }
+ }
+}
+@end lilypond
+
+
@cindex chords and relative octave entry
@cindex relative octave entry and chords
@funindex relative
-@knownissues
-
-The relative conversion will not affect @code{\transpose},
-@code{\chordmode} or @code{\relative} sections in its argument.
-To use relative mode within transposed music, an additional
-@code{\relative} must be placed inside @code{\transpose}.
-
@c DEPRECATED
If no @var{startpitch} is specified for @code{\relative},
then@tie{}@code{c'} is assumed. However, this is a deprecated
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.
+file listed below. For example, to use English note names, add
+@code{@w{\include "english.ly"}} to the input file.
+
+@warning{Because some other include files (such as @code{@w{predefined-fretboards.ly}})
+use default (Nederlands) note names, the @code{@bs{}include}
+command for the language file should be placed after all other
+LilyPond distribution files.}
The available language files and the note names they define are:
@tab -s/-sharp @tab -f/-flat @tab -ss/-x/-sharpsharp
@tab -ff/-flatflat
@item @file{espanol.ly}
- @tab -s @tab -b @tab -ss @tab -bb
+ @tab -s @tab -b @tab -ss/-x @tab -bb
@item @file{italiano.ly}
@tab -d @tab -b @tab -dd @tab -bb
@item @file{norsk.ly}
@tab -ih @tab -eh @tab -isih @tab -eseh
@item @file{english.ly}
@tab -qs @tab -qf @tab -tqs @tab -tqf
+@item @file{espanol.ly}
+ @tab -cs @tab -cb @tab -tcs @tab -tcb
@item @file{italiano.ly}
@tab -sd @tab -sb @tab -dsd @tab -bsb
@item @file{portugues.ly}
other note is transposed by the same interval. Both pitches are
entered in absolute mode.
+@warning{Music inside a @code{@bs{}transpose} block is absolute
+unless a @code{@bs{}relative} is included in the block.}
+
Consider a piece written in the key of D-major. It can be
transposed up to E-major; note that the key signature is
automatically transposed as well.
@seealso
Notation Reference:
+@ref{Relative octave entry},
@ref{Instrument transpositions}.
Snippets:
To use relative mode within transposed music, an additional
@code{\relative} must be placed inside @code{\transpose}.
-
@node Displaying pitches
@subsection Displaying pitches
c2 c
\clef tab
c2 c
+
+\break
+
+\clef G
+c2 c
+\clef F
+c2 c
+\clef C
+c2 c
+
@end lilypond
Further supported clefs are described under @ref{Mensural clefs}
\new GrandStaff <<
\new Staff = "violin" {
\relative c'' {
- \set Staff.instrumentName = "Vln"
- \set Staff.midiInstrument = "violin"
+ \set Staff.instrumentName = #"Vln"
+ \set Staff.midiInstrument = #"violin"
% not strictly necessary, but a good reminder
\transposition c'
\new Staff = "clarinet" {
\relative c'' {
\set Staff.instrumentName = \markup { Cl (B\flat) }
- \set Staff.midiInstrument = "clarinet"
+ \set Staff.midiInstrument = #"clarinet"
\transposition bes
\key d \major
clarinet.
@lilypond[verbatim,quote,relative=2]
-\set Staff.instrumentName = "Cl (A)"
+\set Staff.instrumentName = #"Cl (A)"
\key a \major
\transposition a
c d e f