version that you are working on. See TRANSLATION for details.
@end ignore
-@c \version "2.11.38"
+@c \version "2.11.51"
@node Fretted string instruments
@section Fretted string instruments
@node References for fretted strings
@subsubsection References for fretted strings
-@c TODO Add refs
-TBC
+@itemize
+@item Fingerings are indicated with @ref{Fingering instructions}.
+
+@item Instructions for @notation{Laissez vibrer} ties
+as well as ties on arpeggios and tremolos is described in
+@ref{Ties}.
+
+@item Instructions on handling multiple voices is described
+in @ref{Collision resolution}.
+
+@end itemize
+
+@seealso
+
+Notation Reference:
+@ref{Instrument names},
+@ref{Writing music in parallel},
+@ref{Fingering instructions},
+@ref{Ties},
+@ref{Arpeggio},
+@ref{List of articulations},
+@ref{Clef}.
@node String number indications
@subsubsection String number indications
@cindex String numbers
The string on which a note should be played may be indicated by
-appending @code{\}@tie{}@var{number} to a note inside a chord
-construct (@code{<>}).
+appending @code{\@var{number}} to a note inside a chord construct
+@code{<>}.
@warning{String numbers @strong{must} be defined inside a chord
construct even if there is only a single note.}
-@lilypond[verbatim,quote,relative=2]
+@lilypond[verbatim,quote,relative=1]
<c\5>4 <e\4> <g\3>2
<c,\5 e\4 g\3>1
@end lilypond
-Although fingering is covered in detail elsewhere, it is worth noting
-here how fingerings and string indications behave together, since
-guitar music often incorporates both at once. The usual convention
-is to place the fingering closest to the note, then the string
-indication outside the fingering. This is controlled by the order in
-which the two items appear:
+When fingerings and string indications are used together, their
+placement is controlled by the order in which the two items appear
+in the code:
@lilypond[verbatim,quote,relative=2]
<g\3-0>2
@end lilypond
@snippets
-
-@ignore
-@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{controlling-the-placement-of-chord-fingerings.ly}
-@end ignore
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{allowing-fingerings-to-be-printed-inside-the-staff.ly}
@seealso
-Internals Reference: @rinternals{StringNumber},
-@c @lsr{guitar/,string-number.ly}.
+Snippets:
+@rlsr{Fretted strings}.
+
+Notation Reference:
+@ref{Fingering instructions}.
+
+Internals Reference:
+@rinternals{StringNumber},
+@rinternals{Fingering}.
+
@node Default tablatures
numbers indicating on which string and fret a note must be played.
LilyPond offers limited support for tablature.
-The string number associated to a note is given as a backslash
-followed by a number, e.g., @code{c4\3} for a C quarter on the third
-string. By default, string 1 is the highest one, and the tuning
-defaults to the standard guitar tuning (with 6 strings). The notes
-are printed as tablature, by using @rinternals{TabStaff} and
-@rinternals{TabVoice} contexts
+The string number associated with a note is given as a backslash
+followed by a number. By default, string 1 is the highest,
+and the tuning defaults to the standard guitar tuning (with 6 strings).
+The notes are printed as tablature, by using @code{TabStaff} and
+@code{TabVoice} contexts
@lilypond[quote,ragged-right,fragment,verbatim]
\new TabStaff {
@funindex minimumFret
@cindex fret
-When no string is specified, the first string that does not give a
-fret number less than @code{minimumFret} is selected. The default
-value for @code{minimumFret} is 0
+When no string is specified for a note, the note is assigned to the lowest string
+that can generate the note with a fret number greater than or equal to
+@code{minimumFret} is selected. The default value for @code{minimumFret} is 0.
-@example
-e16 fis gis a b4
-\set TabStaff.minimumFret = #8
-e16 fis gis a b4
-@end example
-@lilypond[quote,ragged-right]
-frag = {
- \key e \major
- e16 fis gis a b4
- \set TabStaff.minimumFret = #8
- e16 fis gis a b4
-}
- \new StaffGroup <<
- \new Staff { \clef "G_8" \frag }
- \new TabStaff { \frag }
- >>
+@lilypond[quote,ragged-right,verbatim]
+\new StaffGroup <<
+ \new Staff \relative c' {
+ c16 d e f g4
+ c,16 d e f g4
+ }
+ \new TabStaff \relative c {
+ c16 d e f g4
+ \set TabStaff.minimumFret = #5
+ c,16 d e f g4
+ }
+>>
@end lilypond
-
@snippets
-To print tablatures with stems down and horizontal beams,
-initialize the @code{TabStaff} with this code:
+The direction of stems is controlled the same way in tablature as
+in traditional notation. Beams can be made horizontal:
-@example
-\stemDown
-\override Beam #'damping = #100000
-@end example
+@lilypond[quote,ragged-right,verbatim]
+\new TabStaff {
+ \relative c {
+ g16 b d g
+ b d g b
+ \stemDown
+ \override Beam #'damping = #100000
+ g,,16 b d g
+ b d g b
+ }
+}
+@end lilypond
@seealso
-Internals Reference: @rinternals{TabNoteHead}, @rinternals{TabStaff}, @rinternals{TabVoice}.
+Snippets:
+@rlsr{Fretted strings}.
+
+Notation Reference:
+@ref{Stems}
+
+Internals Reference:
+@rinternals{TabNoteHead},
+
+@rinternals{TabStaff},
+
+@rinternals{TabVoice},
+
+@rinternals{Beam}.
@knownissues
Chords are not handled in a special way, and hence the automatic
-string selector may easily select the same string to two notes in a
+string selector may easily select the same string for two notes in a
chord.
In order to handle @code{\partcombine}, a @code{TabStaff} must use
@seealso
+Snippets:
+@rlsr{Fretted strings}.
+
The file @file{scm/@/output@/-lib@/.scm} contains the predefined string
tunings.
Internals Reference: @rinternals{Tab_note_heads_engraver}.
@seealso
-
+Snippets:
+@rlsr{Fretted strings}.
@node Right hand fingerings
@subsubsection Right hand fingerings
@code{<@var{note}-\rightHandFinger @var{finger} >}.
The right-hand fingering indication must occur within a @code{<>} chord
construct for it to be printed in the score, even if it is a single note.
-There must be a hyphen after the note and the space
-before the closing @code{>}.
+There must be a hyphen after the note and a space before the closing @code{>}.
@lilypond[quote,ragged-right,fragment,verbatim]
}
@end lilypond
-for brevity, you can abbreviate @code{\rightHandFinger} to something
+For convenience, you can abbreviate @code{\rightHandFinger} to something
short, for example @code{RH},
@example
@seealso
-Internals Reference: @rinternals{StrokeFinger}
+Snippets:
+@rlsr{Fretted strings}.
+
+Internals Reference:
+@rinternals{StrokeFinger}.
@node Guitar
pitch. It is notated with cross note heads; this is
demonstrated in @ref{Special note heads}.
+@seealso
+
+Snippets:
+@rlsr{Fretted strings}.
@node Banjo
@subsection Banjo
@seealso
-The file @file{scm/@/output@/-lib@/.scm} contains predefined banjo tunings.
-
+Snippets:
+@rlsr{Fretted strings}.
+The file @file{scm/@/output@/-lib@/.scm} contains predefined banjo tunings.