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 ca0445dba8eb34eb9cb6ab6880b9670e74c087f0..873aeec8efb1384e4b31887d5fe119154945b801 100644 (file)
--- 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