Forum OpenACS Q&A: FYI: Making links to api-doc
So Peter helped me write this little Perl script, which does that. It's idempotent, meaning you can run it multiple times, and it won't mess up.
perl -pi -e 's#([^=])(workflow::[a-z_:]+)(?=[^a-z_:])(?!</a>)#\1<a href="/api-doc/proc-view?proc=\2">\2</a>\3#g' developer-guide.html
You'll need to modify it for your own needs. I'm searching for 'workflow::' here, only care about lowercase, and I deliberately only process the developer-guide file, which is in HTML.
It would be good if our docbook XSL contained a tag for API procs, which would do this.
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.
thanks for posting about this as I hadn't seen it before! I think what you're doing is superb! If you submit the patch I volunteer to apply it tomorrow...
Since your code looks very readable and well designed I'm sure we can collectively weed out the remaining bugs in the proc.
report -code error; should that be
return -code error?