Re: [boost] Suggested coding guidelines

From: Ross Smith (ross.s_at_[hidden])
Date: 2001-07-01 22:52:54

Greg Chicares wrote:
> 
> Rainer Deyke wrote:
> >
> > > ----- Original Message -----
> > > From: "Greg Chicares" <chicares_at_[hidden]>
> > >
> > > > and recommends /*...*/ instead for *text* comments; I just
> > > > don't want to see that usage deprecated.
> >
> > // Is there anything wrong with this style of
> > // multi-line comments?
> > // I consider it more readable than '/**/' and '#if 0'.
> > // It nests, and it can contain arbitrary characters.
> 
> Nothing at all wrong with that style. OTOH:
> 
> /*
> That doesn't mean this style is bad.
> 
> If I want to reformat this block to a different width, it's easier
> without the // markers.

Just to add another voice to the discussion: To me, that one is the
killer argument in favour of using /*...*/ for multi-line comments.
Whenever code is revised, you're likely to have a paragraph somewhere
that needs reformatting (unless you don't mind irregular lines).

(If the answer is "require programmers to use an editor smart enough to
reformat // comments", I don't think that's a reasonable thing to insist
on.)

-- 
Ross Smith <ross.s_at_[hidden]> The Internet Group, Auckland, New Zealand
========================================================================
"Unix has always lurked provocatively in the background of the operating
system wars, like the Russian Army."                  -- Neal Stephenson