Doc: Improve clef documentation in NR

added index entries. added example for moderntab clef. moved tab clef to Default tablatures, moderntab clef to Custom tablatures and percussion clef to Basic percussion notation.

diff --git a/Documentation/notation/fretted-strings.itely b/Documentation/notation/fretted-strings.itely
index 455ee8d22244bf8c876e582b5687af896ef42bed..0c3af38b5aeb39a3513a105cf4618db5bf5ac4f5 100644 (file)
--- a/Documentation/notation/fretted-strings.itely
+++ b/Documentation/notation/fretted-strings.itely
@@ -148,23 +148,22 @@ Internals Reference:
 @funindex TabVoice
 
 Music for plucked string instruments is frequently notated using a
-finger/touch notation or tablature. In contrast to traditional
+finger/touch notation or tablature.  In contrast to traditional
 notation pitches are not denoted with note heads, but by numbers (or
-letterlike symbols in historical intavolatura). The numbers
-indicate on which string and fret a note must be played. The numbers
+letterlike symbols in historical intavolatura).  The numbers
+indicate on which string and fret a note must be played.  The numbers
 are printed on top of each other if they are to be played
 simultaneously.
 
+By default, string 1 is the highest, and the tuning defaults to the
+standard guitar tuning (with 6 strings).  The notes are printed as
+tablature, by using @code{TabStaff} and @code{TabVoice} contexts.  A
+calligraphic tablature clef is added automatically.
 
-By default, string 1 is the highest,
-and the tuning defaults to the standard guitar tuning (with 6 strings).
-The notes are printed as tablature, by using @code{TabStaff} and
-@code{TabVoice} contexts
-
-@lilypond[quote,ragged-right,fragment,verbatim]
+@lilypond[quote,ragged-right,verbatim]
 \new TabStaff \relative c' {
-       a,8 a' <c e> a
-       d, a' <d f> a
+  a,8 a' <c e> a
+  d, a' <d f> a
 }
 @end lilypond
 
@@ -215,10 +214,10 @@ symbols = {
 }
 @end lilypond
 
-@funindex minimumFret
-
 @cindex fret
 
+@funindex minimumFret
+
 By default pitches are assigned to the lowest playing position on the
 fret-board (first position). Open strings are automatically preferred.
 If you would like a certain pitch to be played on a specific string
@@ -254,15 +253,18 @@ the second alternative of a repeat.
 
 @lilypond[quote,ragged-right,verbatim]
 ties = \relative c' {
-       \repeat volta 2 {
-       e2. f4~
-       f2 g2~ }
-       \alternative {
-               { g4 f2. }
-               { g4\repeatTie c,2. }
-       }
-       b1~\break
-       b1  \bar "|."
+  \repeat volta 2 {
+    e2. f4~
+    f2 g2~
+  }
+  \alternative {
+     { g4 f2. }
+     { g4\repeatTie c,2. }
+  }
+  b1~
+  \break
+  b1
+  \bar "|."
 }
 
 \score {
@@ -291,15 +293,17 @@ engraving fret numbers in parentheses:
 
 @lilypond[quote,ragged-right,verbatim]
 ties = \relative c' {
-       \repeat volta 2 {
-       e2. f4~
-       f2 g2~ }
-       \alternative {
-               { g4 f2. }
-               { g4\repeatTie c,2. }
-       }
-       b1~\break
-       b1  \bar "|."
+  \repeat volta 2 {
+    e2. f4~
+    f2 g2~ }
+  \alternative {
+    { g4 f2. }
+    { g4\repeatTie c,2. }
+  }
+  b1~
+  \break
+  b1
+  \bar "|."
 }
 
 \score {
@@ -473,6 +477,24 @@ mynotes = {
 >>
 @end lilypond
 
+@cindex moderntab clef
+@cindex clef, moderntab
+@cindex clef, tab
+@cindex tab clef
+
+A modern tab clef can also be used.
+
+@lilypond[quote,ragged-right,verbatim]
+\new TabStaff {
+ \clef moderntab
+  <a, e a>1
+  \break
+  \clef tab
+  <a, e a>1
+}
+@end lilypond
+
+The modern tab clef supports tablatures from 4 to 7 strings.
 
 @seealso
 Installed Files:

diff --git a/Documentation/notation/percussion.itely b/Documentation/notation/percussion.itely
index 01dc17777ccf2738ee787e795bfa8384083923cf..a41a53a03a264da0fb55882f20483daba632caed 100644 (file)
--- a/Documentation/notation/percussion.itely
+++ b/Documentation/notation/percussion.itely
@@ -90,10 +90,24 @@ Each piece of percussion has a full name and an abbreviated name,
 and both can be used in input files.  The full list of percussion
 note names may be found in @ref{Percussion notes}.
 
-Note that the normal notation of pitches (such as @code{cis4}) in
-a @code{DrumStaff} context will cause an error message.
-Percussion clefs are added automatically to a @code{DrumStaff}
-contex, but other clefs may also be used.
+@cindex clef, percussion
+@cindex percussion clef
+
+Note that the normal notation of pitches (such as @code{cis4}) in a
+@code{DrumStaff} context will cause an error message. Percussion clefs
+are added automatically to a @code{DrumStaff} context but they can also
+be set explicitly.  Other clefs may be used as well.
+
+@lilypond[quote,ragged-right,verbatim]
+\drums {
+  \clef treble
+  hh4 hh hh hh
+  \break
+  \clef percussion
+  bd4 bd bd bd
+}
+@end lilypond
+
 
 There are a few issues concerning MIDI support for percussion
 instruments; for details please see @ref{Percussion in MIDI}.

diff --git a/Documentation/notation/pitches.itely b/Documentation/notation/pitches.itely
index b3854c94e0fdeb41e7038925c8ae41bbcf00891c..f20b9f4dd4c2cc7d578502d6d86e6398e28f3abe 100644 (file)
--- a/Documentation/notation/pitches.itely
+++ b/Documentation/notation/pitches.itely
@@ -892,9 +892,6 @@ This section discusses how to alter the output of pitches.
 @cindex baritone clef
 @cindex varbaritone clef
 @cindex subbass clef
-@cindex tab clef
-@cindex moderntab clef
-@cindex percussion clef
 @cindex clef
 @cindex ancient clef
 @cindex clef, ancient
@@ -942,17 +939,10 @@ c2 c
 c2 c
 \clef baritone
 c2 c
-
-\break
-
 \clef varbaritone
 c2 c
 \clef subbass
 c2 c
-\clef percussion
-c2 c
-\clef tab
-c2 c
 
 \break
 
@@ -989,9 +979,9 @@ c2 c
 c2 c
 @end lilypond
 
-Further supported clefs are described under
-@ref{Mensural clefs}, @ref{Gregorian clefs},
-and @ref{Custom tablatures}.
+Some special purpose clefs are described in @ref{Mensural clefs},
+@ref{Gregorian clefs}, @ref{Default tablatures}, @ref{Custom
+tablatures}, and @ref{Basic percussion notation}.
 
 @snippets
 
@@ -1003,7 +993,9 @@ and @ref{Custom tablatures}.
 Notation Reference:
 @ref{Mensural clefs},
 @ref{Gregorian clefs},
-@ref{Custom tablatures}.
+@ref{Default tablatures},
+@ref{Custom tablatures},
+@ref{Basic percussion notation}.
 
 Snippets:
 @rlsr{Pitches}.