From: Dave Fluri Date: Mon, 21 Jul 2003 15:08:55 +0000 (+0000) Subject: * doc/extend.texi: Fixes to spelling, grammar, and diction. X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=64c18e57103be5270d79ed9ce0be72a57a7e5944;p=gcc.git * doc/extend.texi: Fixes to spelling, grammar, and diction. From-SVN: r69633 --- diff --git a/gcc/ChangeLog b/gcc/ChangeLog index b829d19fc80..b120c1501eb 100644 --- a/gcc/ChangeLog +++ b/gcc/ChangeLog @@ -1,3 +1,7 @@ +2003-07-21 Dave Fluri + + * doc/extend.texi: Fixes to spelling, grammar, and diction. + 2003-07-21 Ben Elliston * doc/invoke.texi (Optimize Options): Replace "it's" with "its". diff --git a/gcc/doc/extend.texi b/gcc/doc/extend.texi index 6170978b1ef..4bf39cac01f 100644 --- a/gcc/doc/extend.texi +++ b/gcc/doc/extend.texi @@ -2312,7 +2312,7 @@ and linker. @cindex @code{malloc} attribute The @code{malloc} attribute is used to tell the compiler that a function may be treated as if it were the malloc function. The compiler assumes -that calls to malloc result in a pointers that cannot alias anything. +that calls to malloc result in pointers that cannot alias anything. This will often improve optimization. @item alias ("@var{target}") @@ -2364,7 +2364,7 @@ by another module. Internal visibility is like hidden visibility, but with additional processor specific semantics. Unless otherwise specified by the psABI, gcc defines internal visibility to mean that the function is @emph{never} -called from another module. Note that hidden symbols, while then cannot +called from another module. Note that hidden symbols, while they cannot be referenced directly by other modules, can be referenced indirectly via function pointers. By indicating that a symbol cannot be called from outside the module, gcc may for instance omit the load of a PIC register @@ -2423,12 +2423,12 @@ attribute causes the compiler not to do this. These attributes override both the @option{-mlongcall} switch and the @code{#pragma longcall} setting. -@xref{RS/6000 and PowerPC Options}, for more information on when long -calls are and are not necessary. +@xref{RS/6000 and PowerPC Options}, for more information on whether long +calls are necessary. @item long_call/short_call @cindex indirect calls on ARM -This attribute allows to specify how to call a particular function on +This attribute specifies how a particular function is called on ARM@. Both attributes override the @option{-mlong-calls} (@pxref{ARM Options}) command line switch and @code{#pragma long_calls} settings. The @code{long_call} attribute causes the compiler to always call the @@ -2458,9 +2458,9 @@ interrupt handler when this attribute is present. Note, interrupt handlers for the H8/300, H8/300H and SH processors can be specified via the @code{interrupt_handler} attribute. -Note, on the AVR interrupts will be enabled inside the function. +Note, on the AVR, interrupts will be enabled inside the function. -Note, for the ARM you can specify the kind of interrupt to be handled by +Note, for the ARM, you can specify the kind of interrupt to be handled by adding an optional parameter to the interrupt attribute like this: @smallexample @@ -2515,20 +2515,20 @@ slightly under 32kbytes of data. @item signal @cindex signal handler functions on the AVR processors Use this attribute on the AVR to indicate that the specified -function is an signal handler. The compiler will generate function -entry and exit sequences suitable for use in an signal handler when this -attribute is present. Interrupts will be disabled inside function. +function is a signal handler. The compiler will generate function +entry and exit sequences suitable for use in a signal handler when this +attribute is present. Interrupts will be disabled inside the function. @item naked @cindex function without a prologue/epilogue code Use this attribute on the ARM, AVR, C4x and IP2K ports to indicate that the -specified function do not need prologue/epilogue sequences generated by +specified function does not need prologue/epilogue sequences generated by the compiler. It is up to the programmer to provide these sequences. @item model (@var{model-name}) @cindex function addressability on the M32R/D Use this attribute on the M32R/D to set the addressability of an object, -and the code generated for a function. +and of the code generated for a function. The identifier @var{model-name} is one of @code{small}, @code{medium}, or @code{large}, representing each of the code models. @@ -3001,7 +3001,7 @@ This is true on many RISC machines. On more traditional machine designs, @code{__alignof__ (double)} is 4 or even 2. Some machines never actually require alignment; they allow reference to any -data type even at an odd addresses. For these machines, @code{__alignof__} +data type even at an odd address. For these machines, @code{__alignof__} reports the @emph{recommended} alignment of a type. If the operand of @code{__alignof__} is an lvalue rather than a type, @@ -3138,7 +3138,7 @@ variables that are expected to be removed in a future version of a program. The warning also includes the location of the declaration of the deprecated variable, to enable users to easily find further information about why the variable is deprecated, or what they should -do instead. Note that the warnings only occurs for uses: +do instead. Note that the warning only occurs for uses: @smallexample extern int old_var __attribute__ ((deprecated)); @@ -3474,7 +3474,7 @@ alignment. See your linker documentation for further information. @item packed This attribute, attached to an @code{enum}, @code{struct}, or -@code{union} type definition, specified that the minimum required memory +@code{union} type definition, specifies that the minimum required memory be used to represent the type. @opindex fshort-enums @@ -3503,7 +3503,7 @@ the referenced type must be respected, just as with normal pointer conversions. Second, the argument is passed to the function using the calling -conventions of first member of the transparent union, not the calling +conventions of the first member of the transparent union, not the calling conventions of the union itself. All members of the union must have the same machine representation; this is necessary for this argument passing to work properly. @@ -3735,8 +3735,9 @@ The definition in the header file will cause most calls to the function to be inlined. If any uses of the function remain, they will refer to the single copy in the library. -For future compatibility with when GCC implements ISO C99 semantics for -inline functions, it is best to use @code{static inline} only. (The +Since GCC eventually will implement ISO C99 semantics for +inline functions, it is best to use @code{static inline} only +to guarentee compatibility. (The existing semantics will remain available when @option{-std=gnu89} is specified, but eventually the default will be @option{-std=gnu99} and that will implement the C99 semantics, though it does not do so yet.) @@ -3808,7 +3809,7 @@ asm ("fsinx %[angle],%[output]" @noindent Note that the symbolic operand names have no relation whatsoever to other C identifiers. You may use any name you like, even those of -existing C symbols, but must ensure that no two operands within the same +existing C symbols, but you must ensure that no two operands within the same assembler construct use the same symbolic name. Output operand expressions must be lvalues; the compiler can check this.