From 7d9dcacdb5c5707afe147765e34123e0165ce898 Mon Sep 17 00:00:00 2001 From: Graham Percival Date: Fri, 10 Jul 2009 23:31:44 -0700 Subject: [PATCH] Doc: standardize direction commands. --- Documentation/user/changing-defaults.itely | 20 +++++++++++++++++ Documentation/user/editorial.itely | 3 +++ Documentation/user/expressive.itely | 26 +++++----------------- Documentation/user/rhythms.itely | 14 +++++------- Documentation/user/text.itely | 17 ++++++++------ 5 files changed, 45 insertions(+), 35 deletions(-) diff --git a/Documentation/user/changing-defaults.itely b/Documentation/user/changing-defaults.itely index 708930637a..ddd54fcd57 100644 --- a/Documentation/user/changing-defaults.itely +++ b/Documentation/user/changing-defaults.itely @@ -1951,6 +1951,15 @@ indicator is @strong{always} required before @item articulation shortcuts, e.g. @code{-.}, @code{->}, @code{--} @end itemize +These indications affect only the next note. + +@lilypond[verbatim,quote,relative=2] +c2( c) +c2_( c) +c2( c) +c2^( c) +@end lilypond + @strong{The direction property} The position or direction of many layout objects is controlled @@ -1988,6 +1997,17 @@ TrillPitchAccidental - not tried TrillPitchGroup - not tried @end ignore +These indications affect all notes until they are cancelled. + +@lilypond[verbatim,quote,relative=2] +c2( c) +\slurDown +c2( c) +c2( c) +\slurNeutral +c2( c) +@end lilypond + @node Distances and measurements diff --git a/Documentation/user/editorial.itely b/Documentation/user/editorial.itely index 556db2dc66..eec43dd741 100644 --- a/Documentation/user/editorial.itely +++ b/Documentation/user/editorial.itely @@ -451,6 +451,9 @@ Whenever a note is found, a @code{Stem} object is created automatically. For whole notes and rests, they are also created but made invisible. +Stems may be manually placed to point up or down; see +@ref{Direction and placement}. + @predefined @code{\stemUp}, diff --git a/Documentation/user/expressive.itely b/Documentation/user/expressive.itely index 129edfa528..56904b0067 100644 --- a/Documentation/user/expressive.itely +++ b/Documentation/user/expressive.itely @@ -107,7 +107,7 @@ c4-> c-. c2-_ The rules for the default placement of articulations are defined in @file{scm/@/script@/.scm}. Articulations and ornamentations -may be manually placed above or below the staff, see +may be manually placed above or below the staff; see @ref{Direction and placement}. @@ -194,9 +194,9 @@ such as @code{c4\ff}. The available dynamic marks are @code{\ppppp}, @code{\pppp}, @code{\ppp}, @code{\pp}, @code{\p}, @code{\mp}, @code{\mf}, @code{\f}, @code{\ff}, @code{\fff}, @code{\ffff}, @code{\fp}, @code{\sf}, @code{\sff}, @code{\sp}, -@code{\spp}, @code{\sfz}, and @code{\rfz}. The dynamic marks may -be manually placed above or below the staff, see -@ref{Direction and placement}. +@code{\spp}, @code{\sfz}, and @code{\rfz}. Dynamic marks may be +manually placed above or below the staff; see @ref{Direction and +placement}. @lilypond[verbatim,quote,relative=2] c2\ppp c\mp @@ -522,17 +522,9 @@ a4 g2 f4) @funindex \slurNeutral @funindex slurNeutral -Slurs may be manually placed above or below the notes, see +Slurs may be manually placed above or below the staff; see @ref{Direction and placement}. -@lilypond[verbatim,quote,relative=2] -c2( d) -\slurDown -c2( d) -\slurNeutral -c2( d) -@end lilypond - @cindex phrasing slur @cindex multiple slurs @cindex simultaneous slurs @@ -685,15 +677,9 @@ e2) d\) Typographically, a phrasing slur behaves almost exactly like a normal slur. However, they are treated as different objects; a @code{\slurUp} will have no effect on a phrasing slur. Phrasing -slurs may be manually placed above or below the notes, see +may be manually placed above or below the staff; see @ref{Direction and placement}. -@lilypond[verbatim,quote,relative=1] -c4\( g' c,( b) | c1\) -\phrasingSlurUp -c4\( g' c,( b) | c1\) -@end lilypond - @cindex simultaneous phrasing slurs @cindex multiple phrasing slurs @cindex slur, simultaneous phrasing diff --git a/Documentation/user/rhythms.itely b/Documentation/user/rhythms.itely index d38bda3ba6..9c2fa9eebe 100644 --- a/Documentation/user/rhythms.itely +++ b/Documentation/user/rhythms.itely @@ -127,12 +127,12 @@ proportional notation, see @ref{Proportional notation}. @funindex dotsNeutral Dots are normally moved up to avoid staff lines, except in -polyphonic situations. Predefined commands are available to -force a particular direction manually, for details -see @ref{Direction and placement}. +polyphonic situations. Dots may be manually placed above or below +the staff; see @ref{Direction and placement}. @predefined +@code{\autoBeamOn}, @code{\autoBeamOff}, @code{\dotsUp}, @code{\dotsDown}, @@ -211,9 +211,8 @@ c4 c \times 2/3 { b4 a g } @funindex \tupletNeutral @funindex tupletNeutral -The automatic placement of the tuplet bracket above or below the -notes may be overridden manually with predefined commands, for -details see @ref{Direction and placement}. +Tuplet brackets may be manually placed above or below the staff; +see @ref{Direction and placement}. Tuplets may be nested: @@ -464,8 +463,7 @@ be entered as follows: @funindex \tieNeutral @funindex tieNeutral -The vertical placement of ties may be controlled, see -Predefined commands, or for details, see +Ties may be manually placed above or below the staff; see @ref{Direction and placement}. @cindex ties, appearance diff --git a/Documentation/user/text.itely b/Documentation/user/text.itely index a663831344..516fd1e996 100644 --- a/Documentation/user/text.itely +++ b/Documentation/user/text.itely @@ -53,12 +53,7 @@ information, see @ref{Text encoding}.} @cindex non-empty texts @cindex quoted text -Simple @qq{quoted text} indications may be added -to a score, as demonstrated in the following example. -Such indications may be manually placed -above or below the staff, using the -syntax described in @ref{Direction and -placement}. +Simple @qq{quoted text} indications may be added to a score. @lilypond[quote,verbatim,relative=2] a8^"pizz." g f e a4-"scherz." f @@ -73,6 +68,10 @@ a8^\markup { \italic pizz. } g f e a4_\markup { \tiny scherz. \bold molto } f @end lilypond +@qq{Quoted text} and @code{\markup} commands may be manually +placed above or below the staff; see @ref{Direction and +placement}. + By default, text indications do not influence the note spacing. However, their widths can be taken into account: in the following example, the first text string does not affect @@ -150,6 +149,9 @@ e,\stopTextSpan The line style, as well as the text string, can be defined as an object property. This syntax is described in @ref{Line styles}. +Text spanners may be manually placed above or below the staff; see +@ref{Direction and placement}. + @predefined @funindex textSpannerUp @@ -164,7 +166,8 @@ object property. This syntax is described in @ref{Line styles}. @seealso Notation Reference: @ref{Line styles}, -@ref{Dynamics}. +@ref{Dynamics}, +@ref{Direction and placement}. Snippets: @rlsr{Text}. -- 2.39.5