]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/user/notation.itely
* tex/GNUmakefile (TEX_FILES): add texinfo.cnf
[lilypond.git] / Documentation / user / notation.itely
index 2468ccbd5920f452a4100737bf6d7a11a77f6414..d63bdcd4aa2b0d1b43613b1eb75fe03f9a0da44a 100644 (file)
@@ -1,4 +1,4 @@
-@c Note: -*-texinfo-*-
+@c -*- coding: latin-1; mode: texinfo; -*-
 @c This file is part of lilypond.tely
 
 @c A menu is needed before every deeper *section nesting of @node's; run
@@ -236,9 +236,10 @@ must be done with multi-measure rests.  They are discussed in
 
 
 A rest's vertical position may be explicitly specified by entering a
-note with the @code{\rest} keyword appended.  This makes manual
-formatting in polyphonic music easier.  Automatic rest collision
-formatting will leave these rests alone
+note with the @code{\rest} keyword appended, the rest will be placed at
+the note's place.  This makes manual formatting in polyphonic music
+easier.  Automatic rest collision formatting will leave these rests
+alone
 
 @lilypond[fragment,quote,raggedright,verbatim]
 a'4\rest d'4\rest
@@ -305,11 +306,12 @@ Program reference: @internalsref{SkipEvent}, @internalsref{SkipMusic}.
 @cindex @code{\maxima}
 
 
-In Note, Chord, and Lyrics mode, durations are designated by numbers
-and dots: durations are entered as their reciprocal values.  For example,
-a quarter note is entered using a @code{4} (since it is a 1/4 note), while
-a half note is entered using a @code{2} (since it is a 1/2 note).  For notes
-longer than a whole you must use variables
+In Note, Chord, and Lyrics mode, durations are designated by numbers and
+dots: durations are entered as their reciprocal values.  For example, a
+quarter note is entered using a @code{4} (since it is a 1/4 note), while
+a half note is entered using a @code{2} (since it is a 1/2 note).  For
+notes longer than a whole you must use the variables @code{\longa} and
+@code{\breve}
 
 @example 
 c'\breve  
@@ -884,9 +886,9 @@ exactly on the bar line.
 
 @cindex @code{\key}
 
-The key signature indicates the scale in which a piece is played.  It
-is denoted by a set of alterations (flats or sharps) at the start of
-the staff.
+The key signature indicates the tonality in which a piece is played.  It
+is denoted by a set of alterations (flats or sharps) at the start of the
+staff.
 
 
 Setting or changing the key signature is done with the @code{\key}
@@ -4408,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
 
@@ -4415,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]
@@ -4686,7 +4689,7 @@ The predefined variables @code{\germanChords},
 @code{\semiGermanChords} set these variables.  The effect is
 demonstrated here,
 
-@lilypondfile[raggedright,]{chord-names-german.ly}
+@lilypondfile[raggedright]{chord-names-german.ly}
 
 There are also two other chord name schemes implemented: an alternate
 Jazz chord notation, and a systematic scheme called Banter chords.  The
@@ -4728,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, raggedright, 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
 
@@ -5219,16 +5268,15 @@ rest, use @code{MultiMeasureRest.expand-limit}.
 @cindex fermata on multi-measure rest
 
 Texts can be added to multi-measure rests by using the
-@var{note}-@code{markup} syntax (see @ref{Text markup}).  In this case, the number is
-replaced.  If you need both texts and the number, you must add the
-number by hand.  A variable (@code{\fermataMarkup}) is provided for
+@var{note}-@code{markup} syntax (see @ref{Text markup}).  
+A variable (@code{\fermataMarkup}) is provided for
 adding fermatas
 
 
 @lilypond[quote,raggedright,verbatim,fragment]
   \set Score.skipBars = ##t
   \time 3/4
-  R2.*10^\markup { \number 10 }_\markup { "Ad lib" }
+  R2.*10^\markup { "Ad lib" }
   R2.^\fermataMarkup
 @end lilypond
 
@@ -7689,7 +7737,7 @@ teaching tools in addition to great musical scores.
 
 @menu
 * Balloon help::                
-* blank music sheet::           
+* Blank music sheet::           
 * Hidden notes::     
 * Easy Notation note heads::    
 @end menu
@@ -7729,8 +7777,8 @@ Examples: @inputfileref{input/regression,balloon.ly}.
 
 
 
-@node blank music sheet
-@subsection blank music sheet
+@node Blank music sheet
+@subsection Blank music sheet
 
 A blank music sheet can be produced also by using invisible notes, and
 removing @code{Bar_number_engraver}.