Doc: standardize direction commands.

diff --git a/Documentation/user/changing-defaults.itely b/Documentation/user/changing-defaults.itely
index 708930637ae6ab750398a39826f543e97d74e9de..ddd54fcd57d04f8366f4bac0c0b05367e63ff662 100644 (file)
--- 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 556db2dc66bfefb0509d60192719ad8d3560e048..eec43dd741bcd24dada7446df197e6d452cecd9b 100644 (file)
--- 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 129edfa528c9b29d7a97a0bedce09f423241cca8..56904b0067206e54fbdb1b3098d45101105e8ae7 100644 (file)
--- 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 d38bda3ba6c7eb375eee4184388e2de3fdde92b8..9c2fa9eebee1a3fd31c2a41f50e4e86aefea435b 100644 (file)
--- 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 a6638313447428b4664b844eb94886ca1ee92ed4..516fd1e996ee114cfc34356e002f35cd0d06436a 100644 (file)
--- 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}.