From 46482aa732210ffca145aa7f5077118b81ef0f68 Mon Sep 17 00:00:00 2001 From: Graham Percival Date: Wed, 7 Nov 2007 08:06:18 -0800 Subject: [PATCH] Reorg, educational->editorial. --- Documentation/user/educational.itely | 177 ++++++--------------------- Documentation/user/expressive.itely | 34 ----- Documentation/user/notation.itely | 2 +- Documentation/user/pitches.itely | 139 +++++++++++++++++++++ 4 files changed, 176 insertions(+), 176 deletions(-) diff --git a/Documentation/user/educational.itely b/Documentation/user/educational.itely index 94ba066688..7765be81bd 100644 --- a/Documentation/user/educational.itely +++ b/Documentation/user/educational.itely @@ -6,154 +6,15 @@ version that you are working on. See TRANSLATION for details. @end ignore -@node Educational use -@section Educational use +@node Editorial annotations +@section Editorial annotations @menu -* Note heads:: * Inside the staff:: * Outside the staff:: @end menu -@node Note heads -@subsection Note heads - -@menu -* Easy notation note heads:: -* Shape note heads:: -* Improvisation:: -* Special noteheads:: -@end menu - -@node Easy notation note heads -@unnumberedsubsubsec Easy notation note heads - -@cindex note heads, practice -@cindex note heads, easy notation -@cindex easy notation -@cindex Hal Leonard - -The @q{easy play} note head includes a note name inside the head. -It is used in music for beginners - -@lilypond[quote,ragged-right,verbatim,fragment,staffsize=26] - \setEasyHeads - c'2 e'4 f' | g'1 -@end lilypond - -The command @code{\setEasyHeads} overrides settings for the -@internalsref{NoteHead} object. To make the letters readable, it -has to be printed in a large font size. To print with a larger -font, see @ref{Setting the staff size}. - -@refcommands - -@funindex \setEasyHeads -@code{\setEasyHeads} - - -@node Shape note heads -@unnumberedsubsubsec Shape note heads - -@cindex note heads, shape - -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. - -Shape note heads can be produced by setting @code{\aikenHeads} or -@code{\sacredHarpHeads}, depending on the style desired. - -@lilypond[verbatim,relative=1,fragment] - \aikenHeads - c8 d4 e8 a2 g1 - \sacredHarpHeads - c8 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 - -@funindex \key -@funindex shapeNoteStyles -@funindex \aikenHeads -@funindex \sacredHarpHeads - -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. - -@lilypond[verbatim,relative=1,fragment] -\set shapeNoteStyles = - ##(cross triangle fa #f mensural xcircle diamond) -c8 d4. e8 a2 g1 -@end lilypond - - -@node Improvisation -@unnumberedsubsubsec Improvisation - -Improvisation is sometimes denoted with slashed note heads. Such -note heads can be created by adding a -@internalsref{Pitch_squash_engraver} to the @internalsref{Voice} -context. Then, the following command - -@example -\set squashedPosition = #0 -\override NoteHead #'style = #'slash -@end example - -@noindent -switches on the slashes. - -There are shortcuts @code{\improvisationOn} (and an accompanying -@code{\improvisationOff}) for this command sequence. They are -used in the following example - -@lilypond[verbatim,ragged-right,quote] -\new Voice \with { - \consists Pitch_squash_engraver -} \transpose c c' { - e8 e g a a16(bes)(a8) g \improvisationOn - e8 - ~e2~e8 f4 fis8 - ~fis2 \improvisationOff a16(bes) a8 g e -} -@end lilypond - - -@node Special noteheads -@unnumberedsubsubsec Special noteheads - -@cindex note heads, special - -Different noteheads are used by various instruments for various -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 - -@lilypond[ragged-right,relative=1,fragment,verbatim,quote] -c4 d -\override NoteHead #'style = #'cross -e f -\revert NoteHead #'style -e d -@end lilypond - -@noindent -To see all notehead styles, please see @ref{Note head styles}. - - -@seealso - -Internals Reference: @internalsref{NoteHead}. - - - @node Inside the staff @subsection Inside the staff @@ -463,6 +324,7 @@ a4 b c b * Balloon help:: * Grid lines:: * Blank music sheet:: +* Analysis brackets:: @end menu @node Balloon help @@ -571,4 +433,37 @@ emptymusic = { @end lilypond +@node Analysis brackets +@unnumberedsubsubsec Analysis brackets + +@cindex brackets +@cindex phrasing brackets +@cindex musicological analysis +@cindex note grouping bracket + +Brackets are used in musical analysis to indicate structure in +musical pieces. LilyPond supports a simple form of nested +horizontal brackets. To use this, add the +@internalsref{Horizontal_bracket_engraver} to the +@internalsref{Staff} context. A bracket is started with +@code{\startGroup} and closed with @code{\stopGroup}. + +@lilypond[quote,ragged-right,verbatim] +\score { + \relative c'' { + c4\startGroup\startGroup + c4\stopGroup + c4\startGroup + c4\stopGroup\stopGroup + } + \layout { + \context { + \Staff \consists "Horizontal_bracket_engraver" +}}} +@end lilypond + +@seealso + +Internals Reference: @internalsref{HorizontalBracket}. + diff --git a/Documentation/user/expressive.itely b/Documentation/user/expressive.itely index 9a938f6368..49ea563bf1 100644 --- a/Documentation/user/expressive.itely +++ b/Documentation/user/expressive.itely @@ -518,7 +518,6 @@ c4-\bendAfter #-3 * Glissando:: * Arpeggio:: * Trills:: -* Analysis brackets:: @end menu @node Glissando @@ -743,38 +742,5 @@ printed as a stemless note head in parentheses. Internals Reference: @internalsref{TrillSpanner}. -@node Analysis brackets -@unnumberedsubsubsec Analysis brackets - -@cindex brackets -@cindex phrasing brackets -@cindex musicological analysis -@cindex note grouping bracket - -Brackets are used in musical analysis to indicate structure in -musical pieces. LilyPond supports a simple form of nested -horizontal brackets. To use this, add the -@internalsref{Horizontal_bracket_engraver} to the -@internalsref{Staff} context. A bracket is started with -@code{\startGroup} and closed with @code{\stopGroup}. - -@lilypond[quote,ragged-right,verbatim] -\score { - \relative c'' { - c4\startGroup\startGroup - c4\stopGroup - c4\startGroup - c4\stopGroup\stopGroup - } - \layout { - \context { - \Staff \consists "Horizontal_bracket_engraver" -}}} -@end lilypond - -@seealso - -Internals Reference: @internalsref{HorizontalBracket}. - diff --git a/Documentation/user/notation.itely b/Documentation/user/notation.itely index 98b4f03347..5e15d30923 100644 --- a/Documentation/user/notation.itely +++ b/Documentation/user/notation.itely @@ -18,7 +18,7 @@ This chapter explains how to create musical notation. * Repeats:: Repeat music. * Simultaneous notes:: More than one note at once. * Staff notation:: Displaying staves. -* Educational use:: Special notation to increase legibility. +* Editorial annotations:: Special notation to increase legibility. * Text:: Adding text to scores. @end menu diff --git a/Documentation/user/pitches.itely b/Documentation/user/pitches.itely index 2ec99f7652..ded21ee6a7 100644 --- a/Documentation/user/pitches.itely +++ b/Documentation/user/pitches.itely @@ -20,6 +20,7 @@ are three steps to this process: input, modifying, and output. * Writing pitches:: * Changing multiple pitches:: * Displaying pitches:: +* Note heads:: @end menu @@ -1546,5 +1547,143 @@ There is no collision handling in the case of multiple per-voice ambitus. +@node Note heads +@subsection Note heads + +@menu +* Easy notation note heads:: +* Shape note heads:: +* Improvisation:: +* Special noteheads:: +@end menu + +@node Easy notation note heads +@unnumberedsubsubsec Easy notation note heads + +@cindex note heads, practice +@cindex note heads, easy notation +@cindex easy notation +@cindex Hal Leonard + +The @q{easy play} note head includes a note name inside the head. +It is used in music for beginners + +@lilypond[quote,ragged-right,verbatim,fragment,staffsize=26] + \setEasyHeads + c'2 e'4 f' | g'1 +@end lilypond + +The command @code{\setEasyHeads} overrides settings for the +@internalsref{NoteHead} object. To make the letters readable, it +has to be printed in a large font size. To print with a larger +font, see @ref{Setting the staff size}. + +@refcommands + +@funindex \setEasyHeads +@code{\setEasyHeads} + + +@node Shape note heads +@unnumberedsubsubsec Shape note heads + +@cindex note heads, shape + +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. + +Shape note heads can be produced by setting @code{\aikenHeads} or +@code{\sacredHarpHeads}, depending on the style desired. + +@lilypond[verbatim,relative=1,fragment] + \aikenHeads + c8 d4 e8 a2 g1 + \sacredHarpHeads + c8 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 + +@funindex \key +@funindex shapeNoteStyles +@funindex \aikenHeads +@funindex \sacredHarpHeads + +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. + +@lilypond[verbatim,relative=1,fragment] +\set shapeNoteStyles = + ##(cross triangle fa #f mensural xcircle diamond) +c8 d4. e8 a2 g1 +@end lilypond + + +@node Improvisation +@unnumberedsubsubsec Improvisation + +Improvisation is sometimes denoted with slashed note heads. Such +note heads can be created by adding a +@internalsref{Pitch_squash_engraver} to the @internalsref{Voice} +context. Then, the following command + +@example +\set squashedPosition = #0 +\override NoteHead #'style = #'slash +@end example + +@noindent +switches on the slashes. + +There are shortcuts @code{\improvisationOn} (and an accompanying +@code{\improvisationOff}) for this command sequence. They are +used in the following example + +@lilypond[verbatim,ragged-right,quote] +\new Voice \with { + \consists Pitch_squash_engraver +} \transpose c c' { + e8 e g a a16(bes)(a8) g \improvisationOn + e8 + ~e2~e8 f4 fis8 + ~fis2 \improvisationOff a16(bes) a8 g e +} +@end lilypond + + +@node Special noteheads +@unnumberedsubsubsec Special noteheads + +@cindex note heads, special + +Different noteheads are used by various instruments for various +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 + +@lilypond[ragged-right,relative=1,fragment,verbatim,quote] +c4 d +\override NoteHead #'style = #'cross +e f +\revert NoteHead #'style +e d +@end lilypond + +@noindent +To see all notehead styles, please see @ref{Note head styles}. + + +@seealso + +Internals Reference: @internalsref{NoteHead}. + + + -- 2.39.5