I'm probably going to work on some additional documentation for ad_form this week while here at University of Galileo.
One problem we face is that three different people have munged with ad_form (at least). There's the original, relatively simple ad_form that was sketchily but still somewhat comprehensively documented in the Tcl header, and since then a bunch of stuff's been added that wasn't even documented there, much less at the user level ...
Anyway you're summary is useful. I have to admit that despite being the original author of ad_form, I don't know when I should use "-display", for instance (a feature added by someone else) rather than a confirm template.
