Doc: NR Added @knownissue for clashing note column

[lilypond.git] / Documentation / notation / simultaneous.itely

diff --git a/Documentation/notation/simultaneous.itely b/Documentation/notation/simultaneous.itely
index 8f55aea92856e5e2fe12bf7b91f633620f4200e6..d827fad597b2621a2934ac44fb4c8b7693ab7bd8 100644 (file)
--- a/Documentation/notation/simultaneous.itely
+++ b/Documentation/notation/simultaneous.itely
@@ -209,6 +209,24 @@ generate multiple staves implicitly:
 
 Here different rhythms cause no problems.
 
+@knownissues
+If notes from two or more voices, with stems in the same direction, are
+placed at the same position on the staff and have no shift (or have the
+same shift specified), the message:
+
+@example
+warning: ignoring too many clashing note columns
+@end example
+
+will appear during compilation.  This message can be suppressed by:
+
+@example
+\override NoteColumn #'ignore-collision = ##t
+@end example
+
+However, this does not only suppress the warning but will prevent any
+collision resolution, so may have unintended results.
+
 
 @node Clusters
 @unnumberedsubsubsec Clusters