From 880345bde8a2c8be5bf2bcac5704a051909894ba Mon Sep 17 00:00:00 2001
From: Andrew Hawyluk <ahawryluk@gmail.com>
Date: Tue, 9 Dec 2008 09:37:00 +0000
Subject: [PATCH] Docs: NR 2.2 Keyboards: Add harp references

---
 Documentation/user/keyboards.itely | 54 +++++++++++++++++++-----------
 1 file changed, 34 insertions(+), 20 deletions(-)

diff --git a/Documentation/user/keyboards.itely b/Documentation/user/keyboards.itely
index 82b097dca4..753f2acfd0 100644
--- a/Documentation/user/keyboards.itely
+++ b/Documentation/user/keyboards.itely
@@ -31,7 +31,7 @@ keyboard.
 @subsection Common notation for keyboards
 
 This section discusses notation issues that may arise for most
-many-stringed instruments.
+keyboard instruments.
 
 @menu
 * References for keyboards::
@@ -99,6 +99,10 @@ as shown in @rlearning{Other uses for tweaks}.
 
 @end itemize
 
+@c @snippets
+@c @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@c {forcing-visibility-of-systems-with-multi-bar-rests-when-using-\RemoveEmptyStaffContext.ly}
+@c http://lsr.dsi.unimi.it/LSR/Item?u=1&id=312
 
 @seealso
 Learning Manual:
@@ -561,31 +565,40 @@ Snippets:
 @node Harp
 @subsection Harp
 
+This section discusses notation issues that are unique to the harp.
+
 @menu
-* Harp notation::
+* References for harps::
 * Harp pedals::
 @end menu
 
-@node Harp notation
-@unnumberedsubsubsec Harp notation
+@node References for harps
+@unnumberedsubsubsec References for harps
+@cindex harps
+@cindex bisbiglando
 
-TBC
+Some common characteristics of harp music are covered elsewhere:
 
-@ignore
-Some possibilities:
-- glissandi
-- tremolo (for bisbigliando)
-- natural harmonics
-- directional arpeggio and non-arpeggio
-- workaroung for keeping both staves visible in an orchestral
-  score,
-http://lists.gnu.org/archive/html/lilypond-user/2007-08/msg00386.html
-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
+@itemize
+
+@item The glissando is the most characterisic harp technique,
+@ref{Glissando}.
+
+@item A @notation{bisbigliando} is written as a tremelo @ref{Tremolo
+repeats}
+
+@item Natural harmonics are covered under @ref{Harmonics}.
+
+@item For directional arpeggios and non-arpeggios, see @ref{Arpeggio}.
+
+@end itemize
+
+@seealso
+Notation Reference:
+@ruser{Tremelo Repeats}
+@ruser{Glissando}
+@ruser{Arpeggio}
+@ruser{Harmonics}
 
 @node Harp pedals
 @unnumberedsubsubsec Harp pedals
@@ -625,3 +638,4 @@ position (sharpened pitch), and @code{|} is the divider. A prefixed
 @seealso
 Notation Reference:
 @ruser{Text scripts}
+@ruser{Instrument Specific Markup}
-- 
2.39.2