From abf536ef2c251ebf13d7ad9ed432fc3bbb9c5c63 Mon Sep 17 00:00:00 2001
From: Trevor Daniels <t.daniels@treda.co.uk>
Date: Mon, 6 Oct 2008 15:43:07 +0100
Subject: [PATCH] Docs: NR 2.3 unfretted - prune a bit   (thanks Graham)

---
 Documentation/user/unfretted-strings.itely | 49 ++++++++--------------
 1 file changed, 17 insertions(+), 32 deletions(-)

diff --git a/Documentation/user/unfretted-strings.itely b/Documentation/user/unfretted-strings.itely
index 010cd0ff30..f57b682895 100644
--- a/Documentation/user/unfretted-strings.itely
+++ b/Documentation/user/unfretted-strings.itely
@@ -37,8 +37,8 @@ be required for some double-stopped or divisi passages.
 * Snap (Bartók) pizzicato::
 @end menu
 
-@node References for unfretted strings
 @unnumberedsubsubsec References for unfretted strings
+@node References for unfretted strings
 
 Most of the notation which is useful for orchestral strings
 and other bowed instruments is covered elsewhere:
@@ -51,20 +51,9 @@ added as simple text -- see @ref{Text scripts}.
 @item Fingerings, including the thumb indication, are described
 in @ref{Fingering instructions}.
 
-@item When writing for orchestral strings, slurs are used to
-indicate passages which should be bowed in a continuous movement.
-For details, see @ref{Slurs}.
-
 @item Double stopping is normally indicated by writing a chord,
-see @ref{Chorded notes}.  A triple or quadruple stop might be
-indicated by a square bracket to indicate the notes should be
-played simultaneously rather than arpeggiated.  A square bracket
-is also used to indicate the two notes of a double stop should be
-played divisi by the two players on the stand.  A bracket arpeggio
-can be used to bracket notes together, see @ref{Arpeggio}.
-
-@item For passages which require two voices see @rlearning{I'm
-hearing Voices} and @ref{Single-staff polyphony}.
+see @ref{Chorded notes}.  Directives for playing chords may be
+added, see @ref{Arpeggio}.
 
 @item A template for a string quartet can be found in
 @rlearning{String quartet}.  Others are shown in the snippets.
@@ -73,16 +62,13 @@ hearing Voices} and @ref{Single-staff polyphony}.
 
 @seealso
 Learning Manual:
-@rlearning{I'm hearing Voices},
 @rlearning{String quartet}.
 
 Notation Reference:
 @ref{Text scripts},
 @ref{Fingering instructions},
-@ref{Slurs},
 @ref{Chorded notes},
-@ref{Arpeggio}
-@ref{Single-staff polyphony}.
+@ref{Arpeggio}.
 
 Snippets:
 @rlsr{Unfretted strings}.
@@ -110,7 +96,7 @@ c4(\downbow d) e(\upbow f)
 @seealso
 
 Notation Reference:
-@ref{Articulations and ornamentations}
+@ref{Articulations and ornamentations},
 @ref{Slurs}.
 
 @node Harmonics
@@ -125,18 +111,20 @@ Notation Reference:
 
 Natural harmonics can be notated in several ways.  A diamond-shaped
 note head generally means to touch the string where you would stop
-the note if it were not a diamond.  Diamond note heads are created
-by placing @code{\harmonic} after the note and enclosing the whole
-in angle brackets.
+the note if it were not a diamond.
+
+@warning{Harmonics @strong{must} be defined inside a chord
+construct even if there is only a single note.}
+
+@c TODO If the default for harmonicDots is changed, change this
 Dotted harmonics indicated with @code{\harmonic} do not show the
 dots.  The context property @code{harmonicDots} should be set if
 dots are required.
 
-
 @lilypond[verbatim,quote,relative=2]
-<b\harmonic>4 <b\harmonic>2.
+<d\harmonic>4 <e\harmonic>2.
 \set harmonicDots = ##t
-<b\harmonic>4 <b\harmonic>2.
+<d\harmonic>4 <e\harmonic>2.
 @end lilypond
 
 Alternatively a normal note head is shown at the pitch to be
@@ -144,7 +132,7 @@ sounded together with a small circle to indicate it should be
 played as a harmonic:
 
 @lilypond[verbatim,quote,relative=2]
-d4^\flageolet d_\flageolet
+d2^\flageolet d_\flageolet
 @end lilypond
 
 A smaller circle may be created, see the snippet list in
@@ -158,10 +146,6 @@ A smaller circle may be created, see the snippet list in
 Artificial harmonics are notated with two notes, one with a normal
 note head indicating the stopped position and one with an open
 diamond note head to indicate the harmonic position.
-They are entered by marking the harmonic pitch with @code{\harmonic}.
-Note the @code{\harmonic} command must be placed within the angle
-brackets signifying the chord.  The example shows the notation for a
-fourth and a fifth harmonic.
 
 @lilypond[verbatim,quote,relative=1]
 <e a\harmonic>2  <c g'\harmonic>
@@ -183,7 +167,8 @@ Notation Reference:
 @cindex Bartók pizzicato
 @cindex snap pizzicato
 
-TBC
-@c TODO add Bartók pizz as a @lilypondfile
+@snippets
 
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{snap-pizzicato-markup-bartok-pizzicato.ly}
 
-- 
2.39.5