Imported Upstream version 2.18.0

[lilypond.git] / Documentation / snippets / new / entering-several-tuplets-using-only-one--times-command.ly

diff --git a/Documentation/snippets/new/entering-several-tuplets-using-only-one--times-command.ly b/Documentation/snippets/new/entering-several-tuplets-using-only-one--times-command.ly
new file mode 100644 (file)
index 0000000..0b6af1b
--- /dev/null
+++ b/Documentation/snippets/new/entering-several-tuplets-using-only-one--times-command.ly
@@ -0,0 +1,28 @@
+\version "2.17.11"
+
+\header {
+  lsrtags = "rhythms, syntax-and-expressions"
+
+  texidoc = "
+The property @code{tupletSpannerDuration} sets how long each of the
+tuplets contained within the brackets after @code{\\tuplet} should last.
+Many consecutive tuplets can then be placed within a single
+@code{\\tuplet} expression, thus saving typing.
+
+There are several ways to set @code{tupletSpannerDuration}.  The command
+@code{\\tupletSpan} sets it to a given duration, and clears it when
+instead of a duration @code{\\default} is specified.  Another way is
+to use an optional argument with @code{\\tuplet}.
+"
+  doctitle = "Entering several tuplets using only one \\tuplet command"
+}
+
+
+\relative c' {
+  \time 2/4
+  \tupletSpan 4
+  \tuplet 3/2 { c8^"\\tupletSpan 4" c c c c c }
+  \tupletSpan \default
+  \tuplet 3/2 { c8^"\\tupletSpan \\default" c c c c c }
+  \tuplet 3/2 4 { c8^"\\tuplet 3/2 4 {...}" c c c c c }
+}