From f4793cacccdab84d86c92d621cb55bb385b1244b Mon Sep 17 00:00:00 2001 From: Graham Percival Date: Sat, 10 Nov 2007 13:00:13 -0800 Subject: [PATCH] Eyolf's update for Pitches. --- Documentation/user/pitches.itely | 49 ++++++++++++-------------------- 1 file changed, 18 insertions(+), 31 deletions(-) diff --git a/Documentation/user/pitches.itely b/Documentation/user/pitches.itely index 19e4cfd463..2a2fdf0e6d 100644 --- a/Documentation/user/pitches.itely +++ b/Documentation/user/pitches.itely @@ -1,6 +1,6 @@ @c -*- coding: utf-8; mode: texinfo; -*- @ignore - Translation of GIT committish: FILL-IN-HEAD-COMMITTISH + Translation of GIT committish: FILL-IN-HEAD-COMMITTISH When revising a translation, copy the HEAD committish of the version that you are working on. See TRANSLATION for details. @@ -61,8 +61,6 @@ is more fundamental and will be presented first. @cindex Absolute @cindex Absolute octave specification -@c don't use @samp here because that might get confused with -@c octave marks In absolute mode, every note is placed explicitly in a certain octave. The note names @code{c} to @code{b} are engraved in the octave below middle C, as in the previous example. @@ -313,7 +311,7 @@ Micro tones are also exported to the MIDI file. In accordance with standard typesetting rules, a natural sign is printed before a sharp or flat if a previous accidental needs to -be cancelled. To change this behavior, use +be canceled. To change this behavior, use @lilypond[fragment,quote,ragged-right,verbatim,relative=2] ceses4 ces cis c @@ -1459,30 +1457,19 @@ problematic notes. @unnumberedsubsubsec Ambitus @cindex ambitus -The term @emph{ambitus} denotes a range of pitches for a given -voice in a part of music. It may also denote the pitch range that -a musical instrument is capable of playing. Ambits are printed on -vocal parts, so performers can easily determine it meets their -capabilities. +The term @notation{ambitus} or @notation{ambit} denotes a range of pitches +for a given voice in a part of music. It may also denote the +pitch range that a musical instrument is capable of playing. +Ambits are printed on vocal parts, so performers can easily +determine if it meets their capabilities. Ambits are denoted at the beginning of a piece near the initial clef. The range is graphically specified by two note heads that represent the minimum and maximum pitch. To print such ambits, add the @internalsref{Ambitus_engraver} to the -@internalsref{Voice} context, for example, - -@example -\layout @{ - \context @{ - \Voice - \consists Ambitus_engraver - @} -@} -@end example - -This results in the following output +@internalsref{Voice} context, for example: -@lilypond[quote,ragged-right] +@lilypond[quote,verbatim,ragged-right] \layout { \context { \Staff @@ -1496,10 +1483,9 @@ This results in the following output @end lilypond If you have multiple voices in a single staff and you want a -single ambitus per staff rather than per each voice, add the +single ambitus per staff rather than per voice, add the @internalsref{Ambitus_engraver} to the @internalsref{Staff} -context rather than to the @internalsref{Voice} context. Here is -an example, +context rather than to the @internalsref{Voice} context: @lilypond[verbatim,ragged-right,quote] \new Staff \with { @@ -1598,7 +1584,7 @@ Snippets: @lsrdir{pitches}, In shape note head notation, the shape of the note head corresponds to the harmonic function of a note in the scale. This -notation was popular in the 19th century American song books. +notation was popular in nineteenth-century American song books. Shape note heads can be produced by setting @code{\aikenHeads} or @code{\sacredHarpHeads}, depending on the style desired. @@ -1607,11 +1593,11 @@ Shape note heads can be produced by setting @code{\aikenHeads} or \aikenHeads c8 d4 e8 a2 g1 \sacredHarpHeads - c8 d4. e8 a2 g1 + c,8 d4. e8 a2 g1 @end lilypond -Shapes are determined on the step in the scale, where the base of -the scale is determined by the @code{\key} command +Shapes are typeset according to the step in the scale, where +the base of the scale is determined by the @code{\key} command. @funindex \key @funindex shapeNoteStyles @@ -1621,7 +1607,7 @@ the scale is determined by the @code{\key} command Shape note heads are implemented through the @code{shapeNoteStyles} property. Its value is a vector of symbols. The k-th element indicates the style to use for the k-th -step of the scale. Arbitrary combinations are possible, e.g. +step of the scale. Arbitrary combinations are possible, e.g.: @lilypond[verbatim,relative=1,fragment] \set shapeNoteStyles = @@ -1667,6 +1653,7 @@ used in the following example @seealso + Snippets: @lsrdir{pitches}, @@ -1680,7 +1667,7 @@ meanings -- crosses are used for @q{parlato} with vocalists, stopped notes on guitar; diamonds are used for harmonics on string instruments, etc. There is a shorthand (@code{\harmonic}) for diamond shapes; the other notehead styles are produced by tweaking -the property +the property @lilypond[ragged-right,relative=1,fragment,verbatim,quote] c4 d -- 2.39.5