Re: commenting sub procedures

Dave

WDSC/RDP already has a tool like this - it is the New procedure wizard - right-click anywhere in the source and click on the New item in the list.

It does not create prototypes for procedures that already exist. But there is a change at 7.1 that lets you write code without prototypes sometimes - here are the conditions -

Optional prototypes

If a program or procedure is not called by another RPG module, it is optional to specify the prototype. The prototype may be omitted for the following types of programs and procedures:

* A program that is only intended to be used as an exit program or
as the command-processing program for a command
* A program that is only intended to be called from a different
programming language
* A procedure that is not exported from the module
* A procedure that is exported from the module but only intended
to be called from a different programming language

So then you have just one place to put comments.

HTH
Vern

On 3/25/2012 3:59 AM, Dave wrote:

That gives me an idea, it should be easy to make a tool that generates
the prototypes from the procedure interfaces. That way you can ensure
that the comments appear in both areas and you need never code a
prototype again!

Le 25 mars 2012 06:07, Charles Wilt<charles.wilt@xxxxxxxxx> a écrit :

Copy& Paste in WDSC is pretty easy :)

As I see it, the comments you include in the prototype, and duplicate
in the procedure should be pretty static, just like the interface to
the procedure itself. I suppose if the prototypes are in the same
member the duplication probably isn't needed...

But I always put prototypes in a separate member.

Charles

On Fri, Mar 23, 2012 at 10:09 AM, Dave<dfx1@xxxxxxxxxxxxxx> wrote:

I don't like duplicating comments just as much as I don't like
duplicating code. Worse, we don't have separate members for
prototypes, they are in the same member as the code.

--
This is the RPG programming on the IBM i / System i (RPG400-L) mailing list
To post a message email: RPG400-L@xxxxxxxxxxxx
To subscribe, unsubscribe, or change list options,
visit: http://lists.midrange.com/mailman/listinfo/rpg400-l
or email: RPG400-L-request@xxxxxxxxxxxx
Before posting, please take a moment to review the archives
at http://archive.midrange.com/rpg400-l.