From: Trevor Daniels <t.daniels@treda.co.uk>
Date: Fri, 27 Jul 2012 07:59:22 +0000 (+0100)
Subject: Doc: Order of engravers within context matters (673)
X-Git-Tag: release/2.15.42-1~10
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=47abfd11dbf3902963836c42db1c38a7137af16e;p=lilypond.git

Doc: Order of engravers within context matters (673)

  Mention all known cases where the order matters.
  Information taken from comments in ly/engraver-init.ly.
---

diff --git a/Documentation/notation/changing-defaults.itely b/Documentation/notation/changing-defaults.itely
index 38b5edda31..edf8a3f262 100644
--- a/Documentation/notation/changing-defaults.itely
+++ b/Documentation/notation/changing-defaults.itely
@@ -672,19 +672,33 @@ time signature.
 
 @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.
+The order in which the engravers are specified is the order in
+which they are called to carry out their processing.  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 following orderings are important:
+
+@itemize
+@item
+the @code{Bar_engraver} must normally be first,
+
+@item
+the @code{New_fingering_engraver} must come before the
+@code{Script_column_engraver},
+
+@item
+the @code{Timing_translator} must come before the
+@code{Bar_number_engraver}.
+
+@end itemize
+
+@seealso
+Installed Files:
+@file{ly/engraver-init.ly}.
+
 
 @node Changing context default settings
 @subsection Changing context default settings