From d573bd22fbc392bbd096612496052ce9e9db8a22 Mon Sep 17 00:00:00 2001
From: reuter <reuter>
Date: Tue, 19 Oct 2004 09:54:18 +0000
Subject: [PATCH] 	* Documentation/user/notation.itely: Added section on
 fret diagrams.

---
 ChangeLog                         |  2 ++
 Documentation/user/notation.itely | 55 ++++++++++++++++++++++++++++---
 2 files changed, 53 insertions(+), 4 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 05cc841a81..67efd90d30 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -3,6 +3,8 @@
 	* scm/fret-diagrams.scm (fret-diagram-terse): Fix mistake in internal
 	documentation for fret-diagram-terse
 
+	* Documentation/user/notation.itely: Added section on fret diagrams.
+
 2004-10-18  Jan Nieuwenhuizen  <janneke@gnu.org>
 
 	* scripts/convert-ly.py (usage): Fix --help description.  Apply
diff --git a/Documentation/user/notation.itely b/Documentation/user/notation.itely
index df79b699f2..de10780a6f 100644
--- a/Documentation/user/notation.itely
+++ b/Documentation/user/notation.itely
@@ -4410,6 +4410,7 @@ This section discusses issues that arise when writing popular music.
 * Chord names::                 
 * Chords mode::                 
 * Printing chord names::        
+* Fret diagrams::               
 * Improvisation::               
 @end menu
 
@@ -4417,10 +4418,10 @@ This section discusses issues that arise when writing popular music.
 @subsection Chord names
 @cindex Chords
 
-LilyPond has support for both printing chord names.  Chords may be
-entered in musical chord notation, i.e. @code{< .. >}, but they can
-also be entered by name.  Internally, the chords are represented as a
-set of pitches, so they can be transposed
+LilyPond has support for printing chord names.  Chords may be entered
+in musical chord notation, i.e. @code{< .. >}, but they can also be
+entered by name.  Internally, the chords are represented as a set of
+pitches, so they can be transposed
 
 
 @lilypond[quote,raggedright,verbatim,raggedright]
@@ -4730,6 +4731,52 @@ may result in strange chord names when chords are entered with the
 @code{< .. >} syntax.
 
 
+@node Fret diagrams
+@subsection Fret diagrams
+@cindex fret diagrams
+@cindex chord diagrams
+
+Fret diagrams can be added to music as a markup to the desired note. The
+markup contains information about the desired fret diagram, as shown in the
+following example
+
+@lilypond[verbatim, raggetright, quote]
+\context Voice {
+  d' ^\markup \fret-diagram #"6-x;5-x;4-o;3-2;2-3;1-2;"
+  fis' ^\markup \override #'(size . 0.75) {
+    \override #'(finger-code . below-string) {
+      \fret-diagram-verbose #'((place-fret 6 2 1) (barre 6 1 2)
+                               (place-fret 5 4 3) (place-fret 4 4 4)
+                               (place-fret 3 3 2) (place-fret 2 2 1)
+                               (place-fret 1 2 1))
+    }
+  }
+  c' ^\markup  \override #'(dot-radius . 0.35) {
+    \override #'(finger-code . in-dot) {
+      \override #'(dot-color . white) {
+        \fret-diagram-terse #"x;3-1-(;5-2;5-3;5-4;3-1-);"
+      }
+    }
+  }
+}
+@end lilypond
+
+
+There are three different fret-diagram markup interfaces: standard, terse,
+and verbose.  The three interfaces produce equivalent markups, but have
+varying amounts of information in the markup string.  Details about the
+markup interfaces are found at @ref{Overview of text markup commands}. 
+
+You can set a number of graphical properties according to your preference.
+Details about the property interface to fret diagrams are found at 
+@internalsref{fret-diagram-interface}.
+
+
+@seealso
+
+Examples: @inputfileref{input/test,fret-diagram.ly}
+
+
 @node Improvisation
 @subsection Improvisation
 
-- 
2.39.5