The documentation says that the second parameter to
preRenderingHandler
is a reference to a hash that maps the placeholders to the removed blocks. And later it states that
Placeholders are text strings constructed using the tag name and a
sequence number e.g. 'pre1', "verbatim6", "head1" etc. Placeholders are
inserted into the text inside <!--!marker!--> characters so the
text will contain <!--!pre1!--> for placeholder pre1.
A subsequent example uses verbatim, so clearly the user should assume that this parameter holds placeholders for verbatim, etc.
However, it turns out that such is not the case. The parameter only holds the map for pre.
The consequence of this is that it is *impossible to restore verbatim text that is manipulated in a plugin, once the
endRenderingHandler
(deprecated) is removed.
Further, the code is inconsistent with the documentation.
My suspicion is that some overzelous optimization was used to split the placeholders into separate maps, but forgot to pass all these maps into the
preRenderingHandler
.
--
TWiki:Main/ThomasWeigert - 09 Apr 2007
Yes, your analysis is right on the money. Confirmed.
CC