Docs: NR 2.2 Keyboard: Add Harp

diff --git a/Documentation/user/keyboards.itely b/Documentation/user/keyboards.itely
index 308fb9389c918b53cc3b02d9537c3fab38a7b804..d612d0e6d3e869823b82bf4e7360a5646b853ad9 100644 (file)
--- a/Documentation/user/keyboards.itely
+++ b/Documentation/user/keyboards.itely
@@ -561,6 +561,9 @@ Snippets:
 @node Harp
 @subsection Harp
 
+@node Harp Notation
+@unnumberedsubsubsection Harp Notation
+
 TBC
 
 @ignore
@@ -577,6 +580,43 @@ and http://lsr.dsi.unimi.it/LSR/Item?u=1&id=312
 An LSR snippet could be used to demonstrate the main items; in the
 case of glissandi, it would be desirable to have a demonstration
 of different styles.
-
 @end ignore
 
+@node Harp Pedals
+@unnumberedsubsubsection Harp Pedals
+
+@cindex harp pedals
+@cindex harp pedal diagrams
+@cindex pedals, harp
+@cindex pedal diagrams, harp
+
+Harp have seven strings per ocatve that may be sound the natural,
+flattened, or sharpened pitch. In lever harps, each string is adjusted
+individually, but in pedal harps every string with the same pitch name
+is controlled by a single pedal. From the player's left to right, the
+pedals are D, C, and B on the left and E, F, G, and A on the right.
+The position of the pedals may be indicated with text marks
+
+@lilypond[quote,verbatim,relative=2]
+\textLengthOn
+cis1_\markup \concat \vcenter { [D \flat C \sharp B|E \sharp F \sharp G A \flat] }
+c!1_\markup \concat \vcenter {[ C \natural ]}
+@end lilypond
+
+or pedal diagrams:
+
+@lilypond[quote,verbatim,relative=2]
+\textLengthOn
+cis1_\markup { \harp-pedal #"^v-|vv-^" }
+c!1_\markup { \harp-pedal #"^o--|vv-^" }
+@end lilypond
+
+The @code{\harp-pedal} command accepts a string of characters, where
+@code{^} is the highest pedal position (flattened pitch), @code{-} is
+the middle pedal postion (natural pitch), @code{v} is the lowest pedal
+position (sharpened pitch), and @code{|} is the divider. An @code{o}
+will circle a particular pedal symbol.
+
+@seealso
+Notation Reference:
+@ruser{Text scripts}