Run scripts/auxiliar/update-with-convert-ly.sh

[lilypond.git] / Documentation / notation / fretted-strings.itely

diff --git a/Documentation/notation/fretted-strings.itely b/Documentation/notation/fretted-strings.itely
index f01e968b13c40a97e87acc3c6bfffaef58836f7f..e3882f912d81ea5d8cfd192e6d08e16c21f4b9ed 100644 (file)
--- a/Documentation/notation/fretted-strings.itely
+++ b/Documentation/notation/fretted-strings.itely
@@ -7,7 +7,7 @@
     Guide, node Updating translation committishes..
 @end ignore
 
     Guide, node Updating translation committishes..
 @end ignore
 

-@c \version "2.15.16"
+@c \version "2.19.21"

 
 @node Fretted string instruments
 @section Fretted string instruments
 
 @node Fretted string instruments
 @section Fretted string instruments


@@ -76,7 +76,6 @@ in @ref{Collision resolution}.
 
 @end itemize
 
 
 @end itemize
 

-

 @seealso
 Notation Reference:
 @ref{Fingering instructions},
 @seealso
 Notation Reference:
 @ref{Fingering instructions},


@@ -98,28 +97,43 @@ Notation Reference:
 @cindex fingering vs. string numbers
 
 The string on which a note should be played may be indicated by
 @cindex fingering vs. string numbers
 
 The string on which a note should be played may be indicated by

-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.}
+appending @code{\@var{number}} to a note.

 
 @lilypond[verbatim,quote,relative=0]
 \clef "treble_8"
 
 @lilypond[verbatim,quote,relative=0]
 \clef "treble_8"

-<c\5>4 <e\4> <g\3>2
+c4\5 e\4 g2\3

 <c,\5 e\4 g\3>1
 @end lilypond
 
 When fingerings and string indications are used together, their
 <c,\5 e\4 g\3>1
 @end lilypond
 
 When fingerings and string indications are used together, their

-placement is controlled by the order in which the two items appear
-in the code:
+placement can be controlled by the order in which the two items appear
+in the code @emph{only} if they appear inside of an explicit chord:
+applied to whole chords or single notes @emph{outside} of chords,
+fingerings are placed using a different mechanism.

 
 @lilypond[verbatim,quote,relative=1]
 \clef "treble_8"
 
 @lilypond[verbatim,quote,relative=1]
 \clef "treble_8"

-<g\3-0>2
+g4\3-0
+g-0\3
+<g\3-0>

 <g-0\3>
 @end lilypond
 
 <g-0\3>
 @end lilypond
 

+String numbers may also, as is customary with unfretted strings,
+be printed in Roman numerals and placed below the staff rather
+than above.
+
+@lilypond[verbatim,quote,relative=2]
+c2\2
+a\3
+\romanStringNumbers
+c\2
+\set stringNumberOrientations = #'(down)
+a\3
+\arabicStringNumbers
+g1\4
+@end lilypond
+

 @snippets
 
 @lilypondfile[verbatim,quote,texidoc,doctitle]
 @snippets
 
 @lilypondfile[verbatim,quote,texidoc,doctitle]


@@ -128,6 +142,10 @@ in the code:
 @lilypondfile[verbatim,quote,texidoc,doctitle]
 {allowing-fingerings-to-be-printed-inside-the-staff.ly}
 
 @lilypondfile[verbatim,quote,texidoc,doctitle]
 {allowing-fingerings-to-be-printed-inside-the-staff.ly}
 

+@predefined
+@code{\arabicStringNumbers},
+@code{\romanStringNumbers}.
+@endpredefined

 
 @seealso
 Notation Reference:
 
 @seealso
 Notation Reference:


@@ -167,7 +185,7 @@ tablature, by using @code{TabStaff} and @code{TabVoice} contexts.  A
 calligraphic tablature clef is added automatically.
 
 @lilypond[quote,ragged-right,verbatim]
 calligraphic tablature clef is added automatically.
 
 @lilypond[quote,ragged-right,verbatim]

-\new TabStaff \relative c' {
+\new TabStaff \relative {

   a,8 a' <c e> a
   d,8 a' <d f> a
 }
   a,8 a' <c e> a
   d,8 a' <d f> a
 }


