Imported Upstream version 2.19.45

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

diff --git a/Documentation/notation/unfretted-strings.itely b/Documentation/notation/unfretted-strings.itely
index fcaff9d4dc85acc92e8547ed2c1611b04b556982..becdc6f3e137a1469fa78ed6a4d3965ae8b5a09e 100644 (file)
--- a/Documentation/notation/unfretted-strings.itely
+++ b/Documentation/notation/unfretted-strings.itely
@@ -7,7 +7,7 @@
     Guide, node Updating translation committishes..
 @end ignore
 
-@c \version "2.16.0"
+@c \version "2.18.0"
 
 @node Unfretted string instruments
 @section Unfretted string instruments
@@ -85,12 +85,14 @@ Snippets:
 @funindex \upbow
 @funindex \downbow
 @funindex \open
+@funindex \romanStringNumbers
 
 @cindex bowing indications
 @cindex up bow indication
 @cindex down bow indication
 @cindex open string indication
 @cindex string, indicating open
+@cindex string numbers
 
 Bowing indications are created as articulations, which are
 described in @ref{Articulations and ornamentations}.
@@ -98,30 +100,39 @@ described in @ref{Articulations and ornamentations}.
 The bowing commands, @code{\upbow} and @code{\downbow}, are used
 with slurs as follows:
 
-@lilypond[verbatim,quote,relative=2]
-c4(\downbow d) e(\upbow f)
+@lilypond[verbatim,quote]
+\relative { c''4(\downbow d) e(\upbow f) }
 @end lilypond
 
 @noindent
-and the following example shows three ways in which an open A
-string on a violin might be indicated:
 
-@lilypond[verbatim,quote,relative=2]
-a4 \open
-a^\markup { \teeny "II" }
-a2^\markup { \small "sul A" }
+Roman numerals can be added as strings numbers (rather
+than the default circled Arabic numbers), as explained in
+@ref{String number indications}.
+
+Alternatively, string indications may be printed using
+markup commands; articulation scripts may also indicate
+open strings.
+
+@lilypond[verbatim,quote,fragment]
+a'4 \open
+\romanStringNumbers
+a'\2
+a'2^\markup { \small "sul A" }
 @end lilypond
 
 
 @predefined
 @code{\downbow},
 @code{\upbow},
-@code{\open}.
+@code{\open},
+@code{\romanStringNumbers}.
 @endpredefined
 
 @seealso
 Notation Reference:
 @ref{Articulations and ornamentations},
+@ref{String number indications},
 @ref{Slurs}.
 
 
@@ -143,21 +154,23 @@ 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.
 
-@lilypond[verbatim,quote,relative=2]
-d4 e4.
-\harmonicsOn
-d8 e e
-d4 e4.
-\harmonicsOff
-d8 e e
+@lilypond[verbatim,quote]
+\relative d'' {
+  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
 sounded together with a small circle to indicate it should be
 played as a harmonic:
 
-@lilypond[verbatim,quote,relative=2]
-d2^\flageolet d_\flageolet
+@lilypond[verbatim,quote,fragment]
+d''2^\flageolet d''_\flageolet
 @end lilypond
 
 A smaller circle may be created, see the snippet list in
@@ -177,10 +190,12 @@ 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>4
-\set harmonicDots = ##t
-<e a\harmonic>2.  <c g'\harmonic>4
+@lilypond[verbatim,quote]
+\relative e' {
+  <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
@@ -208,11 +223,13 @@ 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
+@lilypond[verbatim,quote]
+\relative {
+  c'4\snappizzicato
+  <c' e g>4\snappizzicato
+  <c' e g>4^\snappizzicato
+  <c, e g>4_\snappizzicato
+}
 @end lilypond