From: James Lowe <pkx166h@gmail.com>
Date: Wed, 24 Oct 2012 12:51:38 +0000 (+0100)
Subject: Doc: Pitches.itely @knownissue OctavateEight grob
X-Git-Tag: release/2.17.6-1~19
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=8ae109429fea0d637100038af3a690479f2f3cfe;p=lilypond.git

Doc: Pitches.itely @knownissue OctavateEight grob

Issue 2832

Shows that any integers attached to a Clef is treated as a separate Grob
so any override applied to the Clef also has to be applied
as a separate override to the OctavateEight grob.

Includes brief description and @lilypond example.
---

diff --git a/Documentation/notation/pitches.itely b/Documentation/notation/pitches.itely
index ca0445dba8..873aeec8ef 100644
--- a/Documentation/notation/pitches.itely
+++ b/Documentation/notation/pitches.itely
@@ -1179,6 +1179,21 @@ Internals Reference:
 @rinternals{OctavateEight},
 @rinternals{clef-interface}.
 
+@knownissues
+Ottavation numbers attached to clefs are treated as separate grobs.  So
+any @code{\override} done to the @var{Clef} will also need to be
+applied, as a separate @code{\override}, to the @var{OctavateEight}
+grob.
+
+@lilypond[fragment,quote,relative=1]
+\new Staff \with {
+  \override OctavateEight #'color = #red
+  \override Clef #'color = #blue
+}
+
+\clef "treble_8" c4
+@end lilypond
+
 
 @node Key signature
 @unnumberedsubsubsec Key signature