Re: Standard Euphoria Library project

new topic     » goto parent     » topic index » view thread      » older message » newer message

cklester wrote:
> 
> Derek Parnell wrote:
> > 
> > Hmmm... not so sure about that. I've been using this style of documention in
> > Win32lib
> > for years now and I've not had problems.
> 
> That's because you're weird!!! :D
> 
> I'm much more for this:
> 
> /-- new start of lines of comments marker
> Okay, now I can do whatever I want here... I don't have to worry about those
> stupid dashes at the beginning of each line. Later, if I need to make
> revisions,
> I don't have to worry about manual line breaks. This is only a concern because
> I've done it for in-house projects and I don't do it anymore. :/
> --/ -- new end-of-lines-of-comments marker, with current method on this line,
> too.
> 
> than this:
> 
> -- Okay, now I can do whatever I want here... I don't have to worry about
> those
> -- stupid dashes at the beginning of each line. Later, if I need to make
> revisions,
> -- I don't have to worry about manual line breaks. This is only a concern
> because
> -- I've done it for in-house projects and I don't do it anymore. :/
> 
> especially when it comes time to update the paragraph and insert a sentence
> or remove some words.
> 

I use the same style as Derek.  My editor allows me to comment and uncomment
multiple lines, so it's pretty easy to revise some comments.

Matt Lewis

new topic     » goto parent     » topic index » view thread      » older message » newer message

Search



Quick Links

User menu

Not signed in.

Misc Menu