Re: [Pldoc-chat] @ command and interaction with sqlplus

[Albert T. <alt...@ho...>]

Hi,

First thing I'd recommend is to precede @param with asterisk:

/** Blergh
 * @param
 */

This is also the standard form for javadoc in Java.

Also, it's better to run scripts in SQL*Plus not by "Open file", but 
this way:

@myscript.sql

This is better because empty lines in the code will not get lost.
And @param will not be treated as command (though I am not quite sure).

Albert


Mark Weaver wrote:

>I'd like to add a bunch of documentation to our packages, but currently the schema build scripts use sqlplus + @ to start external scripts.  For no good reason, sqlplus has decided that
>
>/** Blergh
>  @param
> */
>
>ought to invoke the "param" script.  My current workaround is a bunch of empty scripts for each tag.  Is there a less bletcherous way of doing this?  I've dug around for disabling start, but this really is a bit of a pain as it means each script needs to be invoked separately.
>
>btw, This is a fantastic tool :)
>
>
>-------------------------------------------------------
>This SF.NET email is sponsored by:
>SourceForge Enterprise Edition + IBM + LinuxWorld =omething 2 See!
>http://www.vasoftware.com
>_______________________________________________
>PLDoc-chat mailing list
>PLD...@li...
>https://lists.sourceforge.net/lists/listinfo/pldoc-chat
>
>  
>