Imported Upstream version 2.14.2

[lilypond.git] / Documentation / snippets / volta-text-markup-using-repeatcommands.ly

diff --git a/Documentation/snippets/volta-text-markup-using-repeatcommands.ly b/Documentation/snippets/volta-text-markup-using-repeatcommands.ly
new file mode 100644 (file)
index 0000000..b739b7b
--- /dev/null
+++ b/Documentation/snippets/volta-text-markup-using-repeatcommands.ly
@@ -0,0 +1,37 @@
+%% DO NOT EDIT this file manually; it is automatically
+%% generated from LSR http://lsr.dsi.unimi.it
+%% Make any changes in LSR itself, or in Documentation/snippets/new/ ,
+%% and then run scripts/auxiliar/makelsr.py
+%%
+%% This file is in the public domain.
+\version "2.14.0"
+
+\header {
+  lsrtags = "repeats, text"
+
+  texidoc = "
+Though volte are best specified using @code{\\repeat volta}, the
+context property @code{repeatCommands} must be used in cases where the
+volta text needs more advanced formatting with @code{\\markup}.
+
+
+Since @code{repeatCommands} takes a list, the simplest method of
+including markup is to use an identifier for the text and embed it in
+the command list using the Scheme syntax @code{#(list (list 'volta
+textIdentifier))}. Start- and end-repeat commands can be added as
+separate list elements:
+
+"
+  doctitle = "Volta text markup using repeatCommands"
+} % begin verbatim
+
+voltaAdLib = \markup { 1. 2. 3... \text \italic { ad lib. } }
+
+\relative c'' {
+  c1
+  \set Score.repeatCommands = #(list (list 'volta voltaAdLib) 'start-repeat)
+  c4 b d e
+  \set Score.repeatCommands = #'((volta #f) (volta "4.") end-repeat)
+  f1
+  \set Score.repeatCommands = #'((volta #f))
+}