]> git.donarmstrong.com Git - lilypond.git/commitdiff
Doc: Order of engravers within context matters (673)
authorTrevor Daniels <t.daniels@treda.co.uk>
Fri, 27 Jul 2012 07:59:22 +0000 (08:59 +0100)
committerTrevor Daniels <t.daniels@treda.co.uk>
Wed, 1 Aug 2012 08:09:10 +0000 (09:09 +0100)
  Mention all known cases where the order matters.
  Information taken from comments in ly/engraver-init.ly.

Documentation/notation/changing-defaults.itely

index 38b5edda3105471f57fd068f5f0d54dacba23046..edf8a3f262cd312cecf1279a9ca03df4d2df5292 100644 (file)
@@ -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