Forum OpenACS Development: FYI: @return, not @returns


	The Toolkit for Online Communities 15899 Community Members, 0 members online, 2347 visitors today			Log In	Register

Forum OpenACS Development: FYI: @return, not @returns

OpenACS Home : Forums : OpenACS Development : FYI: @return, not @returns

Back to OpenACS Development

Icon of Envelope Request notifications

1: FYI: @return, not @returns

Posted by Lars Pind on 01/12/04 02:48 PM

FYI:

I just fixed a number of packages, which had proc-doc with @returns instead of @return.

Since things put in with @return doesn't show up in the API-doc browser, I changed it to @return.

We might consider looking for @returns or throwing an error on it, but for now, I figured it was best to change them to @return.

/Lars

2: Re: FYI: @return, not @returns (response to 1)

Posted by Joel Aufrecht on 01/12/04 05:00 PM

I made this an automated test for all tcl files by adding this line:

        aa_true "$file does not contain '@returns'.  @returns is probably a typo of @return" [expr [string first @returns $data] == -1]

to the test case acs_tcl__tcl_file_common_errors in the file /packages/acs-tcl/tcl/test/acs-tcl-test-procs.tcl. If people can think of other favorite typos or style rules etc, this would probably be a good place to check for them, just by adding new aa_true lines to the proc.

Back to OpenACS Development