Forum OpenACS Q&A: ad_proc documentation

Collapse
Posted by Brian Fenton on
Hi all,
I'm starting my first foray into OpenACS 4 development, having
previously programmed with ACS 3. My question is: where can I find
the documentation for ad_proc? I've looked at the source in the api-
doc (minimal description )and I know from looking at other programs
that I can use flags such a required, but I'd love to see a complete
description of its full interface. Can anyone point me to one?

many thanks and best wishes

Collapse
Posted by Brian Fenton on
Nobody knows? Maybe it's so obvious that my question sounds ridiculous. If so, I'd really appreciate it if someone could tell me. If nobody really does know, I'll post what I find back here.
Collapse
Posted by Janine Ohmer on
The only documentation I know of for ad_proc is at http://yoursite/api-doc/proc-view?proc=ad%5fproc

In general, /api-doc is your friend.  Not everything is documented well, but what is documented can usually be found there.

Collapse
Posted by Brian Fenton on
Thanks Janine. I've already looked at that. I was just wondering was there a description anywhere before I dived into the code.
Collapse
Posted by Lars Pind on
I don't think there is one, actually.

The closest thing I know of is this:

https://openacs.org/doc/openacs-4/tcl-doc.html

If somebody would volunteer to write that up ... :)

/Lars

Collapse
Posted by Michael A. Cleverly on
There are hidden secrets within ad_proc that afaik have never been documented anywhere other than the source code (viewable via /api-doc/). Like,
ad_proc foobar {-foo:boolean} { ... }
can be invoked as: foobar -foo=$some_boolean_value

I have custom ACS 4.2 code that's littered in places with:

    if {$flush_p} {
        some_proc -flush $key
    } else {
        some_proc $key
    }
Much cleaner to know you can say: some_proc -flush=$flush_p $key