Add RemoveAllEmptyStaves command

Issue 4744

It has been noted several
times that we should have
a companion for RemoveEmptyStaves
and to also set remove-first to ##t.

A doc snippet, removing-the-first-empty-line.ly,
has become obsolete with these changes.

Contains commits:
Add missing word in changes.tely

Add changes entry for RemoveEmptyStavesAll

Use RemoveEmptyStavesAll for ossia example in
Notation Reference

This rewrites documentation for
RemoveEmptyStaves and adds
information on the newly added
RemoveEmptyStavesAll.

Add RemoveEmptyStavesAll command
Introduce a new context modification
identifier, RemoveEmptyStavesAll,
to complement RemoveEmptyStaves.

It sets both the remove-empty
and remove-first properties
of VerticalAxisGroup to ##t.

1 files changed, 8 insertions, 0 deletions

diff --git a/ly/context-mods-init.ly b/ly/context-mods-init.ly
index 24b8ce0558..a4064f4b32 100644
--- a/ly/context-mods-init.ly
+++ b/ly/context-mods-init.ly
@@ -24,6 +24,14 @@ RemoveEmptyStaves = \with {
 to the list of interfaces set by @code{keepAliveInterfaces}."
 }
 
+RemoveAllEmptyStaves = \with {
+  \override VerticalAxisGroup.remove-empty = ##t
+  \override VerticalAxisGroup.remove-first = ##t
+  \description "Remove staves which are considered to be empty according
+to the list of interfaces set by @code{keepAliveInterfaces}, including those
+in the first system."
+}
+
 inherit-acceptability =
 #(define-void-function (to from)
    (symbol? symbol?)