Re: [doc PATCH] update attribute docs for C++

2018-12-12 Thread Martin Sebor
On 12/11/18 9:41 PM, Sandra Loosemore wrote: On 12/5/18 10:14 AM, Martin Sebor wrote: On 12/4/18 8:49 PM, Sandra Loosemore wrote: What is the "it" referenced in the user's questions you quoted?  The const/pure attributes?  Those are function attributes.  The text you are adding is in the

Re: [doc PATCH] update attribute docs for C++

2018-12-11 Thread Sandra Loosemore
On 12/5/18 10:14 AM, Martin Sebor wrote: On 12/4/18 8:49 PM, Sandra Loosemore wrote: What is the "it" referenced in the user's questions you quoted?  The const/pure attributes?  Those are function attributes.  The text you are adding is in the type attribute section, so it seemed like it was

Re: [doc PATCH] update attribute docs for C++

2018-12-05 Thread Martin Sebor
On 12/4/18 8:49 PM, Sandra Loosemore wrote: On 12/4/18 8:13 PM, Martin Sebor wrote: On 12/4/18 2:04 PM, Sandra Loosemore wrote: On 12/4/18 9:26 AM, Martin Sebor wrote: [snip] +The keyword @code{__attribute__} allows you to specify various special +properties of types.  Some type attributes

Re: [doc PATCH] update attribute docs for C++

2018-12-04 Thread Sandra Loosemore
On 12/4/18 8:13 PM, Martin Sebor wrote: On 12/4/18 2:04 PM, Sandra Loosemore wrote: On 12/4/18 9:26 AM, Martin Sebor wrote: [snip] +The keyword @code{__attribute__} allows you to specify various special +properties of types.  Some type attributes apply only to structure and +union types, and

Re: [doc PATCH] update attribute docs for C++

2018-12-04 Thread Martin Sebor
On 12/4/18 2:04 PM, Sandra Loosemore wrote: On 12/4/18 9:26 AM, Martin Sebor wrote: Thanks for the comments.  Attached is an updated patch with the typos fixed.  I've left the rest as is. Well, I still think a number of points I commented on before need to be clarified in the text.  If I'm

Re: [doc PATCH] update attribute docs for C++

2018-12-04 Thread Sandra Loosemore
On 12/4/18 9:26 AM, Martin Sebor wrote: Thanks for the comments.  Attached is an updated patch with the typos fixed.  I've left the rest as is. Well, I still think a number of points I commented on before need to be clarified in the text. If I'm confused, I think other readers will be,

Re: [doc PATCH] update attribute docs for C++

2018-12-04 Thread Martin Sebor
On 12/4/18 12:09 AM, Sandra Loosemore wrote: On 12/3/18 4:23 PM, Martin Sebor wrote: gcc/ChangeLog: * doc/extend.texi (attribute const, pure): Clarify. Index: gcc/doc/extend.texi === --- gcc/doc/extend.texi    (revision

Re: [doc PATCH] update attribute docs for C++

2018-12-03 Thread Sandra Loosemore
On 12/3/18 4:23 PM, Martin Sebor wrote: gcc/ChangeLog: * doc/extend.texi (attribute const, pure): Clarify. Index: gcc/doc/extend.texi === --- gcc/doc/extend.texi (revision 266766) +++ gcc/doc/extend.texi (working copy) @@

[doc PATCH] update attribute docs for C++

2018-12-03 Thread Martin Sebor
In a recent discussion a user asked us to clarify the effects of attributes const and pure on member functoons of trivial structs vs. non-trivial classes, and functions with pointer vs. reference arguments. I think this is worth explaining in some general statement rather than for individual