Imported Upstream version 2.18.0

[lilypond.git] / Documentation / snippets / displaying-a-whole-grandstaff-system-if-only-one-of-its-staves-is-alive.ly

diff --git a/Documentation/snippets/displaying-a-whole-grandstaff-system-if-only-one-of-its-staves-is-alive.ly b/Documentation/snippets/displaying-a-whole-grandstaff-system-if-only-one-of-its-staves-is-alive.ly
new file mode 100644 (file)
index 0000000..bb20ae2
--- /dev/null
+++ b/Documentation/snippets/displaying-a-whole-grandstaff-system-if-only-one-of-its-staves-is-alive.ly
@@ -0,0 +1,76 @@
+%% 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.17.15"
+
+\header {
+  lsrtags = "contexts-and-engravers"
+
+  texidoc = "
+In orchestral scores sometimes single or groups of instruments are
+silent for a while and their staves can be removed for that time (with
+@code{\\removeEmptyStaves}).
+
+
+When they play again it is often preferred to show the staves of all
+instruments of such a group. this can be done adding the
+@code{Keep_alive_together_engraver} in the grouper (e.g. a GrandStaff
+or a StaffGroup)
+
+
+In the example the violins are silent in the 2nd system and in the 3rd
+system. Only the first violin plays the last measure but the staff of
+the second violin is also displayed.
+
+"
+  doctitle = "Displaying a whole GrandStaff system if only one of its staves is alive"
+} % begin verbatim
+
+\score {
+  <<
+    \new StaffGroup = "StaffGroup_woodwinds"
+    <<
+      \new Staff = "Staff_flute" \with {
+        instrumentName = "Flute"
+        shortInstrumentName = "Fl"}
+        \relative c' { \repeat unfold 3 { c'4 c c c | c c c c | c c c c | \break }
+      }
+    >>
+    \new StaffGroup = "StaffGroup_Strings"
+    <<
+      \new GrandStaff = "GrandStaff_violins"
+      <<
+        \new Staff = "StaffViolinI" \with {
+          instrumentName = "Violin I"
+          shortInstrumentName = "Vi I"
+        }
+        \relative c'' {
+          a1 \repeat unfold 7 { s1 } \repeat unfold 12 a16  a4
+        }
+        \new Staff = "StaffViolinII" \with {
+          instrumentName = "Violin II"
+          shortInstrumentName = "Vi II"
+        }
+        \relative c' { e1 \repeat unfold 8 { s1 } }
+      >>
+      \new Staff = "Staff_cello" \with {
+        instrumentName = "Cello"
+        shortInstrumentName = "Ce"
+      }
+      \relative c { \clef bass \repeat unfold 9 { c1 }}
+    >>
+  >>
+}
+\layout {
+  \context {
+    \GrandStaff
+    \consists Keep_alive_together_engraver
+  }
+  \context {
+    \Staff
+    \RemoveEmptyStaves
+  }
+}