Re: Issue 2922: \keepWithTag - update the existing docs in the manual to reflect new changes (issue 7494049)

[dak]

Reviewers: Trevor Daniels,

Message:
On 2013/03/24 21:36:42, Trevor Daniels wrote:
> I can still learn something new about LilyPond!
> Thanks David - LGTM
> (with a further suggestion)


https://codereview.appspot.com/7494049/diff/1/Documentation/notation/input.itely
> File Documentation/notation/input.itely (right):


https://codereview.appspot.com/7494049/diff/1/Documentation/notation/input.itely#newcode2195
> Documentation/notation/input.itely:2195: \removeWithTag #'C
> \removeWithTag #'(B C) maybe?

Doesn't match the text before the example.  I'll try to see what I can
do here.

Description:
Issue 2922: \keepWithTag - update the existing docs in the manual to
reflect new changes

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

Affected files:
  M Documentation/notation/input.itely


Index: Documentation/notation/input.itely
diff --git a/Documentation/notation/input.itely  
b/Documentation/notation/input.itely
index  
9a91cd2c82fdf595f406dffc591f2f935779301c..276f8afefb56068cb1984822c2499b30a38db0bf  
100644
--- a/Documentation/notation/input.itely
+++ b/Documentation/notation/input.itely
@@ -2085,13 +2085,16 @@ to tagged music is as follows:
 @headitem Filter
   @tab Result
 @item
-Tagged music preceded by @code{\keepWithTag #'@var{name}}
-  @tab Untagged music and music tagged with @var{name} is included;
-       music tagged with any other tag name is excluded.
+Tagged music preceded by @code{\keepWithTag #'@var{name}} or
+       @code{\keepWithTag #'(@var{name1} @address@hidden)}
address@hidden Untagged music and music tagged with any of the given tag
+     names is included;
+     music tagged with any other tag name is excluded.
 @item
-Tagged music preceded by @code{\removeWithTag #'@var{name}}
address@hidden Untagged music and music tagged with any tag name other than
-     @var{name} is included; music tagged with @var{name} is
+Tagged music preceded by @code{\removeWithTag #'@var{name}} or
+       @code{\removeWithTag #'(@var{name1} @address@hidden)}
address@hidden Untagged music and music not tagged with any of the given tag 
names
+     is included; music tagged with any of the given tag names is
      excluded.
 @item
 Tagged music not preceded by either @code{\keepWithTag} or
@@ -2162,12 +2165,13 @@ c1-\tag #'warn ^"Watch!"
 @end example

 Multiple tags may be placed on expressions with multiple
address@hidden entries:
address@hidden entries, or by combining multiple tags into one symbol
+list:

 @lilypond[quote,verbatim]
 music = \relative c'' {
   \tag #'a \tag #'both { a4 a a a }
-  \tag #'b \tag #'both { b4 b b b }
+  \tag #'(b both) { b4 b b b }
 }
 <<
 \keepWithTag #'a \music
@@ -2197,6 +2201,9 @@ Two or more @code{\keepWithTag} filters applied to a  
single music
 expression will cause @emph{all} tagged sections to be removed, as
 the first filter will remove all tagged sections except the one
 named, and the second filter will remove even that tagged section.
+Usually you would rather want to use a single @code{\keepWithTag}
+command with a list of multiple tags: this will only remove tagged
+sections not given in @emph{any} of the tags.

 Sometimes you want to splice some music at a particular place in an
 existing music expression.  You can use @code{\pushToTag} and