From 4544984c71dc97ae82e77cc96d17d54a16a6f1cf Mon Sep 17 00:00:00 2001 From: Patrick Schmidt Date: Mon, 1 Feb 2010 18:10:11 +0100 Subject: [PATCH] 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. --- Documentation/notation/fretted-strings.itely | 84 ++++++++++++-------- Documentation/notation/percussion.itely | 22 ++++- Documentation/notation/pitches.itely | 20 ++--- 3 files changed, 77 insertions(+), 49 deletions(-) diff --git a/Documentation/notation/fretted-strings.itely b/Documentation/notation/fretted-strings.itely index 455ee8d222..0c3af38b5a 100644 --- 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' a - d, a' a + a,8 a' a + d, a' 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 + 1 + \break + \clef tab + 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 01dc17777c..a41a53a03a 100644 --- 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 b3854c94e0..f20b9f4dd4 100644 --- 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}. -- 2.39.2