Re: Doc: NR 1.2.1 Ties - added @knownissue (issue 5453066)

[pkx166h]

Reviewers: Keith,

Message:
On 2011/12/07 02:21:13, Keith wrote:
> Looks good.
> For consistency with NR5.4.6 Painting objects white, you should
subtract 4 from
> each of the layer numbers, and remove the override of StaffSymbol
layer.

> Some people have probably used white-out on text or dynamics (in their
default
> layer=1) to place it over the StaffSymbol, so they depend on
StaffSymbol
> remaining in layer 0.

> (I was wondering about this when I commented on the tracker issue, but
couldn't
> find the reference in the manual at the time.)

> Consider moving your example from 'known issues' to the main text,
maybe around
> line 543.

All done. Thanks.

Description:
Doc: NR 1.2.1 Ties - added @knownissue

This is for issue 409.

Give simple example for using whiteout to avoid ties colliding with
staff objects

Please review this at http://codereview.appspot.com/5453066/

Affected files:
  M Documentation/notation/rhythms.itely


Index: Documentation/notation/rhythms.itely
diff --git a/Documentation/notation/rhythms.itely  
b/Documentation/notation/rhythms.itely
index  
5e51e76c92c0061d9062cf3ea9f0278624ed32de..c2d81230c6f5ddc06d14bf02eb11b6053e28ccc5  
100644
--- a/Documentation/notation/rhythms.itely
+++ b/Documentation/notation/rhythms.itely
@@ -523,10 +523,9 @@ c2 ~ c
 c2 ~ c
 @end lilypond

-Dash pattern definitions for ties have the same structure as
-dash pattern definitions for slurs.
-For more information about complex dash patterns,
-see the snippets under @ref{Slurs}.
+Dash pattern definitions for ties have the same structure as dash
+pattern definitions for slurs. For more information about complex dash
+patterns, see the snippets under @ref{Slurs}.

 @predefined
 @code{\tieUp},
@@ -540,6 +539,22 @@ see the snippets under @ref{Slurs}.
 @code{\tieSolid}.
 @endpredefined

+Override @var{whiteout} and @var{layer} layout properties for ties that
+collide with other objects in a staff.
+
address@hidden,quote,ragged-right,relative=2]
+{
+  \override Tie #'layer = #-2
+  \override Staff.TimeSignature #'layer = #-1
+  \override Staff.KeySignature #'layer = #-1
+  \override Staff.TimeSignature #'whiteout = ##t
+  \override Staff.KeySignature #'whiteout = ##t
+  b2 b~
+  \time 3/4
+  \key a \major
+  b r4
+}
address@hidden lilypond

 @snippets

@@ -568,14 +583,11 @@ Internals Reference:
 @rinternals{TieColumn},
 @rinternals{Tie}.

-
 @knownissues
-Switching staves when a tie is active will not produce a slanted
-tie.
-
-Changing clefs or ottavations during a tie is not really
-well-defined.  In these cases, a slur may be preferable.
+Switching staves when a tie is active will not produce a slanted tie.

+Changing clefs or ottavations during a tie is not really well-defined.
+In these cases, a slur may be preferable.


 @node Writing rests