[boost] Re: [optional] Doc edits

2003-03-15 Thread Gennaro Prota
On Fri, 14 Mar 2003 12:10:52 -0600, "David B. Held"
<[EMAIL PROTECTED]> wrote:

>
>First, it is functionally similar to a tristate boolean (false,
>maybe,true) -such as boost::tribool-, except that in a tristate
>boolean, the maybe state represents a valid value, unlike the
>corresponding state of an uninitialized optional.
>
>I think two hyphens should be used for the em-dashes (or the
>actual em-dash character, which is probably not portable).  Also,
>the comma after the em-dash is probably not necessary (even
>though it would be if the parenthetical phrase were not present).


As far as English is concerned I'll leave the response to people who
have studied in an English-speaking country, however I would be
surprised if your rules *required* a comma before "except" in absence
of the parenthetical phrase.

Secondly, the comma just before "the maybe state" is definitely an
error in Italian but, again, I'll leave to you to say if the same
thing holds for English.

The above notes would be of course off-topic in themselves but I think
they aren't in this context, as they are meant as a rationale for
proposing a correction to existing boost documentation.


Genny.

___
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost


[boost] Re: [optional] Doc edits

2003-03-14 Thread Fernando Cacciola

"David B. Held" <[EMAIL PROTECTED]> escribió en el mensaje
news:[EMAIL PROTECTED]
> Under "A note about optional" is the line:
>
> Second, optional<> provides and implicit conversion to bool.
>
> Of course, it should be "an".
>
Fixed, thanks!

>An even subtler nitpick is that in the
> line:
>
> First, it is functionally similar to a tristate boolean (false,
> maybe,true) -such as boost::tribool-, except that in a tristate
> boolean, the maybe state represents a valid value, unlike the
> corresponding state of an uninitialized optional.
>
> I think two hyphens should be used for the em-dashes (or the
> actual em-dash character, which is probably not portable).  Also,
> the comma after the em-dash is probably not necessary (even
> though it would be if the parenthetical phrase were not present).
>
Fixed. Thanks again!!

BTW: It took me a little to understand what you've said because
I didn't know about the em-dash. But I found a nice explanation
on the web about em/en-dashes, the hyphen, and their correct uses.

I used — directly since I found many boost documents using
it.

> Otherwise, the documentation looks great!
>
Thank you!

Fernando Cacciola




___
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost