Doku BXE 2: onnew CallBack as popup: Unclear description

[Christian Schmidt-Guetter]

Helo,

on URL
http://wiki.bitfluxeditor.org/BXE_2.0/OnNewCallbacks#Popup_callbacks
below heading "A more complex popup example" one can read:

"We have to call bxe_Transform() by ourself here, since the main window
doesn't know, when we are finished. The 1st and 2nd parameter are explained
later (usually, false/false is ok here, it's for setting the cursor after
the transformation). The third parameter tells the transformer, which node
it should validate. If we leave that out, it validates the whole document,
if we give it a node, it just validates from that node on."

That's not clear for me:

1.) The example does use function "bxe_Transform_async()" (which does
work), not the pure "bxe_Transform()". So which function one should really
use?

2.) "bxe_Transform_async()" does not implement any parameters
- in opposition to "bxe_Transform()". Is this an implementation bug or a
documentation mistake?

3.) Where is the following place:
"The 1st and 2nd parameter are explained later" ...?
(Can anybody point me to that explanation?)


Thank in advance for your answer!

Christian