]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/user/instrument-notation.itely
Merge branch 'master' of git+ssh://jneem@git.sv.gnu.org/srv/git/lilypond into jneeman
[lilypond.git] / Documentation / user / instrument-notation.itely
index 4be1671dea5586050a3aeed269836c3ae6bfdeb3..b6e400215be51950ba0aec2f18d9c031d7676162 100644 (file)
@@ -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
 
-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
@@ -226,7 +221,7 @@ c\sostenutoDown d e c, f g a\sostenutoUp
 
 @seealso
 
-In this manual: @ref{Laissez vibrer ties}
+In this manual: @ref{Laissez vibrer ties}.
 
 @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]
-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 {
@@ -427,7 +425,7 @@ Modifiers can be mixed with additions
 @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 }
@@ -443,7 +441,7 @@ as bass notes, can be specified by appending
 @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]
@@ -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
-@inputfileref{input/@/regression,chord@/-name@/-exceptions@/.ly}.
+@lsr{chords/,chord@/-name@/-exceptions@/.ly}
 @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
-@inputfileref{input/@/regression,chord@/-name@/-major7@/.ly} for an example.
+@lsr{chords,chord@/-name@/-major7@/.ly} for an example.
 
 @funindex chordNameSeparator
 @item chordNameSeparator
@@ -640,8 +638,9 @@ chart}.  Turning on these styles is described in the input file
 
 @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}.
 
 
@@ -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
-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 }
@@ -1043,8 +1042,7 @@ A complete example of a SATB score setup is in section
 
 Program reference: @internalsref{Melisma_translator}.
 
-
-@inputfileref{input/@/regression,lyric@/-combine@/-new@/.ly}.
+@lsr{vocal,lyric@/-combine.ly}.
 
 @refbugs
 
@@ -1363,7 +1361,7 @@ layout.
 
 @lilypond[relative,verbatim,quote,ragged-right]
 \score {
-  {
+  \relative c' {
   c c c c
   c c c c
   }
@@ -1658,7 +1656,8 @@ Program reference: @internalsref{Ambitus},
 @internalsref{AmbitusLine}, @internalsref{AmbitusNoteHead},
 @internalsref{AmbitusAccidental}.
 
-Examples: @inputfileref{input/@/regression,ambitus@/.ly}.
+Examples:
+@lsr{vocal,ambitus@/.ly}.
 
 @refbugs
 
@@ -1719,8 +1718,6 @@ staff are squashed, and the staff itself has a single line
 
 Program reference: @internalsref{RhythmicStaff}.
 
-Examples: @inputfileref{input/@/regression,rhythmic@/-staff@/.ly}.
-
 
 @node Entering percussion
 @subsection Entering percussion
@@ -2029,12 +2026,11 @@ with @code{\}@var{number},
 <c\1 e\2 g\3>
 @end lilypond
 
-See also @inputfileref{input/regression,string-number.ly}.
-
 
 @seealso
 
-Program reference: @internalsref{StringNumber}.
+Program reference: @internalsref{StringNumber},
+@lsr{guitar/,string-number.ly}.
 
 
 @node Tablatures basic
@@ -2310,7 +2306,7 @@ barring indications.
 \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
@@ -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
-assemble mensural ligatures.  See @ref{Ligatures} for how ligature
+assemble mensural ligatures.  See @ref{Ligatures}, for how ligature
 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
@@ -2623,9 +2618,9 @@ controlled by the @code{glyph-name-alist} property of the
 
 @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}.
@@ -2665,7 +2660,7 @@ There are no rests in Gregorian Chant notation; instead, it uses
 
 @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.
 
 
@@ -3038,7 +3033,7 @@ The following examples show the differences in style,
 
 @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
@@ -3169,7 +3164,8 @@ supported are @code{vaticana}, @code{medicaea}, @code{hufnagel}, and
 
 Program reference: @internalsref{Custos}.
 
-Examples: @inputfileref{input/@/regression,custos@/.ly}.
+Examples:
+@lsr{ancient,custodes@/.ly}.
 
 
 @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.
 
-@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