Merge branch 'master' of git+ssh://jneem@git.sv.gnu.org/srv/git/lilypond into jneeman

[lilypond.git] / Documentation / user / instrument-notation.itely

diff --git a/Documentation/user/instrument-notation.itely b/Documentation/user/instrument-notation.itely
index 4be1671dea5586050a3aeed269836c3ae6bfdeb3..b6e400215be51950ba0aec2f18d9c031d7676162 100644 (file)
--- a/Documentation/user/instrument-notation.itely
+++ b/Documentation/user/instrument-notation.itely
@@ -57,11 +57,6 @@ Dynamics are not centered, but workarounds do exist.  See the
 @cindex stem, cross staff
 @cindex distance between staves in piano music
 
 @cindex stem, cross staff
 @cindex distance between staves in piano music
 

-The distance between the two staves is the same for all systems in the
-score.  It is possible to override this per system, but it does require
-an arcane command incantation.  See
-@inputfileref{input/@/test,piano@/-staff@/-distance@/.ly}.
-

 
 @node Automatic staff changes
 @subsection Automatic staff changes
 
 @node Automatic staff changes
 @subsection Automatic staff changes


@@ -226,7 +221,7 @@ c\sostenutoDown d e c, f g a\sostenutoUp
 
 @seealso
 
 
 @seealso
 

-In this manual: @ref{Laissez vibrer ties}
+In this manual: @ref{Laissez vibrer ties}.

 
 @node Staff switch lines
 @subsection Staff switch lines
 
 @node Staff switch lines
 @subsection Staff switch lines


@@ -274,7 +269,10 @@ of the stem in the lower staff, so it reaches the stem in the upper
 staff, or vice versa.
 
 @lilypond[ragged-right,verbatim,quote]
 staff, or vice versa.
 
 @lilypond[ragged-right,verbatim,quote]

