*** empty log message ***

[lilypond.git] / Documentation / user / instrument-notation.itely

diff --git a/Documentation/user/instrument-notation.itely b/Documentation/user/instrument-notation.itely
index 5298df173d597727e70322a6313c136bf373e465..4185e1a1d4c9f7f937bb4c4433d9f373468a2b64 100644 (file)
--- a/Documentation/user/instrument-notation.itely
+++ b/Documentation/user/instrument-notation.itely
@@ -15,7 +15,7 @@ This chapter explains how to use notation for specific instruments.
 * Chord names::                 
 * Vocal music::                 
 * Rhythmic music::              
-* Tablatures::                  
+* Guitar ::                     
 * Ancient notation::            
 * Other instrument specific notation::  
 @end menu
@@ -240,14 +240,14 @@ can be printed automatically.  This is switched on by setting
 @code{followVoice} to true
 
 @lilypond[quote,raggedright,fragment,relative=1,verbatim]
-\context PianoStaff <<
-  \set followVoice = ##t
-  \context Staff \context Voice {
+\new PianoStaff <<
+  \context Staff=one {
+    \set followVoice = ##t
     c1
     \change Staff=two
     b2 a
   }
- \context Staff=two { \clef bass \skip 1*2 }
+  \context Staff=two { \clef bass \skip 1*2 }
 >>
 @end lilypond
 
@@ -1437,7 +1437,7 @@ The complete list of drum names is in the init file
 
 @seealso
 
-Program reference: @internalsref{DrumNoteEvent}.
+Program reference: @internalsref{note-event}.
 
 @node Percussion staves
 @subsection Percussion staves
@@ -1463,7 +1463,7 @@ down = \drummode { bassdrum4 snare8 bd r bd sn4 }
 
 The above example shows verbose polyphonic notation.  The short
 polyphonic notation, described in @ref{Polyphony}, can also be used if
-the @internalsref{DrumVoices} are instantiated by hand first.  For example,
+the @internalsref{DrumVoice}s are instantiated by hand first.  For example,
 
 @lilypond[quote,raggedright,fragment,verbatim]
 \new DrumStaff <<
@@ -1657,27 +1657,49 @@ for this purpose instead.
 
 
 
-@node Tablatures
-@section Tablatures
+@node Guitar 
+@section Guitar
 
 @cindex tablature
 @cindex guitar tablature
 
-Tablature notation is used for notating music for plucked string
-instruments.  Pitches are not denoted with note heads, but by
-indicating on which string and fret a note must be played.  LilyPond
-offers limited support for tablature.
-
 @menu
+* String number indications::   
 * Tablatures basic::            
 * Non-guitar tablatures::       
 * Fret diagrams::               
 @end menu
 
+@node String number indications
+@subsection String number indications
+
+@cindex String numbers
+
+String numbers can be added to chords, by indicating the string number
+with @code{\}@var{number}, 
+
+@lilypond[relative,relative=1,raggedright,fragment]
+<c\1 e\2 g\3>
+@end lilypond
+
+See also @inputfileref{input/regression,string-number.ly}.
+
+
+@seealso
+
+Program reference: @internalsref{StringNumber},
+@internalsref{StringNumberEvent}
+
+
 @node Tablatures basic
 @subsection Tablatures basic
 @cindex Tablatures basic
 
+Tablature notation is used for notating music for plucked string
+instruments.  Pitches are not denoted with note heads, but by
+numbers indicating on which string and fret a note must be played.  LilyPond
+offers limited support for tablature.
+
 The string number associated to a note is given as a backslash
 followed by a number, e.g., @code{c4\3} for a C quarter on the third
 string.  By default, string 1 is the highest one, and the tuning
@@ -2101,7 +2123,9 @@ petrucci style mensural C clefs, for use on different staff lines
 @code{petrucci-c5}
 @tab
 @lilypond[fragment,relative=1,notime]
-  \clef "petrucci-c2" c
+  \clef "petrucci-c2"
+  \override NoteHead #'style = #'mensural
+  c
 @end lilypond
 
 @item
@@ -2110,7 +2134,9 @@ petrucci style mensural F clef
 @code{petrucci-f}
 @tab
 @lilypond[fragment,relative=1,notime]
-  \clef "petrucci-f" c
+  \clef "petrucci-f"
+  \override NoteHead #'style = #'mensural
+  c
 @end lilypond
 
 @item
@@ -2119,7 +2145,9 @@ petrucci style mensural G clef
 @code{petrucci-g}
 @tab
 @lilypond[fragment,relative=1,notime]
-  \clef "petrucci-g" c
+  \clef "petrucci-g"
+  \override NoteHead #'style = #'mensural
+  c
 @end lilypond
 
 @item
@@ -2129,7 +2157,9 @@ historic style mensural C clef
 @code{mensural-c3}, @code{mensural-c4}
 @tab
 @lilypond[fragment,relative=1,notime]
-  \clef "mensural-c2" c
+  \clef "mensural-c2"
+  \override NoteHead #'style = #'mensural
+  c
 @end lilypond
 
 @item
@@ -2138,7 +2168,9 @@ historic style mensural F clef
 @code{mensural-f}
 @tab
 @lilypond[fragment,relative=1,notime]
-  \clef "mensural-f" c
+  \clef "mensural-f"
+  \override NoteHead #'style = #'mensural
+  c
 @end lilypond
 
 @item
@@ -2147,7 +2179,9 @@ historic style mensural G clef
 @code{mensural-g}
 @tab
 @lilypond[fragment,relative=1,notime]
-  \clef "mensural-g" c
+  \clef "mensural-g"
+  \override NoteHead #'style = #'mensural
+  c
 @end lilypond
 
 @item
@@ -2158,7 +2192,12 @@ Editio Vaticana style do clef
 @tab
 @lilypond[fragment,relative=1,notime]
   \override Staff.StaffSymbol #'line-count = #4
-  \clef "vaticana-do2" c
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'vaticana.punctum
+  \clef "vaticana-do2"
+  c
 @end lilypond
 
 @item
@@ -2168,7 +2207,12 @@ Editio Vaticana style fa clef
 @tab
 @lilypond[fragment,relative=1,notime]
   \override Staff.StaffSymbol #'line-count = #4
-  \clef "vaticana-fa2" c
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'vaticana.punctum
+  \clef "vaticana-fa2"
+  c
 @end lilypond
 
 @item
@@ -2179,7 +2223,12 @@ Editio Medicaea style do clef
 @tab
 @lilypond[fragment,relative=1,notime]
   \override Staff.StaffSymbol #'line-count = #4
-  \clef "medicaea-do2" c
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'medicaea.punctum
+  \clef "medicaea-do2"
+  c
 @end lilypond
 
 @item
@@ -2189,7 +2238,12 @@ Editio Medicaea style fa clef
 @tab
 @lilypond[fragment,relative=1,notime]
   \override Staff.StaffSymbol #'line-count = #4
-  \clef "medicaea-fa2" c
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'medicaea.punctum
+  \clef "medicaea-fa2"
+  c
 @end lilypond
 
 @item
@@ -2200,7 +2254,12 @@ historic style hufnagel do clef
 @tab
 @lilypond[fragment,relative=1,notime]
   \override Staff.StaffSymbol #'line-count = #4
-  \clef "hufnagel-do2" c
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'hufnagel.punctum
+  \clef "hufnagel-do2"
+  c
 @end lilypond
 
 @item
@@ -2210,7 +2269,12 @@ historic style hufnagel fa clef
 @tab
 @lilypond[fragment,relative=1,notime]
   \override Staff.StaffSymbol #'line-count = #4
-  \clef "hufnagel-fa2" c
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'hufnagel.punctum
+  \clef "hufnagel-fa2"
+  c
 @end lilypond
 
 @item
@@ -2219,7 +2283,12 @@ historic style hufnagel combined do/fa clef
 @code{hufnagel-do-fa}
 @tab
 @lilypond[fragment,relative=1,notime]
-  \clef "hufnagel-do-fa" c
+  \override Staff.StaffSymbol #'color = #red
+  \override Staff.LedgerLineSpanner #'color = #red
+  \override Voice.Stem #'transparent = ##t
+  \override NoteHead #'style = #'hufnagel.punctum
+  \clef "hufnagel-do-fa"
+  c
 @end lilypond
 @end multitable
 
@@ -2302,12 +2371,14 @@ following table
 @lilypond[quote,raggedright]
 \layout {
   indent = 0.0
-  \context { \Staff
+  \context {
+    \Staff
     \remove Staff_symbol_engraver
     \remove Clef_engraver
     \remove Time_signature_engraver
   }
-} {
+}
+{
   \set Score.timing = ##f
   \set Score.barAlways = ##t
   s_\markup { "\\time 4/4" }
@@ -2354,6 +2425,7 @@ The following examples show the differences in style,
 @lilypond[raggedright,fragment,relative=1,quote]
 {
   \fatText
+
   \time 2/2
   c1^\markup { \hspace #-2.0 \typewriter default }
 
@@ -2411,6 +2483,8 @@ Editio Vaticana style.
 \include "gregorian-init.ly"
 \score {
   \context VaticanaVoice {
+    \override Staff.StaffSymbol #'color = #red
+    \override Staff.LedgerLineSpanner #'color = #red
     \override TextScript #'font-family = #'typewriter
     \override TextScript #'font-shape = #'upright
     \override Script #'padding = #-0.1
@@ -2483,19 +2557,19 @@ supported are @code{vaticana}, @code{medicaea}, @code{hufnagel}, and
 \new Lyrics \lyricmode {
   \markup { \column {
     \typewriter "vaticana"
-    \line { " " \musicglyph #"custodes.vaticana-u0" }
+    \line { " " \musicglyph #"custodes.vaticana.u0" }
   } }
   \markup { \column {
     \typewriter "medicaea"
-    \line { " " \musicglyph #"custodes.medicaea-u0" }
+    \line { " " \musicglyph #"custodes.medicaea.u0" }
   }}
   \markup { \column {
     \typewriter "hufnagel"
-    \line { " " \musicglyph #"custodes.hufnagel-u0" }
+    \line { " " \musicglyph #"custodes.hufnagel.u0" }
   }}
   \markup { \column {
     \typewriter "mensural"
-    \line { " " \musicglyph #"custodes.mensural-u0" }
+    \line { " " \musicglyph #"custodes.mensural.u0" }
   }}
 }
 @end lilypond
@@ -3615,11 +3689,13 @@ initialize all relevant context properties and grob properties to
 proper values, so you can immediately go ahead entering the chant, as
 the following excerpt demonstrates
 
-@lilypond[quote,raggedright,verbatim]
+@lilypond[quote,raggedright,packed,verbatim]
 \include "gregorian-init.ly"
 \score {
   <<
     \context VaticanaVoice = "cantus" {
+      \override Staff.StaffSymbol #'color = #red
+      \override Staff.LedgerLineSpanner #'color = #red
       \override Score.BarNumber #'transparent = ##t {
         \[ c'\melisma c' \flexa a \]
         \[ a \flexa \deminutum g\melismaEnd \]
@@ -3719,16 +3795,18 @@ to the numbers
 @end lilypond
 
 Spaces or dashes may be inserted by using @code{_}.  Brackets are
-introduced with @code{[} and @code{]}
+introduced with @code{[} and @code{]}. You can also include text
+strings and text markups, see @ref{Overview of text markup commands}.
 
 @example
-< [4 6] 8 [_! 12] >
+< [4 6] 8 [_! 12] > < 5 \markup @{ + \number 6 @} >
 @end example
 @lilypond[quote,raggedright,fragment]
 \context FiguredBass
-\figuremode { < [4 6] 8 [_! 12] > }
+\figuremode { < [4 6] 8 [_! 12] > < 5 \markup{ + \number 6 } > }
 @end lilypond
 
+
 Although the support for figured bass may superficially resemble chord
 support, it works much simpler.  The @code{\figuremode} mode simply
 stores the numbers and @internalsref{FiguredBass} context prints