Rob Stewart wrote:
From: Rene Rivera <grafik.list@redshift-software.com>
Rob Stewart wrote:
From: David Abrahams <dave@boost-consulting.com>
should be:
It is strongly recommended that you simply <a href="...">download a prebuilt bjam executable</a> if we have supplied one for your platform. Otherwise, you'll need to build bjam from source. You may also need to rebuild bjam if you are using an unreleased state of the Boost sources from CVS, since the prebuilt executable may not support all the features currently being used by Boost.
Consider avoiding the passive "it is strongly recommended." I suggest this:
You should <a href="...">download a prebuilt bjam executable</a> if we have supplied one for your platform....
Or similarly to something that changes the meaning less:
We strongly recommend that you simply <a href="...">download a [etc.]
I don't see that mine changed the meaning. Sure, I omitted "strongly recommend," but this is a Getting Started guide, so anything not equivocated should be taken as explicit direction. Only the reader with enough familiarity to not require the Getting Started guide will know enough to choose another course.
Sure :-) I was just pointing out the different, although subtle, change in tone of the statement.
Also, I suspect -- I haven't confirmed this -- that "we" isn't used elsewhere. Thus, I think your version would need to be "Boost strongly recommends...."
That's funny ;-) Given that the same sentence we are talking about has "... if _we_ have supplied ...". -- -- Grafik - Don't Assume Anything -- Redshift Software, Inc. - http://redshift-software.com -- rrivera/acm.org - grafik/redshift-software.com -- 102708583/icq - grafikrobot/aim - Grafik/jabber.org