Doc: CSS: A better brown for the usage manual

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

diff --git a/Documentation/notation/unfretted-strings.itely b/Documentation/notation/unfretted-strings.itely
index 97bc9c5608de126a42687e7159ca73bab378f659..f3eae557659034137a17fca8574dcec93dda7bd3 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.18.0"
 
 @node Unfretted string instruments
 @section Unfretted string instruments
@@ -59,15 +60,14 @@ in @ref{Fingering instructions}.
 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.
+@item Templates for string quartets can be found in
+@rlearning{String quartet templates}.  Others are shown in the snippets.
 
 @end itemize
 
-
 @seealso
 Learning Manual:
-@rlearning{String quartet}.
+@rlearning{String quartet templates}.
 
 Notation Reference:
 @ref{Text scripts},
@@ -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,31 +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}.
 
 
@@ -144,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
@@ -167,7 +179,7 @@ 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
@@ -178,17 +190,14 @@ 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
-chord construct even if there is only a single note.  Normally
-@code{@bs{}harmonicsOn} would be used in this situation.}
-
-
 @seealso
 Music Glossary:
 @rglos{harmonics}.
@@ -206,7 +215,17 @@ 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 {
+  c'4\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-bartok-pizzicato.ly}