From: Carl Sorensen <c_sorensen@byu.edu>
Date: Thu, 7 Aug 2008 19:57:36 +0000 (-0600)
Subject: Saving status that won't build docs
X-Git-Tag: release/2.11.56-1~2^2~43^2~12^2~2
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=246f5e5be798c22334f0cc3765982c6f1c6b520f;p=lilypond.git

Saving status that won't build docs
---

diff --git a/Documentation/user/fretted-strings.itely b/Documentation/user/fretted-strings.itely
index 383d974e43..0cf29233f1 100644
--- a/Documentation/user/fretted-strings.itely
+++ b/Documentation/user/fretted-strings.itely
@@ -625,32 +625,76 @@ Fret diagrams can be displayed using the @code{FretBoards} context.  By
 default, the @code{FretBoards} context will display fret diagrams that
 are stored in a lookup table:
 
-TODO -- simple example of fretboards
+@lilypond[verbatim, ragged-right, quote]
+\context FretBoards {
+  \chordmode {
+    c1 d
+  }
+}
+@end lilypond
 
 Fret diagrams are stored based on the pitches of a chord and the value of 
 @code{StringTunings} that is currently in use.  Currently, predefined chords
 are available only for @code{guitar-tuning}.  Chord pitches can be entered
-either as simultaneous music or using chord mode TODO add ref.
+either as simultaneous music or using chord mode (see 
+@ref{Chord mode overview}).
 
-TODO -- example of different chords, with and without chordmode 
+@lilypond[verbatim, ragged-right,quote]
+\context FretBoards {
+  \chordmode {c1}
+  <c' e' g'>1
+}
+@end lilypond
 
 It is common that both chord names and fret diagrams are displayed together.
 This is achieved by putting a @code{ChordNames} context in parallel with
 a @code{FretBoards} context and giving both contexts the same music.
 
-TODO -- example of ChordNames in parallel with FretBoards
+@lilypond[verbatim, ragged-right, quote]
+mychords = \chordmode{
+  c1 f g
+}
+
+<<
+  \context ChordNames {
+    \mychords
+  }
+  \context FretBoards {
+    \mychords
+  }
+>>
+@end lilypond
 
 Predefined fret diagrams are transposable, as long as a diagram for the
 transposed chord is stored in the fret diagram table.  
 
-TODO -- example of transposition
+@lilypond[verbatim, ragged-right, quote]
+mychords = \chordmode{
+  c1 f g
+}
+
+mychordlist = {
+  \mychords
+  \transpose c e { \mychords}
+}
+<<
+  \context ChordNames {
+    \mychordlist
+  }
+  \context FretBoards {
+    \mychordlist
+  }
+>>
+@end lilypond
+
 
 The predefined fret diagram table contains seven chords (major, minor,
 augmented, diminished, dominant seventh, major seventh, minor seventh)
 for each of 17 keys (C, C\sharp?, D\flat, D, D\sharp, E\flat, E, F,
 F\sharp, G\flat, G, G\sharp, A\flat, A, A\sharp, B\flat, and B).  A
-complete list of the predefined fret diagrams is shown in TODO ref to
-appendix. If there is no entry in the table for a chord, the FretBoards
+complete list of the predefined fret diagrams is shown in 
+@ref{Predefined fretboard diagrams}.  If there is no entry 
+in the table for a chord, the FretBoards
 engraver will calculate a fret-diagram using the automatic fret diagram
 functionality described in @ref{Automatic fret diagrams}.
 
@@ -668,7 +712,12 @@ octaves of pitches.
 TODO -- show the use of different fret diagrams
 
 In addition to fret diagrams, LilyPond stores an internal list of chord
-shapes.  
+shapes.  The chord shapes are fret diagrams that can be shifted along
+the neck to different posistions to provide different chords.  Chord
+shapes can be added to the internal list and then used to define
+predefined fret diagrams.
+
+TODO -- snippet with power chords 
 
 The appearance of the fret diagrams is controlled using the 
 @code{fret-diagram-interface}, which is explained in TODO add ref.
@@ -690,6 +739,7 @@ which can be used to play the notes.
      }
   }
   \context FretBoards {
+  \predefinedDiagramsOff
     < f, c f a c' f'>1
     < g,\6 b, d g b g'>
   }
@@ -714,6 +764,7 @@ context.
      }
   }
   \context FretBoards {
+  \predefinedDiagramsOff
     < c e g c' e' > 1
     < c\5 e g c' e' > 1
     < d a d' f'>
@@ -739,6 +790,7 @@ Fingerings can be added to FretBoard fret diagrams.
      }
   }
   \context FretBoards {
+  \predefinedDiagramsOff
     < c\5-3 e-2 g c'-1 e' > 1
     < d\4 a-2 d'-3 f'-1>
   }
diff --git a/Documentation/user/notation-appendices.itely b/Documentation/user/notation-appendices.itely
index b47dd2ece6..396da816d2 100644
--- a/Documentation/user/notation-appendices.itely
+++ b/Documentation/user/notation-appendices.itely
@@ -15,6 +15,7 @@
 @menu
 * Chord name chart::            
 * Common chord modifiers::
+* Predefined fretboard diagrams::
 * MIDI instruments::            
 * List of colors::              
 * The Feta font::               
@@ -371,6 +372,15 @@ TODO
 
 @end multitable
 
+@node Predefined fretboard diagrams
+@appendixsec Predefined fretboard diagrams
+
+The chart below shows the predefined fretboard diagrams.
+
+@ignore
+@lilypondfile{predefined-fretboard-diagrams.ly}
+@end ignore
+
 @node MIDI instruments
 @appendixsec MIDI instruments
 
diff --git a/ly/declarations-init.ly b/ly/declarations-init.ly
index 88fdfe1c03..23df48ad0e 100644
--- a/ly/declarations-init.ly
+++ b/ly/declarations-init.ly
@@ -120,4 +120,4 @@ setDefaultDurationToQuarter = { c4 }
 #(define book-text-handler ly:book-add-score!)
 
 
-\include "predefined-fretboards-init.ly"
+%\include "predefined-fretboards-init.ly"