@@ -182,7 +200,7 @@ symbols = {
   c4-.^"Allegro" d( e)
   f4-.\f g a^\fermata
   \mark \default
   c4-.^"Allegro" d( e)
   f4-.\f g a^\fermata
   \mark \default

-  c8_.\<\( c16 c~ c2\!
+  c8_.\<\( c16 c~ 2\!

   c'2.\prall\)
 }
 
   c'2.\prall\)
 }
 


@@ -208,7 +226,7 @@ symbols = {
   c4-.^"Allegro" d( e)
   f4-.\f g a^\fermata
   \mark \default
   c4-.^"Allegro" d( e)
   f4-.\f g a^\fermata
   \mark \default

-  c8_.\<\( c16 c~ c2\!
+  c8_.\<\( c16 c~ 2\!

   c'2.\prall\)
 }
 
   c'2.\prall\)
 }
 


@@ -223,31 +241,36 @@ symbols = {
 @cindex fret
 
 @funindex minimumFret
 @cindex fret
 
 @funindex minimumFret

+@funindex restrainOpenStrings

 
 By default pitches are assigned to the lowest playing position on the
 fret-board (first position).  Open strings are automatically preferred.
 
 By default pitches are assigned to the lowest playing position on the
 fret-board (first position).  Open strings are automatically preferred.

-If you would like a certain pitch to be played on a specific string
-you can add a string number indication to the pitch name.  If you
-define pitch names and string numbers without a chord construct
-(@code{<>}) the string number indications do not appear in traditional
-notation.  It is much more comfortable to define the playing position
-by using the value of @code{minimumFret}.  The default value for
-minimumFret is 0.
+If you would like a certain pitch to be played on a specific string you
+can add a string number indication to the pitch name.  If you don't want
+to have string number indications appear in traditional notation, you
+can override the respective stencil.  Usually it will be more
+comfortable to define the playing position by using the value of
+@code{minimumFret}.  The default value for minimumFret is 0.

 
 

+Even when @code{minimumFret} is set, open strings are used whenever
+possible.  This behaviour can be changed by setting @code{restrainOpenStrings}
+to @code{#t}.

 
 @lilypond[quote,ragged-right,verbatim]
 
 @lilypond[quote,ragged-right,verbatim]

+\layout { \omit Voice.StringNumber }

 \new StaffGroup <<
 \new StaffGroup <<

-   \new Staff \relative c {
+   \new Staff \relative {

      \clef "treble_8"
      \time 2/4
      c16 d e f g4
      c,16\5 d\5 e\4 f\4 g4\4
      c,16 d e f g4
    }
      \clef "treble_8"
      \time 2/4
      c16 d e f g4
      c,16\5 d\5 e\4 f\4 g4\4
      c,16 d e f g4
    }

-   \new TabStaff \relative c {
+   \new TabStaff \relative {

      c16 d e f g4
      c,16\5 d\5 e\4 f\4 g4\4
      \set TabStaff.minimumFret = #5
      c16 d e f g4
      c,16\5 d\5 e\4 f\4 g4\4
      \set TabStaff.minimumFret = #5

+     \set TabStaff.restrainOpenStrings = ##t

      c,16 d e f g4
    }
 >>
      c,16 d e f g4
    }
 >>


@@ -255,8 +278,9 @@ minimumFret is 0.
 
 @funindex \tabChordRepeats
 @funindex \chordRepeats
 
 @funindex \tabChordRepeats
 @funindex \chordRepeats

-@cindex Chord, repetition
+@cindex chord, repetition

 @cindex repetition, using @code{q}
 @cindex repetition, using @code{q}

+@cindex @code{q}, chord repetition

 
 Chord constructs can be repeated by the chord repetition symbol
 @code{q}.  In combination with tabulatures, its behavior of removing
 
 Chord constructs can be repeated by the chord repetition symbol
 @code{q}.  In combination with tabulatures, its behavior of removing


@@ -270,8 +294,8 @@ repetition}.  This particular command is so common that it is available
 as @code{\tabChordRepeats}.
 
 @lilypond[quote,verbatim]
 as @code{\tabChordRepeats}.
 
 @lilypond[quote,verbatim]

-guitar = \relative c' {
-  r8 <gis-6 cis-6 b-0>~ q4 q8~ q q4
+guitar = \relative {
+  r8 <gis-2 cis-3 b-0>~ q4 q8~ 8 q4

 }
 
 \new StaffGroup <<
 }
 
 \new StaffGroup <<


@@ -292,7 +316,7 @@ the second alternative of a repeat.
 ties = \relative c' {
   \repeat volta 2 {
     e2. f4~
 ties = \relative c' {
   \repeat volta 2 {
     e2. f4~

-    f2 g2~
+    2 g2~

   }
   \alternative {
      { g4 f2. }
   }
   \alternative {
      { g4 f2. }


@@ -307,11 +331,11 @@ ties = \relative c' {
 \score {
   <<
     \new StaffGroup  <<
 \score {
   <<
     \new StaffGroup  <<

-      \context Staff {
+      \new Staff {

         \clef "treble_8"
         \ties
       }
         \clef "treble_8"
         \ties
       }

-      \context TabStaff {
+      \new TabStaff {

         \ties
       }
     >>
         \ties
       }
     >>


@@ -332,7 +356,7 @@ engraving fret numbers in parentheses:
 ties = \relative c' {
   \repeat volta 2 {
     e2. f4~
 ties = \relative c' {
   \repeat volta 2 {
     e2. f4~

-    f2 g2~ }
+    2 g2~ }

   \alternative {
     { g4 f2. }
     { g4\repeatTie c,2. }
   \alternative {
     { g4 f2. }
     { g4\repeatTie c,2. }


@@ -346,11 +370,11 @@ ties = \relative c' {
 \score {
   <<
     \new StaffGroup  <<
 \score {
   <<
     \new StaffGroup  <<

-      \context Staff {
+      \new Staff {

         \clef "treble_8"
         \ties
       }
         \clef "treble_8"
         \ties
       }

-      \context TabStaff {
+      \new TabStaff {

       \hideSplitTiedTabNotes
         \ties
       }
       \hideSplitTiedTabNotes
         \ties
       }


@@ -365,9 +389,6 @@ ties = \relative c' {
 
 @cindex harmonic indications in tablature notation
 @cindex tablature and harmonic indications
 
 @cindex harmonic indications in tablature notation
 @cindex tablature and harmonic indications

-@cindex slides in tablature notation
-@cindex tablature and slides
-@cindex chord glissandi

 @funindex \harmonic
 @funindex \harmonicByFret
 @funindex \harmonicByRatio
 @funindex \harmonic
 @funindex \harmonicByFret
 @funindex \harmonicByRatio


@@ -376,6 +397,7 @@ Harmonic indications can be added to tablature notation as sounding
 pitches:
 
 @lilypond[verbatim,quote]
 pitches:
 
 @lilypond[verbatim,quote]

+\layout { \omit Voice.StringNumber }

 firstHarmonic = {
   d'4\4\harmonic
   g'4\3\harmonic
 firstHarmonic = {
   d'4\4\harmonic
   g'4\3\harmonic


@@ -383,7 +405,10 @@ firstHarmonic = {
 }
 \score {
   <<
 }
 \score {
   <<

-    \new Staff { \firstHarmonic }
+    \new Staff {
+      \clef "treble_8"
+      \firstHarmonic
+    }

     \new TabStaff { \firstHarmonic }
   >>
 }
     \new TabStaff { \firstHarmonic }
   >>
 }


@@ -405,7 +430,10 @@ fretHarmonics = {
 }
 \score {
   <<
 }
 \score {
   <<

-    \new Staff { \fretHarmonics }
+    \new Staff {
+      \clef "treble_8"
+      \fretHarmonics
+    }

     \new TabStaff { \fretHarmonics }
   >>
 }
     \new TabStaff { \fretHarmonics }
   >>
 }


@@ -422,7 +450,10 @@ ratioHarmonics = {
 }
 \score {
   <<
 }
 \score {
   <<

-    \new Staff { \ratioHarmonics }
+    \new Staff {
+      \clef "treble_8"
+      \ratioHarmonics
+    }

     \new TabStaff { \ratioHarmonics }
   >>
 }
     \new TabStaff { \ratioHarmonics }
   >>
 }


@@ -441,12 +472,29 @@ ratioHarmonics = {
 @lilypondfile[verbatim,quote,texidoc,doctitle]
 {fretted-string-harmonics-in-tablature.ly}
 
 @lilypondfile[verbatim,quote,texidoc,doctitle]
 {fretted-string-harmonics-in-tablature.ly}
 

+@cindex slides in tablature notation
+@cindex tablature and slides
+

 @lilypondfile[verbatim,quote,texidoc,doctitle]
 {slides-in-tablature.ly}
 
 @lilypondfile[verbatim,quote,texidoc,doctitle]
 {slides-in-tablature.ly}
 

+@cindex chord glissandi
+

 @lilypondfile[verbatim,quote,texidoc,doctitle]
 {chord-glissando-in-tablature.ly}
 
 @lilypondfile[verbatim,quote,texidoc,doctitle]
 {chord-glissando-in-tablature.ly}
 

+@cindex hammer on
+@cindex pull off
+
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{hammer-on-and-pull-off.ly}
+
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{hammer-on-and-pull-off-using-voices.ly}
+
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{hammer-on-and-pull-off-using-chords.ly}
+

 @seealso
 Notation Reference:
 @ref{Chord repetition},
 @seealso
 Notation Reference:
 @ref{Chord repetition},


@@ -487,6 +535,7 @@ melodia = \partcombine { e4 g g g } { e4 e e e }
 
 Guitar special effects are limited to harmonics and slides.
 
 
 Guitar special effects are limited to harmonics and slides.
 

+

 @node Custom tablatures
 @unnumberedsubsubsec Custom tablatures
 
 @node Custom tablatures
 @unnumberedsubsubsec Custom tablatures
 


@@ -522,16 +571,19 @@ written.
 
 @lilypond[quote,ragged-right,verbatim]
 <<
 
 @lilypond[quote,ragged-right,verbatim]
 <<

-  \new Staff {
+  \new Voice \with {
+    \omit StringNumber
+  } {

     \clef "bass_8"
     \clef "bass_8"

-    \relative c, {
-      c4 d e f
+    \relative {
+      c,4 d e f

     }
   }
     }
   }

-  \new TabStaff {
-    \set TabStaff.stringTunings = #bass-tuning
-    \relative c, {
-      c4 d e f
+  \new TabStaff \with {
+    stringTunings = #bass-tuning
+  } {
+    \relative {
+      c,4 d e f

     }
   }
 >>
     }
   }
 >>


@@ -541,7 +593,7 @@ The default string tuning is @code{guitar-tuning}, which
 is the standard EADGBE tuning.  Some other predefined tunings are
 @code{guitar-open-g-tuning}, @code{mandolin-tuning} and
 @code{banjo-open-g-tuning}.  The predefined string tunings
 is the standard EADGBE tuning.  Some other predefined tunings are
 @code{guitar-open-g-tuning}, @code{mandolin-tuning} and
 @code{banjo-open-g-tuning}.  The predefined string tunings

-are found in @file{ly/string-tuning-init.ly}.
+are found in @file{ly/string-tunings-init.ly}.

 
 @funindex stringTuning
 @funindex \stringTuning
 
 @funindex stringTuning
 @funindex \stringTuning


@@ -575,7 +627,7 @@ mynotes = {
     \mynotes
   }
   \new TabStaff {
     \mynotes
   }
   \new TabStaff {

-    \set stringTunings = \stringTuning <c' g' d'' a''>
+    \set Staff.stringTunings = \stringTuning <c' g' d'' a''>

     \mynotes
   }
 >>
     \mynotes
   }
 >>


@@ -591,7 +643,7 @@ for predefined fret diagrams
 The previous example could also be written as follows:
 
 @lilypond[quote,verbatim]
 The previous example could also be written as follows:
 
 @lilypond[quote,verbatim]

-"custom-tuning" = \stringTuning <c' g' d'' a''>
+custom-tuning = \stringTuning <c' g' d'' a''>

 
 mynotes = {
   c'4 e' g' c'' |
 
 mynotes = {
   c'4 e' g' c'' |


@@ -635,7 +687,7 @@ you can use
 \layout @{
   \context @{
     \TabStaff
 \layout @{
   \context @{
     \TabStaff

-    stringTunings = \stringTuning \notemode @{ <c' g' d'' a''> @}
+    stringTunings = \stringTuning <c' g' d'' a''>

   @}
 @}
 @end example
   @}
 @}
 @end example


@@ -667,7 +719,7 @@ Notation Reference:
 @ref{Scheme functions}.
 
 Installed Files:
 @ref{Scheme functions}.
 
 Installed Files:

-@file{ly/string-tuning-init.ly}
+@file{ly/string-tunings-init.ly},

 @file{scm/tablature.scm}.
 
 Snippets:
 @file{scm/tablature.scm}.
 
 Snippets:


@@ -681,6 +733,7 @@ Automatic tablature calculations do not work properly in most
 cases for instruments where string pitches do not vary
 monotonically with string number, such as ukuleles.
 
 cases for instruments where string pitches do not vary
 monotonically with string number, such as ukuleles.
 

+

 @node Fret diagram markups
 @unnumberedsubsubsec Fret diagram markups
 
 @node Fret diagram markups
 @unnumberedsubsubsec Fret diagram markups
 


@@ -706,12 +759,12 @@ In addition, open and unplayed (muted) strings can be indicated.
 
 @lilypond[quote, verbatim]
 <<
 
 @lilypond[quote, verbatim]
 <<

-  \context ChordNames {
+  \new ChordNames {

     \chordmode {
       c1 d:m
     }
   }
     \chordmode {
       c1 d:m
     }
   }

-  \context Staff {
+  \new Staff {

     \clef "treble_8"
     <c e g c' e'>1^\markup {
       \fret-diagram #"6-x;5-3;4-2;3-o;2-1;1-o;"
     \clef "treble_8"
     <c e g c' e'>1^\markup {
       \fret-diagram #"6-x;5-3;4-2;3-o;2-1;1-o;"


@@ -730,12 +783,12 @@ the fret-diagram markup string.
 
 @lilypond[quote, verbatim]
 <<
 
 @lilypond[quote, verbatim]
 <<

-  \context ChordNames {
+  \new ChordNames {

      \chordmode {
        f1 g
      }
   }
      \chordmode {
        f1 g
      }
   }

-  \context Staff {
+  \new Staff {

     \clef "treble_8"
     <f, c f a c' f'>1^\markup {
       \fret-diagram #"c:6-1-1;6-1;5-3;4-3;3-2;2-1;1-1;"
     \clef "treble_8"
     <f, c f a c' f'>1^\markup {
       \fret-diagram #"c:6-1-1;6-1;5-3;4-3;3-2;2-1;1-1;"


@@ -758,12 +811,12 @@ can be changed in the fret-diagram markup string.
 
 @lilypond[quote, verbatim]
 <<
 
 @lilypond[quote, verbatim]
 <<

-  \context ChordNames {
+  \new ChordNames {

      \chordmode {
        f1 g
      }
   }
      \chordmode {
        f1 g
      }
   }

-  \context Staff {
+  \new Staff {

     \clef "treble_8"
     <f, c f a c' f'>1^\markup {
       \fret-diagram #"s:1.5;c:6-1-1;6-1;5-3;4-3;3-2;2-1;1-1;"
     \clef "treble_8"
     <f, c f a c' f'>1^\markup {
       \fret-diagram #"s:1.5;c:6-1-1;6-1;5-3;4-3;3-2;2-1;1-1;"


@@ -781,12 +834,12 @@ markup string.
 
 @lilypond[quote, verbatim]
 <<
 
 @lilypond[quote, verbatim]
 <<

-  \context ChordNames {
+  \new ChordNames {

     \chordmode {
       a1
     }
   }
     \chordmode {
       a1
     }
   }

-  \context Staff {
+  \new Staff {

     % An 'A' chord for ukulele
     a'1^\markup {
       \fret-diagram #"w:4;4-2-2;3-1-1;2-o;1-o;"
     % An 'A' chord for ukulele
     a'1^\markup {
       \fret-diagram #"w:4;4-2-2;3-1-1;2-o;1-o;"


@@ -800,12 +853,12 @@ can be controlled by the fret-diagram markup string.
 
 @lilypond[quote, verbatim]
 <<
 
 @lilypond[quote, verbatim]
 <<

-  \context ChordNames {
+  \new ChordNames {

     \chordmode {
       c1 d:m
     }
   }
     \chordmode {
       c1 d:m
     }
   }

-  \context Staff {
+  \new Staff {

     \clef "treble_8"
     <c e g c' e'>1^\markup {
       \fret-diagram #"f:1;6-x;5-3-3;4-2-2;3-o;2-1-1;1-o;"
     \clef "treble_8"
     <c e g c' e'>1^\markup {
       \fret-diagram #"f:1;6-x;5-3-3;4-2-2;3-o;2-1-1;1-o;"


@@ -822,12 +875,12 @@ markup string.
 
 @lilypond[quote, verbatim]
 <<
 
 @lilypond[quote, verbatim]
 <<

-  \context ChordNames {
+  \new ChordNames {

     \chordmode {
       c1 d:m
     }
   }
     \chordmode {
       c1 d:m
     }
   }

-  \context Staff {
+  \new Staff {

     \clef "treble_8"
     <c e g c' e'>1^\markup {
       \fret-diagram #"d:0.35;6-x;5-3;4-2;3-o;2-1;1-o;"
     \clef "treble_8"
     <c e g c' e'>1^\markup {
       \fret-diagram #"d:0.35;6-x;5-3;4-2;3-o;2-1;1-o;"


@@ -852,12 +905,12 @@ Mute strings, open strings, and fret numbers can be indicated.
 
 @lilypond[quote, verbatim]
 <<
 
 @lilypond[quote, verbatim]
 <<

-  \context ChordNames {
+  \new ChordNames {

     \chordmode {
       c1 d:m
     }
   }
     \chordmode {
       c1 d:m
     }
   }

-  \context Staff {
+  \new Staff {

     \clef "treble_8"
     <c e g c' e'>1^\markup {
       \fret-diagram-terse #"x;3;2;o;1;o;"
     \clef "treble_8"
     <c e g c' e'>1^\markup {
       \fret-diagram-terse #"x;3;2;o;1;o;"


@@ -873,12 +926,12 @@ Barre indicators can be included in the fret-diagram-terse markup string.
 
 @lilypond[quote, verbatim]
 <<
 
 @lilypond[quote, verbatim]
 <<

-  \context ChordNames {
+  \new ChordNames {

     \chordmode {
       f1 g
     }
   }
     \chordmode {
       f1 g
     }
   }

-  \context Staff {
+  \new Staff {

     \clef "treble_8"
     <f, c f a c' f'>1^\markup {
       \fret-diagram-terse #"1-(;3;3;2;1;1-);"
     \clef "treble_8"
     <f, c f a c' f'>1^\markup {
       \fret-diagram-terse #"1-(;3;3;2;1;1-);"


@@ -895,14 +948,13 @@ Fingering indications can be included in the fret-diagram-terse markup string.
 @c Need to use override to enable fingerings to show this -- can we do so?
 @lilypond[quote, verbatim]
 <<
 @c Need to use override to enable fingerings to show this -- can we do so?
 @lilypond[quote, verbatim]
 <<

-  \context ChordNames {
+  \new ChordNames {

     \chordmode {
       c1 d:m
     }
   }
     \chordmode {
       c1 d:m
     }
   }

-  \context Staff {
-    \override Voice.TextScript
-      #'(fret-diagram-details finger-code) = #'below-string
+  \new Staff {
+    \override Voice.TextScript.fret-diagram-details.finger-code = #'below-string

     \clef "treble_8"
     <c e g c' e'>1^\markup {
       \fret-diagram-terse #"x;3-3;2-2;o;1-1;o;"
     \clef "treble_8"
     <c e g c' e'>1^\markup {
       \fret-diagram-terse #"x;3-3;2-2;o;1-1;o;"


@@ -928,12 +980,12 @@ element of the list indicates an item to be placed on the fret diagram.
 
 @lilypond[quote, verbatim]
 <<
 
 @lilypond[quote, verbatim]
 <<

-    \context ChordNames {
+    \new ChordNames {

       \chordmode {
         c1 d:m
       }
     }
       \chordmode {
         c1 d:m
       }
     }

-  \context Staff {
+  \new Staff {

     \clef "treble_8"
     <c e g c' e'>1^\markup {
       \fret-diagram-verbose #'(
     \clef "treble_8"
     <c e g c' e'>1^\markup {
       \fret-diagram-verbose #'(


@@ -966,18 +1018,20 @@ can be placed on the fret diagram.  The capo indication is
 a thick bar that covers all strings.  The fret with the
 capo will be the lowest fret in the fret diagram.
 
 a thick bar that covers all strings.  The fret with the
 capo will be the lowest fret in the fret diagram.
 

+Fingering indication dots can be colored as well as parenthesized;
+the parenthesis's color can also be altered independently.
+

 @c \override is necessary to make fingering visible
 @lilypond[quote, verbatim]
 <<
 @c \override is necessary to make fingering visible
 @lilypond[quote, verbatim]
 <<

-    \context ChordNames {
+    \new ChordNames {

       \chordmode {
       \chordmode {

-        f1 g c
+        f1 g c c

       }
     }
       }
     }

-  \context Staff {
+  \new Staff {

     \clef "treble_8"
     \clef "treble_8"

-    \override Voice.TextScript
-      #'(fret-diagram-details finger-code) = #'below-string
+    \override Voice.TextScript.fret-diagram-details.finger-code = #'below-string

     <f, c f a c' f'>1^\markup {
       \fret-diagram-verbose #'(
         (place-fret 6 1)
     <f, c f a c' f'>1^\markup {
       \fret-diagram-verbose #'(
         (place-fret 6 1)


@@ -999,7 +1053,7 @@ capo will be the lowest fret in the fret diagram.
         (place-fret 1 3 3)
       )
     }
         (place-fret 1 3 3)
       )
     }

-    <c e g c' e'>1^\markup {
+    <c g c' e' g'>1^\markup {

       \fret-diagram-verbose #'(
         (capo 3)
         (mute 6)
       \fret-diagram-verbose #'(
         (capo 3)
         (mute 6)


@@ -1008,6 +1062,17 @@ capo will be the lowest fret in the fret diagram.
         (place-fret 2 5 3)
       )
     }
         (place-fret 2 5 3)
       )
     }

+    \override Voice.TextScript.size = 1.5
+    <c g c' e' g'>1^\markup {
+      \fret-diagram-verbose #'(
+        (place-fret 6 3 1 red parenthesized default-paren-color)
+        (place-fret 5 3 1 inverted)
+        (place-fret 4 5 2 blue parenthesized)
+        (place-fret 3 5 3 blue)
+        (place-fret 2 5 4 blue)
+        (place-fret 1 3 1 inverted)
+      )
+    }

   }
 >>
 @end lilypond
   }
 >>
 @end lilypond


@@ -1091,7 +1156,6 @@ Internals Reference:
 @node Predefined fret diagrams
 @unnumberedsubsubsec Predefined fret diagrams
 
 @node Predefined fret diagrams
 @unnumberedsubsubsec Predefined fret diagrams
 

-

 @cindex fret diagrams
 @cindex fret diagrams, ukulele
 @cindex fret diagrams, mandolin
 @cindex fret diagrams
 @cindex fret diagrams, ukulele
 @cindex fret diagrams, mandolin


@@ -1106,7 +1170,7 @@ are stored in a lookup table:
 
 @lilypond[verbatim, ragged-right, quote]
 \include "predefined-guitar-fretboards.ly"
 
 @lilypond[verbatim, ragged-right, quote]
 \include "predefined-guitar-fretboards.ly"

-\context FretBoards {
+\new FretBoards {

   \chordmode {
     c1 d
   }
   \chordmode {
     c1 d
   }


@@ -1123,7 +1187,7 @@ diagrams can be added for other instruments or other tunings
 by following the examples found in
 @file{predefined-guitar-fretboards.ly}.
 
 by following the examples found in
 @file{predefined-guitar-fretboards.ly}.
 

-Fret diagrams for the ukulele are contained in the file
+Fret diagrams for the ukulele are contained in the file @*

 @file{predefined-ukulele-fretboards.ly}.
 
 @lilypond[verbatim, ragged-right, quote]
 @file{predefined-ukulele-fretboards.ly}.
 
 @lilypond[verbatim, ragged-right, quote]


@@ -1136,12 +1200,12 @@ myChords = \chordmode { a1 a:m a:aug }
 }
 
 \new FretBoards {
 }
 
 \new FretBoards {

-  \set stringTunings = #ukulele-tuning
+  \set Staff.stringTunings = #ukulele-tuning

   \myChords
 }
 @end lilypond
 
   \myChords
 }
 @end lilypond
 

-Fret diagrams for the mandolin are contained in the file
+Fret diagrams for the mandolin are contained in the file @*

 @file{predefined-mandolin-fretboards.ly}.
 
 @lilypond[verbatim, ragged-right, quote]
 @file{predefined-mandolin-fretboards.ly}.
 
 @lilypond[verbatim, ragged-right, quote]


@@ -1154,7 +1218,7 @@ myChords = \chordmode { c1 c:m7.5- c:aug }
 }
 
 \new FretBoards {
 }
 
 \new FretBoards {

-  \set stringTunings = #mandolin-tuning
+  \set Staff.stringTunings = #mandolin-tuning

   \myChords
 }
 @end lilypond
   \myChords
 }
 @end lilypond


@@ -1165,7 +1229,7 @@ either as simultaneous music or using chord mode (see
 
 @lilypond[verbatim, ragged-right,quote]
 \include "predefined-guitar-fretboards.ly"
 
 @lilypond[verbatim, ragged-right,quote]
 \include "predefined-guitar-fretboards.ly"

-\context FretBoards {
+\new FretBoards {

   \chordmode { c1 }
   <c' e' g'>1
 }
   \chordmode { c1 }
   <c' e' g'>1
 }


@@ -1189,10 +1253,10 @@ mychords = \chordmode{
 }
 
 <<
 }
 
 <<

-  \context ChordNames {
+  \new ChordNames {

     \mychords
   }
     \mychords
   }

-  \context FretBoards {
+  \new FretBoards {

     \mychords
   }
 >>
     \mychords
   }
 >>


@@ -1216,10 +1280,10 @@ mychordlist = {
   \transpose c e { \mychords }
 }
 <<
   \transpose c e { \mychords }
 }
 <<

-  \context ChordNames {
+  \new ChordNames {

     \mychordlist
   }
     \mychordlist
   }

-  \context FretBoards {
+  \new FretBoards {

     \mychordlist
   }
 >>
     \mychordlist
   }
 >>


@@ -1245,10 +1309,10 @@ mychords = \chordmode{
 }
 
 <<
 }
 
 <<

-  \context ChordNames {
+  \new ChordNames {

     \mychords
   }
     \mychords
   }

-  \context FretBoards {
+  \new FretBoards {

     \mychords
   }
 >>
     \mychords
   }
 >>


@@ -1279,10 +1343,10 @@ mychords = \chordmode {
 }
 
 <<
 }
 
 <<

-  \context ChordNames {
+  \new ChordNames {

     \mychords
   }
     \mychords
   }

-  \context FretBoards {
+  \new FretBoards {

     \mychords
   }
 >>
     \mychords
   }
 >>


@@ -1306,10 +1370,10 @@ mychords = \chordmode {
 }
 
 <<
 }
 
 <<

-  \context ChordNames {
+  \new ChordNames {

     \mychords
   }
     \mychords
   }

-  \context FretBoards {
+  \new FretBoards {

     \mychords
   }
 >>
     \mychords
   }
 >>


@@ -1356,10 +1420,10 @@ mychords = \chordmode{
 }
 
 <<
 }
 
 <<

-  \context ChordNames {
+  \new ChordNames {

     \mychords
   }
     \mychords
   }

-  \context FretBoards {
+  \new FretBoards {

     \mychords
   }
 >>
     \mychords
   }
 >>


@@ -1379,13 +1443,12 @@ the interface properties belong to @code{FretBoards.FretBoard}.
 @lilypondfile[verbatim,quote,texidoc,doctitle]
 {defining-predefined-fretboards-for-other-instruments.ly}
 
 @lilypondfile[verbatim,quote,texidoc,doctitle]
 {defining-predefined-fretboards-for-other-instruments.ly}
 

-@lilypondfile[verbatim,quote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle,ragged-right]

 {chordchanges-for-fretboards.ly}
 
 @lilypondfile[verbatim,quote,texidoc,doctitle]
 {fretboards-alternate-tables.ly}
 
 {chordchanges-for-fretboards.ly}
 
 @lilypondfile[verbatim,quote,texidoc,doctitle]
 {fretboards-alternate-tables.ly}
 

-

 @seealso
 Notation Reference:
 @ref{Custom tablatures},
 @seealso
 Notation Reference:
 @ref{Custom tablatures},


@@ -1394,9 +1457,9 @@ Notation Reference:
 @ref{Predefined fretboard diagrams}.
 
 Installed Files:
 @ref{Predefined fretboard diagrams}.
 
 Installed Files:

-@file{ly/predefined-guitar-fretboards.ly},
-@file{ly/predefined-guitar-ninth-fretboards.ly},
-@file{ly/predefined-ukulele-fretboards.ly},
+@file{ly/predefined-guitar-fretboards.ly}, @*
+@file{ly/predefined-guitar-ninth-fretboards.ly}, @*
+@file{ly/predefined-ukulele-fretboards.ly}, @*

 @file{ly/predefined-mandolin-fretboards.ly}.
 
 Snippets:
 @file{ly/predefined-mandolin-fretboards.ly}.
 
 Snippets:


@@ -1421,16 +1484,16 @@ calculates strings and frets that can be used to play the notes.
 
 @lilypond[quote,ragged-right,verbatim]
 <<
 
 @lilypond[quote,ragged-right,verbatim]
 <<

-  \context ChordNames {
+  \new ChordNames {

     \chordmode {
       f1 g
     }
   }
     \chordmode {
       f1 g
     }
   }

-  \context FretBoards {
+  \new FretBoards {

     <f, c f a c' f'>1
     <g,\6 b, d g b g'>1
   }
     <f, c f a c' f'>1
     <g,\6 b, d g b g'>1
   }

-  \context Staff {
+  \new Staff {

     \clef "treble_8"
     <f, c f a c' f'>1
     <g, b, d g b' g'>1
     \clef "treble_8"
     <f, c f a c' f'>1
     <g, b, d g b' g'>1


@@ -1455,19 +1518,19 @@ commands:
                         #guitar-tuning
                         #"x;3-1-(;5-2;5-3;5-4;3-1-1-);"
 <<
                         #guitar-tuning
                         #"x;3-1-(;5-2;5-3;5-4;3-1-1-);"
 <<

-  \context ChordNames {
+  \new ChordNames {

     \chordmode {
       c1 c c
     }
   }
     \chordmode {
       c1 c c
     }
   }

-  \context FretBoards {
+  \new FretBoards {

     <c e g c' e'>1
     \predefinedFretboardsOff
     <c e g c' e'>1
     \predefinedFretboardsOn
     <c e g c' e'>1
   }
     <c e g c' e'>1
     \predefinedFretboardsOff
     <c e g c' e'>1
     \predefinedFretboardsOn
     <c e g c' e'>1
   }

-  \context Staff {
+  \new Staff {

     \clef "treble_8"
     <c e g c' e'>1
     <c e g c' e'>1
     \clef "treble_8"
     <c e g c' e'>1
     <c e g c' e'>1


@@ -1492,16 +1555,16 @@ Fingerings can be added to FretBoard fret diagrams.
 
 @lilypond[quote, verbatim]
 <<
 
 @lilypond[quote, verbatim]
 <<

-  \context ChordNames {
+  \new ChordNames {

     \chordmode {
       c1 d:m
     }
   }
     \chordmode {
       c1 d:m
     }
   }

-  \context FretBoards {
+  \new FretBoards {

     <c-3 e-2 g c'-1 e'>1
     <d a-2 d'-3 f'-1>1
   }
     <c-3 e-2 g c'-1 e'>1
     <d a-2 d'-3 f'-1>1
   }

-  \context Staff {
+  \new Staff {

     \clef "treble_8"
     <c e g c' e'>1
     <d a d' f'>1
     \clef "treble_8"
     <c e g c' e'>1
     <d a d' f'>1


@@ -1517,17 +1580,17 @@ property.
 
 @lilypond[quote, verbatim]
 <<
 
 @lilypond[quote, verbatim]
 <<

-  \context ChordNames {
+  \new ChordNames {

     \chordmode {
       d1:m d:m
     }
   }
     \chordmode {
       d1:m d:m
     }
   }

-  \context FretBoards {
+  \new FretBoards {

     <d a d' f'>1
     \set FretBoards.minimumFret = #5
     <d a d' f'>1
   }
     <d a d' f'>1
     \set FretBoards.minimumFret = #5
     <d a d' f'>1
   }

-  \context Staff {
+  \new Staff {

     \clef "treble_8"
     <d a d' f'>1
     <d a d' f'>1
     \clef "treble_8"
     <d a d' f'>1
     <d a d' f'>1


@@ -1553,7 +1616,6 @@ diagram, the interface properties belong to
 @code{\predefinedFretboardsOn}.
 @endpredefined
 
 @code{\predefinedFretboardsOn}.
 @endpredefined
 

-

 @seealso
 Notation Reference:
 @ref{Custom tablatures}.
 @seealso
 Notation Reference:
 @ref{Custom tablatures}.


@@ -1579,28 +1641,27 @@ with non-monotonic tunings.
 @funindex rightHandFinger
 @funindex \rightHandFinger
 
 @funindex rightHandFinger
 @funindex \rightHandFinger
 

-Right-hand fingerings @var{p-i-m-a} must be entered within a
-chord construct @code{<>} for them to be printed in the score,
-even when applied to a single note.
+Right-hand fingerings @var{p-i-m-a} must be entered using
+@code{\rightHandFinger} followed by a number.

 
 

-@warning{There @strong{must} be a hyphen before
-@code{@bs{}rightHandFinger} and a space before the closing @code{>}.}
+@warning{If the number is entered in Scheme notation, remember to append
+a space before following it with a closing @code{>} or similar.}

 
 @lilypond[quote,verbatim,relative=0]
 \clef "treble_8"
 
 @lilypond[quote,verbatim,relative=0]
 \clef "treble_8"

-<c-\rightHandFinger #1 >4
-<e-\rightHandFinger #2 >
-<g-\rightHandFinger #3 >
-<c-\rightHandFinger #4 >
-<c,-\rightHandFinger #1 e-\rightHandFinger #2
- g-\rightHandFinger #3 c-\rightHandFinger #4 >1
+c4\rightHandFinger #1
+e\rightHandFinger #2
+g\rightHandFinger #3
+c\rightHandFinger #4
+<c,\rightHandFinger #1 e\rightHandFinger #2
+ g\rightHandFinger #3 c\rightHandFinger #4 >1

 @end lilypond
 
 For convenience, you can abbreviate @code{\rightHandFinger} to something
 short, for example @code{RH},
 
 @example
 @end lilypond
 
 For convenience, you can abbreviate @code{\rightHandFinger} to something
 short, for example @code{RH},
 
 @example

-#(define RH rightHandFinger)
+RH=#rightHandFinger

 @end example
 
 
 @end example
 
 


@@ -1612,7 +1673,6 @@ short, for example @code{RH},
 @lilypondfile[verbatim,quote,texidoc,doctitle]
 {fingerings,-string-indications,-and-right-hand-fingerings.ly}
 
 @lilypondfile[verbatim,quote,texidoc,doctitle]
 {fingerings,-string-indications,-and-right-hand-fingerings.ly}
 

-

 @seealso
 Snippets:
 @rlsr{Fretted strings}.
 @seealso
 Snippets:
 @rlsr{Fretted strings}.


@@ -1652,13 +1712,12 @@ barring indications.
 \clef "treble_8"
 b16 d g b e
 \textSpannerDown
 \clef "treble_8"
 b16 d g b e
 \textSpannerDown

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

 g16\startTextSpan
 b16 e g e b g\stopTextSpan
 e16 b g d
 @end lilypond
 
 g16\startTextSpan
 b16 e g e b g\stopTextSpan
 e16 b g d
 @end lilypond
 

-

 @seealso
 Notation Reference:
 @ref{Text spanners}.
 @seealso
 Notation Reference:
 @ref{Text spanners}.


@@ -1683,7 +1742,7 @@ text markup.
 @lilypond[quote,ragged-right,verbatim]
 \relative c' {
   \clef "treble_8"
 @lilypond[quote,ragged-right,verbatim]
 \relative c' {
   \clef "treble_8"

-  \override Staff.NoteHead #'style = #'harmonic-mixed
+  \override Staff.NoteHead.style = #'harmonic-mixed

   d^\markup { \italic { \fontsize #-2 { "harm. 12" }}} <g b>1
 }
 @end lilypond
   d^\markup { \italic { \fontsize #-2 { "harm. 12" }}} <g b>1
 }
 @end lilypond


@@ -1692,12 +1751,12 @@ Dampened notes (also called @notation{dead notes}) are supported
 within normal and tablature staves:
 
 @lilypond[quote,ragged-right,verbatim]
 within normal and tablature staves:
 
 @lilypond[quote,ragged-right,verbatim]

-music = \relative c' {
+music = \relative {

   < a\3 \deadNote c\2 a'\1 >4
   < b\3 \deadNote d\2 b'\1 >
   < c\3 \deadNote e\2 c'\1 >
   \deadNotesOn
   < a\3 \deadNote c\2 a'\1 >4
   < b\3 \deadNote d\2 b'\1 >
   < c\3 \deadNote e\2 c'\1 >
   \deadNotesOn

-  \times 2/3 { g8 b e }
+  \tuplet 3/2 { g8 b e }

   \deadNotesOff
   < a,\3 c\2 e\1 >1
 }
   \deadNotesOff
   < a,\3 c\2 e\1 >1
 }


@@ -1846,15 +1905,20 @@ correct fret numbers for the fifth string:
 @c due to crazy intervals of banjo music, absolute pitch is recommended
 
 @lilypond[quote,ragged-right,verbatim]
 @c due to crazy intervals of banjo music, absolute pitch is recommended
 
 @lilypond[quote,ragged-right,verbatim]

-\new TabStaff <<
-  \set TabStaff.tablatureFormat = #fret-number-tablature-format-banjo
-  \set TabStaff.stringTunings = #banjo-open-g-tuning
-  {
-    \stemDown
-    g8 d' g'\5 a b g e d' |
-    g4 d''8\5 b' a'\2 g'\5 e'\2 d' |
-    g4
+music = {
+  g8 d' g'\5 a b g e d' |
+  g4 d''8\5 b' a'\2 g'\5 e'\2 d' |
+  g4
+}
+
+<<
+  \new Staff \with { \omit StringNumber }
+  { \clef "treble_8"  \music }
+  \new TabStaff \with {
+    tablatureFormat = #fret-number-tablature-format-banjo
+    stringTunings = #banjo-open-g-tuning

   }
   }

+  { \music }

 >>
 @end lilypond
 
 >>
 @end lilypond
 


@@ -1880,8 +1944,8 @@ These may be converted to four-string tunings using the
 @end example
 
 @seealso
 @end example
 
 @seealso

+Installed Files:
+@file{ly/string-tunings-init.ly}.
+

 Snippets:
 @rlsr{Fretted strings}.
 Snippets:
 @rlsr{Fretted strings}.

-
-Installed Files:
-@file{ly/string-tunings-init.ly}