From 4327eead87247f7fd76c1331d7b841658af7ee55 Mon Sep 17 00:00:00 2001 From: Trevor Daniels Date: Sat, 10 Sep 2011 22:17:56 +0100 Subject: [PATCH] Doc: capture another nugget from Neil --- Documentation/contributor/programming-work.itexi | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/Documentation/contributor/programming-work.itexi b/Documentation/contributor/programming-work.itexi index 8fa3d6ed9c..5895dfe261 100644 --- a/Documentation/contributor/programming-work.itexi +++ b/Documentation/contributor/programming-work.itexi @@ -1718,6 +1718,16 @@ Engraver_name::acknowledge_interface_name (Grob_info info) @} @end example +Acknowledge functions are called in the order engravers are +@code{\consist}-ed (the only exception is if you set +@code{must-be-last} to @code{#t}). + +If useful things are to be done to the acknowledged grobs, this +should be deferred until all the acknowledging has finished, i.e., +store the acknowledged grobs and process the information in a +@code{process-acknowledged ()} or @code{stop-translation-timestep ()} +function. + @node Engraver declaration/documentation @subsection Engraver declaration/documentation -- 2.39.2