Re: [boost] Towards a Warning free code policy proposal

Subject: Re: [boost] Towards a Warning free code policy proposal
From: Stewart, Robert (Robert.Stewart_at_[hidden])
Date: 2010-09-03 07:26:22

Daniel James wrote:
> On 2 September 2010 11:20, Daniel James <dnljms_at_[hidden]> wrote:
>
> > Personally, I wouldn't use a table for the data, it crams
> > too much into a small space. I'd just use a separate page
> > for each compiler.
>
> Here's an example of what I mean.
>
> https://svn.boost.org/trac/boost/wiki/Guidelines/Warnings/Microsoft

Very nice.

> Note that the warnings are listed on the right for quick access (this
> is automatically done from the headers).

That's a helpful result of using headers as you'd suggested.

> I'm not sure if a definition list is the best way to lay out
> the details.

That has the benefit of providing simple, uniform layout which enhances readability.  However, just using two boldfaced introductory words to introduce each of two paragraphs -- no indentation, IOW -- might do just as well.

_____
Rob Stewart                           robert.stewart_at_[hidden]
Software Engineer, Core Software      using std::disclaimer;
Susquehanna International Group, LLP  http://www.sig.com

IMPORTANT: The information contained in this email and/or its attachments is confidential. If you are not the intended recipient, please notify the sender immediately by reply and immediately delete this message and all its attachments. Any review, use, reproduction, disclosure or dissemination of this message or any attachment by an unintended recipient is strictly prohibited. Neither this message nor any attachment is intended as or should be construed as an offer, solicitation or recommendation to buy or sell any security or other financial instrument. Neither the sender, his or her employer nor any of their respective affiliates makes any warranties as to the completeness or accuracy of any of the information contained herein or that this message or any of its attachments is free of viruses.