From d1e8171540c9d40cb0626ed772205963731f792f Mon Sep 17 00:00:00 2001
From: Carl Sorensen <c_sorensen@byu.edu>
Date: Tue, 12 Aug 2008 18:13:14 -0600
Subject: [PATCH] Update fretted-strings.itely

---
 Documentation/user/fretted-strings.itely | 45 +++++++++++++++---------
 1 file changed, 28 insertions(+), 17 deletions(-)

diff --git a/Documentation/user/fretted-strings.itely b/Documentation/user/fretted-strings.itely
index 8bcea60612..038019e7ca 100644
--- a/Documentation/user/fretted-strings.itely
+++ b/Documentation/user/fretted-strings.itely
@@ -259,32 +259,42 @@ is the standard EADGBE tuning.  Some other predefined tunings are
 are found in @code{scm/output-lib.scm}.
 
 A string tuning is a Scheme list of string pitches, 
-one for each string, ordered from the bottom to the 
-top of the tablature staff.
-This ordinarily results in ordering from lowest pitch to highest
-pitch, but some instruments (e.g. ukulele) do not have strings
-ordered by pitch.
-
-A string pitch in a string tuning list is the pitch difference of 
-middle C from the open string measured in semitones.  The pitch must
-be an integer.  Lilypond calculates the actual pitch of the string by
-adding the string tuning pitch to the actual pitch for middle C.
+one for each string, ordered by string number from 1 to N,
+where string 1 is at the top of the tablature staff and
+string N is at the bottom.  This ordinarily results in ordering 
+from highest pitch to lowest pitch, but some instruments 
+(e.g. ukulele) do not have strings ordered by pitch.
+
+A string pitch in a string tuning list is the pitch difference  
+of the open string from middle C measured in semitones.  The 
+string pitch must be an integer.  Lilypond calculates the actual 
+pitch of the string by adding the string tuning pitch to the 
+actual pitch for middle C.
 
 LilyPond automatically calculates the number of strings in the
 @code{TabStaff} as the number of elements in @code{stringTunings}.
 
 Any desired string tuning can be created.  For example, we can
 define a string tuning for a four-string instrument with pitches
-of e, a, d', and g':
+of @code{a''},  @code{d''},  @code{g'}, and @code{c'}:
 
 
-@lilypond[quote,ragged-right,fragment,verbatim]
-\new TabStaff {
-  \set TabStaff.stringTunings = #'(-5 -10 -15 -20)
-  {
-    a,4 c' a e' e c' a e'
-  }
+@lilypond[quote,verbatim]
+mynotes = {
+    c'4 e' g' c'' |
+    e'' g'' b'' c'''
 }
+
+<<
+  \new Staff {
+    \clef treble
+    \mynotes
+  }
+  \new TabStaff {
+    \set TabStaff.stringTunings = #'(21 14 7 0)
+    \mynotes
+  }
+>>
 @end lilypond
 
 @seealso
@@ -302,6 +312,7 @@ Internals Reference:
 
 No guitar special effects have been implemented.
 
+
 @node Fret diagram markups
 @subsubsection Fret diagram markups
 @cindex fret diagrams
-- 
2.39.2