As part of the effort to fix documentation, I have updated acs-tcl/tcl/defs-procs.tcl:
* Got rid of all the proc_doc's
* Moved comments that were outside or in function comments to within
ad_proc documentation block.
* Added documentation where it was missing and I could figure out what
the function was supposed to do.
* Added explanation as to why the function was deprecated where I knew
the reasons.
I just saw Yon's message about the reasons for ad_parameter being deprecated, so I'll commit that now. I tested and everything is go.
