Commit 64c18e57 by Dave Fluri Committed by Gerald Pfeifer

* doc/extend.texi: Fixes to spelling, grammar, and diction.

From-SVN: r69633
parent c7b61316
2003-07-21 Dave Fluri <dave.fluri@onlink.net>
* doc/extend.texi: Fixes to spelling, grammar, and diction.
2003-07-21 Ben Elliston <bje@wasabisystems.com> 2003-07-21 Ben Elliston <bje@wasabisystems.com>
* doc/invoke.texi (Optimize Options): Replace "it's" with "its". * doc/invoke.texi (Optimize Options): Replace "it's" with "its".
......
...@@ -2312,7 +2312,7 @@ and linker. ...@@ -2312,7 +2312,7 @@ and linker.
@cindex @code{malloc} attribute @cindex @code{malloc} attribute
The @code{malloc} attribute is used to tell the compiler that a function 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 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. This will often improve optimization.
@item alias ("@var{target}") @item alias ("@var{target}")
...@@ -2364,7 +2364,7 @@ by another module. ...@@ -2364,7 +2364,7 @@ by another module.
Internal visibility is like hidden visibility, but with additional Internal visibility is like hidden visibility, but with additional
processor specific semantics. Unless otherwise specified by the psABI, processor specific semantics. Unless otherwise specified by the psABI,
gcc defines internal visibility to mean that the function is @emph{never} 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 be referenced directly by other modules, can be referenced indirectly via
function pointers. By indicating that a symbol cannot be called from 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 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 ...@@ -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} both the @option{-mlongcall} switch and the @code{#pragma longcall}
setting. setting.
@xref{RS/6000 and PowerPC Options}, for more information on when long @xref{RS/6000 and PowerPC Options}, for more information on whether long
calls are and are not necessary. calls are necessary.
@item long_call/short_call @item long_call/short_call
@cindex indirect calls on ARM @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}) ARM@. Both attributes override the @option{-mlong-calls} (@pxref{ARM Options})
command line switch and @code{#pragma long_calls} settings. The command line switch and @code{#pragma long_calls} settings. The
@code{long_call} attribute causes the compiler to always call the @code{long_call} attribute causes the compiler to always call the
...@@ -2458,9 +2458,9 @@ interrupt handler when this attribute is present. ...@@ -2458,9 +2458,9 @@ interrupt handler when this attribute is present.
Note, interrupt handlers for the H8/300, H8/300H and SH processors can Note, interrupt handlers for the H8/300, H8/300H and SH processors can
be specified via the @code{interrupt_handler} attribute. 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: adding an optional parameter to the interrupt attribute like this:
@smallexample @smallexample
...@@ -2515,20 +2515,20 @@ slightly under 32kbytes of data. ...@@ -2515,20 +2515,20 @@ slightly under 32kbytes of data.
@item signal @item signal
@cindex signal handler functions on the AVR processors @cindex signal handler functions on the AVR processors
Use this attribute on the AVR to indicate that the specified Use this attribute on the AVR to indicate that the specified
function is an signal handler. The compiler will generate function function is a signal handler. The compiler will generate function
entry and exit sequences suitable for use in an signal handler when this entry and exit sequences suitable for use in a signal handler when this
attribute is present. Interrupts will be disabled inside function. attribute is present. Interrupts will be disabled inside the function.
@item naked @item naked
@cindex function without a prologue/epilogue code @cindex function without a prologue/epilogue code
Use this attribute on the ARM, AVR, C4x and IP2K ports to indicate that the 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. the compiler. It is up to the programmer to provide these sequences.
@item model (@var{model-name}) @item model (@var{model-name})
@cindex function addressability on the M32R/D @cindex function addressability on the M32R/D
Use this attribute on the M32R/D to set the addressability of an object, 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}, The identifier @var{model-name} is one of @code{small}, @code{medium},
or @code{large}, representing each of the code models. or @code{large}, representing each of the code models.
...@@ -3001,7 +3001,7 @@ This is true on many RISC machines. On more traditional machine ...@@ -3001,7 +3001,7 @@ This is true on many RISC machines. On more traditional machine
designs, @code{__alignof__ (double)} is 4 or even 2. designs, @code{__alignof__ (double)} is 4 or even 2.
Some machines never actually require alignment; they allow reference to any 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. reports the @emph{recommended} alignment of a type.
If the operand of @code{__alignof__} is an lvalue rather than 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 ...@@ -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 program. The warning also includes the location of the declaration
of the deprecated variable, to enable users to easily find further of the deprecated variable, to enable users to easily find further
information about why the variable is deprecated, or what they should 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 @smallexample
extern int old_var __attribute__ ((deprecated)); extern int old_var __attribute__ ((deprecated));
...@@ -3474,7 +3474,7 @@ alignment. See your linker documentation for further information. ...@@ -3474,7 +3474,7 @@ alignment. See your linker documentation for further information.
@item packed @item packed
This attribute, attached to an @code{enum}, @code{struct}, or 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. be used to represent the type.
@opindex fshort-enums @opindex fshort-enums
...@@ -3503,7 +3503,7 @@ the referenced type must be respected, just as with normal pointer ...@@ -3503,7 +3503,7 @@ the referenced type must be respected, just as with normal pointer
conversions. conversions.
Second, the argument is passed to the function using the calling 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 conventions of the union itself. All members of the union must have the
same machine representation; this is necessary for this argument passing same machine representation; this is necessary for this argument passing
to work properly. to work properly.
...@@ -3735,8 +3735,9 @@ The definition in the header file will cause most calls to the function ...@@ -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 to be inlined. If any uses of the function remain, they will refer to
the single copy in the library. the single copy in the library.
For future compatibility with when GCC implements ISO C99 semantics for Since GCC eventually will implement ISO C99 semantics for
inline functions, it is best to use @code{static inline} only. (The 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 existing semantics will remain available when @option{-std=gnu89} is
specified, but eventually the default will be @option{-std=gnu99} and specified, but eventually the default will be @option{-std=gnu99} and
that will implement the C99 semantics, though it does not do so yet.) that will implement the C99 semantics, though it does not do so yet.)
...@@ -3808,7 +3809,7 @@ asm ("fsinx %[angle],%[output]" ...@@ -3808,7 +3809,7 @@ asm ("fsinx %[angle],%[output]"
@noindent @noindent
Note that the symbolic operand names have no relation whatsoever to Note that the symbolic operand names have no relation whatsoever to
other C identifiers. You may use any name you like, even those of 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. assembler construct use the same symbolic name.
Output operand expressions must be lvalues; the compiler can check this. Output operand expressions must be lvalues; the compiler can check this.
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment