Commenting Style
#1
Posted 26 November 2006 - 09:23 AM
#2
Posted 26 November 2006 - 01:05 PM
............... what you think is better
I prefer SemiColum commenting sytle because many programs are related with INF files and same comments in them.
#3
Posted 27 November 2006 - 08:39 AM
I also use rem, which is evidenced in WB, when I want to add comments.
Now every character is accepted. Everyone can use other people's scripts without problems.
Why not continue like that?
I don't see consistency issues with this.
edborg
#4
Posted 27 November 2006 - 12:13 PM
jaclaz
#5
Posted 27 November 2006 - 12:23 PM
#6
Posted 27 November 2006 - 12:50 PM
#7
Posted 27 November 2006 - 08:32 PM
GOOD!I have added rem and # in the list
But you should also "reset" the voting, and ask members to vote again, I already have a number of #'s that came to me protesting they have been discriminated....
jaclaz
#8
Posted 27 November 2006 - 08:40 PM
GOOD!
But you should also "reset" the voting, and ask members to vote again, I already have a number of #'s that came to me protesting they have been discriminated....
jaclaz
Should I reset it now?
#9
Posted 28 November 2006 - 11:54 PM
I would prefer to have some flexibility with commentsShould I reset it now?
For ex. Delphi allows:
// - starts comment (auto terminated at end of line)
(*...*) - anywhere in the text
{...} - anywhere in the text
I voted for #, as it allowes beautifications like that:
###################### # Text # ######################
#10
Posted 13 December 2006 - 09:00 AM
#11
Posted 14 December 2006 - 01:52 AM
where you can do this...;
;###################### ;# Text # ;######################
#12
Posted 15 April 2007 - 03:48 PM
// a single line comment
/* a block comment*/
The block comment can be arranged like this for added effect:
/***********************************\
| COMMENTS... |
| This is a VALID C/C++ |
| comment |
\***********************************/
(the | in the comment box should be alligned with the top and bottom right corners)
#13
Posted 15 April 2007 - 07:55 PM
#14
Posted 04 June 2007 - 04:04 PM
1. to indicate comment line
2. to indicate the rest of the line is a comment
3. to insert comment anywhere in the program text
"//" and ";" are OK for 1 and 2
# is OK only for 1
For consistensy reasons I would prefer Ove's proposal:
"//" (for 1,2) and "/*...*/" (for 3)
In addition, ";" better be reserved for future extensions of WB scripting language.
Alexei
#15
Posted 10 August 2007 - 09:53 PM
#16
Posted 11 September 2007 - 05:52 AM
"//*" would also create a conflict, because "//" means: "the rest of the line is a comment regardless of its contents".How about "//* ... *//" for number 3? That would keep some kind of consistency between commenting, namely, the use of "//".
It's also important, that "//* ... *//" is two characters longer then "/* ... */". Save you fingers!
Alexei
2 user(s) are reading this topic
0 members, 2 guests, 0 anonymous users