Re: Add Changes entries for \temporary, \omit, \hide, \single, multiple tags (issue 8187044)

[dak]

Reviewers: janek, thomasmorley65,

Message:
I'll address the other points presently, or on Tuesday, depending on my
connectivity.


https://codereview.appspot.com/8187044/diff/1/Documentation/changes.tely
File Documentation/changes.tely (right):

https://codereview.appspot.com/8187044/diff/1/Documentation/changes.tely#newcode78
Documentation/changes.tely:78: respectively.  They can be given a music
expression to tweak, or
On 2013/03/30 19:25:04, thomasmorley65 wrote:
>  From description and example a user might expect that the following
snippets are
> working:

> \relative c'' { <a e' \hide Accidental ais>1 }
> \relative c'' { <a e' \omit ais>1 }
> \relative c'' { <a e' \omit Accidental ais>1 }

> Perhaps inserting a link to LM or NR or wherever they are explained,
would be
> sufficient.

I think changes entries should be self-explanatory.

Description:
Add Changes entries for \temporary, \omit, \hide, \single, multiple tags

Please review this at https://codereview.appspot.com/8187044/

Affected files:
  M Documentation/changes.tely


Index: Documentation/changes.tely
diff --git a/Documentation/changes.tely b/Documentation/changes.tely
index  
2b1a060f41c1ca95794c62ef58bccd5212ae8825..95f73723c91d1a1fff6fbeeac22a45245a03c8e8  
100644
--- a/Documentation/changes.tely
+++ b/Documentation/changes.tely
@@ -62,6 +62,56 @@ which scares away people.
 @end ignore

 @item
+A new command @code{\single} can be used for converting a property
+override into a tweak to be applied on a single music expression:
+
address@hidden,verbatim,relative=2]
+<a \single\voiceTwoStyle e' a>1
address@hidden lilypond
+
address@hidden
+Two ways of letting graphical objects not appear in the PDF are
+overriding its @code{transparent} property with @code{#t}
+(retaining the original spacing) or overriding its @code{stencil}
+property with @code{#f} (not using any space at all).  Those two
+operations now have the shorthands @code{\hide} and @code{\omit},
+respectively.  They can be given a music expression to tweak, or
+the name of a graphical object for which an override should be
+created:
+
address@hidden,verbatim]
+\new Staff \with { \omit Clef }
+\relative c'' <a e' \hide a>1
address@hidden lilypond
+
address@hidden
+A new command @code{\temporary} can be applied to overrides in
+order to not have them replace previous property settings.  If a
address@hidden is applied to the same property subsequently, the
+previous setting reappears:
+
address@hidden,verbatim,relative=2]
+\override NoteHead.color #red c4
+\override NoteHead.color #green d
+\revert NoteHead.color e2
+\override NoteHead.color #red c4
+\temporary\override NoteHead.color #green d
+\revert NoteHead.color e
+\revert NoteHead.color c
address@hidden lilypond
+
+This is mainly useful for writing music functions that need to
+have some property changed just for the duration of the function.
+
address@hidden
address@hidden, @code{\removeWithTag}, and @code{\keepWithTag} can
+now accept a list of symbols rather than just a single symbol for
+marking, removing, and keeping music with any of multiple tags.
+This is particularly important for @code{\keepWithTag} since one
+cannot achieve the same effect by using multiple consecutive
address@hidden commands.
+
address@hidden
 The @samp{-d old-relative} option has been removed.  Not actually
 accessible from the command line any more, its remaining use was
 for interpretating @code{\relative} in LilyPond files converted