Run scripts/auxiliar/update-with-convert-ly.sh

[lilypond.git] / Documentation / notation / unfretted-strings.itely

diff --git a/Documentation/notation/unfretted-strings.itely b/Documentation/notation/unfretted-strings.itely
index 5b1a35c9a4ded332b8d86eef220175e7df848845..a112331f14b6fffce9b47e2edafd94a2d3dd51d4 100644 (file)
--- a/Documentation/notation/unfretted-strings.itely
+++ b/Documentation/notation/unfretted-strings.itely
@@ -3,10 +3,11 @@
     Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
 
     When revising a translation, copy the HEAD committish of the
-    version that you are working on.  See TRANSLATION for details.
+    version that you are working on.  For details, see the Contributors'
+    Guide, node Updating translation committishes..
 @end ignore
 
-@c \version "2.12.0"
+@c \version "2.16.0"
 
 @node Unfretted string instruments
 @section Unfretted string instruments
@@ -64,7 +65,6 @@ added, see @ref{Arpeggio}.
 
 @end itemize
 
-
 @seealso
 Learning Manual:
 @rlearning{String quartet}.
@@ -119,7 +119,6 @@ a2^\markup { \small "sul A" }
 @code{\open}.
 @endpredefined
 
-
 @seealso
 Notation Reference:
 @ref{Articulations and ornamentations},
@@ -133,25 +132,24 @@ Notation Reference:
 
 @strong{@i{Natural harmonics}}
 
+@cindex note heads, diamond-shaped
+@cindex diamond-shaped note heads
 @cindex natural harmonics
 @cindex harmonics, natural
+@funindex \harmonicsOn
+@funindex \harmonicsOff
 
 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.
 
-@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]
-<d\harmonic>4 <e\harmonic>2.
-\set harmonicDots = ##t
-<d\harmonic>4 <e\harmonic>2.
+d4 e4.
+\harmonicsOn
+d8 e e
+d4 e4.
+\harmonicsOff
+d8 e e
 @end lilypond
 
 Alternatively a normal note head is shown at the pitch to be
@@ -168,16 +166,26 @@ A smaller circle may be created, see the snippet list in
 @strong{@i{Artificial harmonics}}
 
 @cindex artificial harmonics
-@cindex harmonics, artifical
+@cindex harmonics, artificial
 
 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.
 
+@c TODO If the default for harmonicDots is changed, change this
+Artificial 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=1]
-<e a\harmonic>2  <c g'\harmonic>
+<e a\harmonic>2.  <c g'\harmonic>4
+\set harmonicDots = ##t
+<e a\harmonic>2.  <c g'\harmonic>4
 @end lilypond
 
+@warning{@code{@bs{}harmonic} @strong{must} be placed inside a
+chord construct even if there is only a single note.  Normally
+@code{@bs{}harmonicsOn} would be used in this situation.}
 
 @seealso
 Music Glossary:
@@ -196,7 +204,15 @@ Notation Reference:
 @cindex Bartók pizzicato
 @cindex snap pizzicato
 
-@snippets
+A @notation{snap pizzicato} (also known as @qq{Bartok pizz}) is a
+type of pizzicato where the string is deliberately plucked upwards
+(rather than sideways) such that it hits the fingerboard.
+
+@lilypond[verbatim,quote,relative=1]
+c4\snappizzicato
+<c' e g>4\snappizzicato
+<c' e g>4^\snappizzicato
+<c, e g>4_\snappizzicato
+@end lilypond
+
 
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
-{snap-pizzicato-markup-bartok-pizzicato.ly}