-stemExtend = \once \override Stem #'length = #22
+stemExtend = {
+  \once \override Stem #'length = #10
+  \once \override Stem #'cross-staff = ##t
+}

 noFlag = \once \override Stem #'flag-style = #'no-flag
 \new PianoStaff <<
   \new Staff {
 noFlag = \once \override Stem #'flag-style = #'no-flag
 \new PianoStaff <<
   \new Staff {


@@ -427,7 +425,7 @@ Modifiers can be mixed with additions
 @funindex m
 
 Since an unaltered 11 does not sound good when combined with an
 @funindex m
 
 Since an unaltered 11 does not sound good when combined with an

-unaltered 3, the 11 is removed in this case (unless it is added
+unaltered 13, the 11 is removed in this case (unless it is added

 explicitly)
 @lilypond[quote,ragged-right,fragment,verbatim]
 \chordmode { c:13 c:13.11 c:m13 }
 explicitly)
 @lilypond[quote,ragged-right,fragment,verbatim]
 \chordmode { c:13 c:13.11 c:m13 }


@@ -443,7 +441,7 @@ as bass notes, can be specified by appending
 @end lilypond
 @funindex /+
 
 @end lilypond
 @funindex /+
 

-A bass note can be added instead transposed out of the chord,
+A bass note can be added instead of transposed out of the chord,

 by using @code{/+}@var{pitch}.
 
 @lilypond[quote,ragged-right,fragment,verbatim]
 by using @code{/+}@var{pitch}.
 
 @lilypond[quote,ragged-right,fragment,verbatim]


@@ -558,7 +556,7 @@ adds the new exceptions to the default ones, which are defined in
 @file{ly/@/chord@/-modifier@/-init@/.ly}.
 
 For an example of tuning this property, see also
 @file{ly/@/chord@/-modifier@/-init@/.ly}.
 
 For an example of tuning this property, see also

-@inputfileref{input/@/regression,chord@/-name@/-exceptions@/.ly}.
+@lsr{chords/,chord@/-name@/-exceptions@/.ly}

 @cindex exceptions, chord names.
 
 
 @cindex exceptions, chord names.
 
 


@@ -567,7 +565,7 @@ For an example of tuning this property, see also
 This property contains the markup object used for the 7th step, when
 it is major.  Predefined options are @code{whiteTriangleMarkup} and
 @code{blackTriangleMarkup}.  See
 This property contains the markup object used for the 7th step, when
 it is major.  Predefined options are @code{whiteTriangleMarkup} and
 @code{blackTriangleMarkup}.  See

-@inputfileref{input/@/regression,chord@/-name@/-major7@/.ly} for an example.
+@lsr{chords,chord@/-name@/-major7@/.ly} for an example.

 
 @funindex chordNameSeparator
 @item chordNameSeparator
 
 @funindex chordNameSeparator
 @item chordNameSeparator


@@ -640,8 +638,9 @@ chart}.  Turning on these styles is described in the input file
 
 @seealso
 
 
 @seealso
 

-Examples: @inputfileref{input/@/regression,chord@/-name@/-major7@/.ly},
-@inputfileref{input/@/regression,chord@/-name@/-exceptions@/.ly},
+Examples:
+@lsr{chords/,chord@/-name@/-exceptions@/.ly},
+@lsr{chords,chord@/-name@/-major7@/.ly}, and

 @inputfileref{input/@/test,chord@/-names@/-jazz@/.ly}.
 
 
 @inputfileref{input/@/test,chord@/-names@/-jazz@/.ly}.
 
 


@@ -819,7 +818,7 @@ glyph.
 To enter lyrics with characters from non-English languages, or with
 accented and special characters (such as the heart symbol or slanted quotes),
 simply insert the characters directly into the input file and save
 To enter lyrics with characters from non-English languages, or with
 accented and special characters (such as the heart symbol or slanted quotes),
 simply insert the characters directly into the input file and save

-it with utf-8 encoding.  See @ref{Text encoding} for more info.
+it with utf-8 encoding.  See @ref{Text encoding}, for more info.

 
 @lilypond[quote,ragged-right,fragment,verbatim]
 \relative { e4 f e d e f e2 }
 
 @lilypond[quote,ragged-right,fragment,verbatim]
 \relative { e4 f e d e f e2 }


@@ -1043,8 +1042,7 @@ A complete example of a SATB score setup is in section
 
 Program reference: @internalsref{Melisma_translator}.
 
 
 Program reference: @internalsref{Melisma_translator}.
 

-
-@inputfileref{input/@/regression,lyric@/-combine@/-new@/.ly}.
+@lsr{vocal,lyric@/-combine.ly}.

 
 @refbugs
 
 
 @refbugs
 


@@ -1363,7 +1361,7 @@ layout.
 
 @lilypond[relative,verbatim,quote,ragged-right]
 \score {
 
 @lilypond[relative,verbatim,quote,ragged-right]
 \score {

-  {
+  \relative c' {

   c c c c
   c c c c
   }
   c c c c
   c c c c
   }


@@ -1658,7 +1656,8 @@ Program reference: @internalsref{Ambitus},
 @internalsref{AmbitusLine}, @internalsref{AmbitusNoteHead},
 @internalsref{AmbitusAccidental}.
 
 @internalsref{AmbitusLine}, @internalsref{AmbitusNoteHead},
 @internalsref{AmbitusAccidental}.
 

-Examples: @inputfileref{input/@/regression,ambitus@/.ly}.
+Examples:
+@lsr{vocal,ambitus@/.ly}.

 
 @refbugs
 
 
 @refbugs
 


@@ -1719,8 +1718,6 @@ staff are squashed, and the staff itself has a single line
 
 Program reference: @internalsref{RhythmicStaff}.
 
 
 Program reference: @internalsref{RhythmicStaff}.
 

-Examples: @inputfileref{input/@/regression,rhythmic@/-staff@/.ly}.
-

 
 @node Entering percussion
 @subsection Entering percussion
 
 @node Entering percussion
 @subsection Entering percussion


@@ -2029,12 +2026,11 @@ with @code{\}@var{number},
 <c\1 e\2 g\3>
 @end lilypond
 
 <c\1 e\2 g\3>
 @end lilypond
 

-See also @inputfileref{input/regression,string-number.ly}.
-

 
 @seealso
 
 
 @seealso
 

-Program reference: @internalsref{StringNumber}.
+Program reference: @internalsref{StringNumber},
+@lsr{guitar/,string-number.ly}.

 
 
 @node Tablatures basic
 
 
 @node Tablatures basic


@@ -2310,7 +2306,7 @@ barring indications.
 \clef "G_8"
 b16 d16 g16 b16 e16
 \textSpannerDown
 \clef "G_8"
 b16 d16 g16 b16 e16
 \textSpannerDown

-\override TextSpanner #'edge-text = #'("XII " . "")
+\override TextSpanner #'bound-details #'left #'text = "XII "

   g16\startTextSpan
   b16 e16 g16 e16 b16 g16\stopTextSpan
 e16 b16 g16 d16
   g16\startTextSpan
   b16 e16 g16 e16 b16 g16\stopTextSpan
 e16 b16 g16 d16


@@ -2554,13 +2550,12 @@ the proper note heads, so there is no need to explicitly set the
 note head style.  Still, the note head style can be set, e.g., to
 @code{vaticana_punctum} to produce punctum neumes.  Similarly, a
 @internalsref{Mensural_ligature_engraver} is used to automatically
 note head style.  Still, the note head style can be set, e.g., to
 @code{vaticana_punctum} to produce punctum neumes.  Similarly, a
 @internalsref{Mensural_ligature_engraver} is used to automatically

-assemble mensural ligatures.  See @ref{Ligatures} for how ligature
+assemble mensural ligatures.  See @ref{Ligatures}, for how ligature

 engravers work.
 
 @seealso
 
 engravers work.
 
 @seealso
 

-Examples: @inputfileref{input/@/regression,note@/-head@/-style@/.ly} gives an
-overview over all available note head styles.
+@ref{Note head styles}, gives an overview over all available note head styles.

 
 
 @node Ancient accidentals
 
 
 @node Ancient accidentals


@@ -2623,9 +2618,9 @@ controlled by the @code{glyph-name-alist} property of the
 
 @seealso
 
 
 @seealso
 

-In this manual: @ref{Pitches}, @ref{Cautionary accidentals} and
-@ref{Automatic accidentals} give a general introduction of the use of
-accidentals.  @ref{Key signature} gives a general introduction of
+In this manual: @ref{Pitches}, @ref{Cautionary accidentals}, and
+@ref{Automatic accidentals}, give a general introduction of the use of
+accidentals.  @ref{Key signature}, gives a general introduction of

 the use of key signatures.
 
 Program reference: @internalsref{KeySignature}.
 the use of key signatures.
 
 Program reference: @internalsref{KeySignature}.


@@ -2665,7 +2660,7 @@ There are no rests in Gregorian Chant notation; instead, it uses
 
 @seealso
 
 
 @seealso
 

-In this manual: @ref{Rests} gives a general introduction into the use of
+In this manual: @ref{Rests}, gives a general introduction into the use of

 rests.
 
 
 rests.
 
 


@@ -3038,7 +3033,7 @@ The following examples show the differences in style,
 
 @seealso
 
 
 @seealso
 

-This manual: @ref{Time signature} gives a general introduction to
+This manual: @ref{Time signature}, gives a general introduction to

 the use of time signatures.
 
 @refbugs
 the use of time signatures.
 
 @refbugs


@@ -3169,7 +3164,8 @@ supported are @code{vaticana}, @code{medicaea}, @code{hufnagel}, and
 
 Program reference: @internalsref{Custos}.
 
 
 Program reference: @internalsref{Custos}.
 

-Examples: @inputfileref{input/@/regression,custos@/.ly}.
+Examples:
+@lsr{ancient,custodes@/.ly}.

 
 
 @node Divisiones
 
 
 @node Divisiones


@@ -4251,10 +4247,6 @@ underlies the construction of the ligatures in the above table is
 accordingly extrapolated.  This way, infinitely many different
 ligatures can be created.
 
 accordingly extrapolated.  This way, infinitely many different
 ligatures can be created.
 

-@c TODO: create a regression or tips & tricks example document with
-@c even more Gregorian ligatures, and add a link to this document
-@c here.
-

 Augmentum dots, also called @emph{morae}, are added with the music
 function @code{\augmentum}.  Note that @code{\augmentum} is
 implemented as a unary music function rather than as head prefix.  It
 Augmentum dots, also called @emph{morae}, are added with the music
 function @code{\augmentum}.  Note that @code{\augmentum} is
 implemented as a unary music function rather than as head prefix.  It