I agree with Kevin, specifically for the reasons he mentions, but I actually prefer using the alpha-numeric format like S3000.GET.CUSTNAME: where the "S" designates it's an internal subroutine, "3000" is the numeric position value that Kevin talks about, and "GET.CUSTNAME" so every place that I call the subroutine from, I know what I'm looking to do in that subroutine. I also put the colon ":" so when I want to actually go to that subroutine in the editor, I can. The numeric portion is in relation to the whole program, not just the "S" portion. This keeps me from accidentally doing a A3000 instead of an S3000.
I do have to disagree with the statement of 10-line subroutines, though. Limit them to one function, okay, but limit the number of lines? Not even as a guideline in my list of standards. BobW > -----Original Message----- > From: [EMAIL PROTECTED] [mailto:owner-u2- > [EMAIL PROTECTED] On Behalf Of Kevin King > Sent: Tuesday, September 27, 2005 1:04 PM > To: [email protected] > Subject: RE: [U2] Good Programming Practice Question......... > > And here's where the conflict begins. When looking through a big > program, I much prefer numeric labels in order with comments vs. > alphanumeric labels. With numeric labels in order you find 1800 and > if you're looking for 2000 you know to look farther down, 1000, go up. > With alpha labels if you find SELECT.FILE and are looking for > UPDATE.FILES, you have nothing but experience to know whether to look > up or down from there. > > Numeric labels are good. Not ordering or commenting them is bad. And > not putting comments around all labels to make them more easily > distinguished from the rest of the program is near unforgiveable. > > -K > > -----Original Message----- > From: [EMAIL PROTECTED] > [mailto:[EMAIL PROTECTED] On Behalf Of Allen E. > Elwood > Sent: Tuesday, September 27, 2005 12:40 PM > To: [email protected] > Subject: RE: [U2] Good Programming Practice Question......... > > My addition to this would be to use alphanumeric labels, and to *have* > a main calling section. A main calling section that looks like: > > GOSUB OPEN.AND.INIT > GOSUB SELECT.FILE > GOSUB PRE-PROCESS.VALIDITY.CHECKS > GOSUB PRINT.INVOICES > GOSUB UPDATE.FILES > > Looks so much better and is so easier to figure out than > > GOSUB 100 > a bunch of statements > a bunch of statements > a bunch of statements > GOSUB 1250 > a bunch of statements > a bunch of statements > a bunch of statements > GOSUB 1375 > a bunch of statements > a bunch of statements > a bunch of statements > GOSUB 4000 > a bunch of statements > a bunch of statements > a bunch of statements > GOSUB 9755 > a bunch of statements > a bunch of statements > a bunch of statements > > IMNSHO - *=aee=* > > -----Original Message----- > From: [EMAIL PROTECTED] > [mailto:[EMAIL PROTECTED] Behalf Of George Gallen > Sent: Tuesday, September 27, 2005 12:12 > To: [email protected] > Subject: RE: [U2] Good Programming Practice Question......... > > > Also, how about a change log at the top of the program > that lists, who, when and what/why a change was made. > > add to that a short description as to what the function > of the program is for. > > * this program does ..... > * > * > * date who changes made > * date who changes made > ******************************************** > * > > George > > -----Original Message----- > From: [EMAIL PROTECTED] > [mailto:[EMAIL PROTECTED] Behalf Of Dianne > Ackerman > Sent: Tuesday, September 27, 2005 2:57 PM > To: [email protected] > Subject: Re: [U2] Good Programming Practice Question......... > > > I like these and would add another one - Add comments to > tricky-looking code! > -Dianne > > David A. Green wrote: > ------- > u2-users mailing list > [email protected] > To unsubscribe please visit http://listserver.u2ug.org/ > ------- > u2-users mailing list > [email protected] > To unsubscribe please visit http://listserver.u2ug.org/ > > -- > No virus found in this incoming message. > Checked by AVG Anti-Virus. > Version: 7.0.344 / Virus Database: 267.11.7/112 - Release Date: > 9/26/2005 > ------- > u2-users mailing list > [email protected] > To unsubscribe please visit http://listserver.u2ug.org/ ------- u2-users mailing list [email protected] To unsubscribe please visit http://listserver.u2ug.org/
