From: Trevor Daniels <t.daniels@treda.co.uk>
Date: Tue, 23 Sep 2008 15:41:44 +0000 (+0100)
Subject: Docs: add note re ordering engravers
X-Git-Tag: release/2.11.60-1~11
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=9e80d3e210d80af337e76f316bea3d00590e0baa;p=lilypond.git

Docs: add note re ordering engravers
---

diff --git a/Documentation/user/changing-defaults.itely b/Documentation/user/changing-defaults.itely
index 7f22418ebd..4151c98337 100644
--- a/Documentation/user/changing-defaults.itely
+++ b/Documentation/user/changing-defaults.itely
@@ -533,6 +533,21 @@ time signature.
 >>
 @end lilypond
 
+@knownissues
+
+Usually the order in which the engravers are specified
+does not matter, but in a few special cases the order
+is important, for example where one engraver writes
+a property and another reads it, or where one engraver
+creates a grob and another must process it.  The order in
+which the engravers are specified is the order in which
+they are called to carry out their processing.
+
+The following orderings are important: the
+@code{Bar_engraver} must normally be first, and
+the @code{New_fingering_engraver} must come before
+the @code{Script_column_engraver}.  There may be others
+with ordering dependencies.
 
 @node Changing context default settings
 @subsection Changing context default settings