RFC: Doc update for attribute

2014-05-12 Thread David Wohlferd
After updating gcc's docs about inline asm, I'm trying to improve some of the related sections. One that I feel has problems with clarity is __attribute__ naked. I have attached my proposed update. Comments/corrections are welcome. In a related question: To better understand how this attri

Re: RFC: Doc update for attribute

2014-05-16 Thread Carlos O'Donell
On 05/12/2014 11:13 PM, David Wohlferd wrote: > After updating gcc's docs about inline asm, I'm trying to improve > some of the related sections. One that I feel has problems with > clarity is __attribute__ naked. > > I have attached my proposed update. Comments/corrections are > welcome. > > In

Re: RFC: Doc update for attribute

2014-05-16 Thread David Wohlferd
Thank you for your response. This is exactly what I wanted to know. One last question: +While it +is discouraged, it is possible to write your own prologue/epilogue code +using asm and use ``C'' code in the middle. I wouldn't remove the last sentence since IMO it's not the intent of the featu

Re: RFC: Doc update for attribute

2014-05-20 Thread David Wohlferd
After thinking about this some more, I believe I have some better text. Previously I used the word "discouraged" to describe this practice. The existing docs use the term "avoid." I believe what you want is something more like the attached. Direct and clear, just like docs should be. If y

Re: RFC: Doc update for attribute

2014-05-20 Thread Georg-Johann Lay
Am 05/16/2014 07:16 PM, schrieb Carlos O'Donell: On 05/12/2014 11:13 PM, David Wohlferd wrote: After updating gcc's docs about inline asm, I'm trying to improve some of the related sections. One that I feel has problems with clarity is __attribute__ naked. I have attached my proposed update. Co

Re: RFC: Doc update for attribute

2014-05-20 Thread Carlos O'Donell
On 05/20/2014 03:02 AM, David Wohlferd wrote: > After thinking about this some more, I believe I have some better > text. Previously I used the word "discouraged" to describe this > practice. The existing docs use the term "avoid." I believe what you > want is something more like the attached. Dire

Re: RFC: Doc update for attribute

2014-05-20 Thread Carlos O'Donell
On 05/20/2014 03:59 AM, Georg-Johann Lay wrote: > Am 05/16/2014 07:16 PM, schrieb Carlos O'Donell: >> On 05/12/2014 11:13 PM, David Wohlferd wrote: >>> After updating gcc's docs about inline asm, I'm trying to >>> improve some of the related sections. One that I feel has >>> problems with clarity i

Re: RFC: Doc update for attribute

2014-05-21 Thread Georg-Johann Lay
Am 05/20/2014 03:31 PM, schrieb Carlos O'Donell: On 05/20/2014 03:59 AM, Georg-Johann Lay wrote: Am 05/16/2014 07:16 PM, schrieb Carlos O'Donell: On 05/12/2014 11:13 PM, David Wohlferd wrote: After updating gcc's docs about inline asm, I'm trying to improve some of the related sections. One th