That's great. Last night I suggested on #openacs that we could change api-doc to cross-reference function calls. We could search for the functions executed within [] and make links to api-doc.
I have a procedure that does cross-linking and colorization in api-doc. I haven't submitted it as a patch because of some known bugs, but I already find it invaluable during development. See http://empoweringminds.mle.ie/openacs/openacs_changes.html for the code.