[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Issue 2922: \keepWithTag - update the existing docs in the manual to
From: |
dak |
Subject: |
Re: Issue 2922: \keepWithTag - update the existing docs in the manual to reflect new changes (issue 7494049) |
Date: |
Mon, 25 Mar 2013 20:47:48 +0000 |
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
- Re: Issue 2922: \keepWithTag - update the existing docs in the manual to reflect new changes (issue 7494049),
dak <=