[util.smartptr] Cleanse of italics infestation. #1161
Conversation
|
Do you not even want to retain the italics in the definition of the term? I kind of feel that it would be a bit more readable to have that meta-syntactic distinction. |
|
That's what I understood Richard's position to be. In any case, we talk about "empty" in [container.requirements.general] all over the place, but we never italicize the term. Also, we're not defining "empty", we're (at best) defining "empty shared_ptr" as the term of art here. And you don't want to look at italics \tcode text, ever. |
|
Well, that may be so, but all the same I am now left to wonder:
Is this a normative requirement on |
|
On 2 Dec 2016 7:59 am, "Thomas Köppe" <notifications@github.com> wrote:
Well, that may be so, but all the same I am now left to wonder:
A shared_ptr object is empty if it does not own a pointer.
Changing that to:
A `shared_ptr` is said to be empty if it does not own a pointer.
would help.
Is this a normative requirement on shared_ptr's behaviour when it doesn't
own a pointer? Oh, no, it's *defining* the meaning of "empty". Hm. I mean,
I don't dispute that we use this style, I'm just saying that it's an
ambiguity that requires additional attention.
—
You are receiving this because you are subscribed to this thread.
Reply to this email directly, view it on GitHub
<#1161 (comment)>, or mute
the thread
<https://github.com/notifications/unsubscribe-auth/AAONT985corDjtUuSWxoztpSEqlKZO7eks5rEEBVgaJpZM4LB9KF>
.
|
|
I like that! |
Technical terms should not be in italics everywhere they are referenced. Common terms such as 'owns' or 'empty' that are used as technical terms in this subsection only are not italicized or entered into the index. Fixes cplusplus#533.
|
Updated as desired. |
|
This makes me sad. I rather like italics for terms being defined. I don't mind the "is said to be" phrasing, but for me it's not a substitute. Unless you want to have a separate "Definitions" subclause, of course. (I don't, but could live with it.) |
Technical terms should not be in italics everywhere they are referenced.
Common terms such as 'owns' or 'empty' that are used as technical terms
in this subsection only are not italicized or entered into the index.
Fixes #533.