Imported Upstream version 2.14.2

[lilypond.git] / Documentation / snippets / stemlets.ly

diff --git a/Documentation/snippets/stemlets.ly b/Documentation/snippets/stemlets.ly
new file mode 100644 (file)
index 0000000..3f4f4c4
--- /dev/null
+++ b/Documentation/snippets/stemlets.ly
@@ -0,0 +1,47 @@
+%% 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 = "rhythms"
+
+  texidoc = "
+In some notational conventions beams are allowed to extend over rests.
+Depending on preference, these beams may drop 'stemlets' to help the
+eye appreciate the rhythm better, and in some modern music the rest
+itself is omitted and only the stemlet remains.
+
+
+This snippet shows a progression from traditional notation, to beams
+over the rest, to stemlets over the rest, to stemlets alone.  Stemlets
+are generated by overriding the @code{'stemlet-length} property of
+@code{Stem}, while rests are hidden by setting @code{'transparent =
+##t}.
+
+
+Some @code{\\markup} elements are included in the source to highlight
+the different notations.
+
+"
+  doctitle = "Stemlets"
+} % begin verbatim
+
+\paper { ragged-right = ##f }
+
+{
+  c'16^\markup { traditional } d' r f'
+  g'16[^\markup { beams over rests } f' r d']
+
+  % N.B. use Score.Stem to set for the whole score.
+  \override Staff.Stem #'stemlet-length = #0.75
+
+  c'16[^\markup { stemlets over rests } d' r f']
+  g'16[^\markup { stemlets and no rests } f'
+  \once \override Rest #'transparent = ##t
+  r16 d']
+}
+