diff options
Diffstat (limited to 'gcc/doc')
| -rw-r--r-- | gcc/doc/c-tree.texi | 2 | ||||
| -rw-r--r-- | gcc/doc/contrib.texi | 2 | ||||
| -rw-r--r-- | gcc/doc/cpp.texi | 10 | ||||
| -rw-r--r-- | gcc/doc/cppinternals.texi | 4 | ||||
| -rw-r--r-- | gcc/doc/cppopts.texi | 14 | ||||
| -rw-r--r-- | gcc/doc/extend.texi | 275 | ||||
| -rw-r--r-- | gcc/doc/gcc.texi | 4 | ||||
| -rw-r--r-- | gcc/doc/gcov.texi | 32 | ||||
| -rw-r--r-- | gcc/doc/include/gcc-common.texi | 2 | ||||
| -rw-r--r-- | gcc/doc/include/sourcecode.texi | 36 | ||||
| -rw-r--r-- | gcc/doc/install.texi | 37 | ||||
| -rw-r--r-- | gcc/doc/invoke.texi | 722 | ||||
| -rw-r--r-- | gcc/doc/md.texi | 4 | ||||
| -rw-r--r-- | gcc/doc/objc.texi | 4 | ||||
| -rw-r--r-- | gcc/doc/sourcebuild.texi | 6 | ||||
| -rw-r--r-- | gcc/doc/standards.texi | 2 | ||||
| -rw-r--r-- | gcc/doc/tm.texi | 93 | ||||
| -rw-r--r-- | gcc/doc/tree-ssa.texi | 18 | ||||
| -rw-r--r-- | gcc/doc/trouble.texi | 20 |
19 files changed, 1076 insertions, 211 deletions
diff --git a/gcc/doc/c-tree.texi b/gcc/doc/c-tree.texi index e0881cf2d80..a6033f16256 100644 --- a/gcc/doc/c-tree.texi +++ b/gcc/doc/c-tree.texi @@ -1363,7 +1363,7 @@ void process_stmt (stmt) @{ case IF_STMT: process_stmt (THEN_CLAUSE (stmt)); - /* More processing here. */ + /* @r{More processing here.} */ break; @dots{} diff --git a/gcc/doc/contrib.texi b/gcc/doc/contrib.texi index e1944ebba54..64436a9d07d 100644 --- a/gcc/doc/contrib.texi +++ b/gcc/doc/contrib.texi @@ -279,7 +279,7 @@ feeding the gcc.gnu.org box and saving its users tons of spam. Fred Fish for BeOS support and Ada fixes. @item -Ivan Fontes Garcia for the Portugese translation of the GCJ FAQ@. +Ivan Fontes Garcia for the Portuguese translation of the GCJ FAQ@. @item Peter Gerwinski for various bug fixes and the Pascal front end. diff --git a/gcc/doc/cpp.texi b/gcc/doc/cpp.texi index ea38218b8c1..e6a7dcd06eb 100644 --- a/gcc/doc/cpp.texi +++ b/gcc/doc/cpp.texi @@ -1318,7 +1318,7 @@ name, and you wish to use the function sometimes. @smallexample extern void foo(void); -#define foo() /* optimized inline version */ +#define foo() /* @r{optimized inline version} */ @dots{} foo(); funcptr = foo; @@ -2211,7 +2211,7 @@ These definitions are effectively the same: @smallexample #define FOUR (2 + 2) #define FOUR (2 + 2) -#define FOUR (2 /* two */ + 2) +#define FOUR (2 /* @r{two} */ + 2) @end smallexample @noindent but these are not: @@ -3538,8 +3538,8 @@ require matching quotes. For example: @smallexample #define m This macro's fine and has an unmatched quote "/* This is not a comment. */ -/* This is a comment. The following #include directive - is ill-formed. */ +/* @r{This is a comment. The following #include directive + is ill-formed.} */ #include <stdio.h @end smallexample @@ -3626,7 +3626,7 @@ example @smallexample #define str(x) "x" -str(/* A comment */some text ) +str(/* @r{A comment} */some text ) @expansion{} "some text " @end smallexample diff --git a/gcc/doc/cppinternals.texi b/gcc/doc/cppinternals.texi index b5ee7844d2d..13db034b0ca 100644 --- a/gcc/doc/cppinternals.texi +++ b/gcc/doc/cppinternals.texi @@ -789,8 +789,8 @@ lexed on if, for example, there are intervening escaped newlines or C-style comments. For example: @smallexample -foo /* A long -comment */ bar \ +foo /* @r{A long +comment} */ bar \ baz @result{} foo bar baz diff --git a/gcc/doc/cppopts.texi b/gcc/doc/cppopts.texi index 872cffcd501..5edeebdf239 100644 --- a/gcc/doc/cppopts.texi +++ b/gcc/doc/cppopts.texi @@ -237,6 +237,12 @@ preprocessed output. When used with the driver options @option{-MD} or @option{-MMD}, @option{-MF} overrides the default dependency output file. +@c APPLE LOCAL begin -dependency-file +@item -dependency-file +@opindex dependency-file @var{name} +Like @option{-MF}. (APPLE ONLY) +@c APPLE LOCAL end -dependency-file + @item -MG @opindex MG In conjunction with an option such as @option{-M} requesting @@ -348,13 +354,17 @@ current directory. @item -x c @itemx -x c++ @itemx -x objective-c +@c APPLE LOCAL Objective-C++ +@itemx -x objective-c++ @itemx -x assembler-with-cpp @opindex x -Specify the source language: C, C++, Objective-C, or assembly. This has +@c APPLE LOCAL Objective-C++ +Specify the source language: C, C++, Objective-C, Objective-C++, or assembly. This has nothing to do with standards conformance or extensions; it merely selects which base syntax to expect. If you give none of these options, cpp will deduce the language from the extension of the source file: -@samp{.c}, @samp{.cc}, @samp{.m}, or @samp{.S}. Some other common +@c APPLE LOCAL Objective-C++ +@samp{.c}, @samp{.cc}, @samp{.m}, @samp{.mm}, or @samp{.S}. Some other common extensions for C++ and assembly are also recognized. If cpp does not recognize the extension, it will treat the file as C; this is the most generic mode. diff --git a/gcc/doc/extend.texi b/gcc/doc/extend.texi index 7e4d66aaa87..ad7fbeb3dbd 100644 --- a/gcc/doc/extend.texi +++ b/gcc/doc/extend.texi @@ -54,6 +54,10 @@ extensions, accepted by GCC in C89 mode and in C++. * C++ Comments:: C++ comments are recognized. * Dollar Signs:: Dollar sign is allowed in identifiers. * Character Escapes:: @samp{\e} stands for the character @key{ESC}. +@c APPLE LOCAL begin pascal strings +* Pascal Strings:: Constructing string literals with a Pascal-style + length byte. +@c APPLE LOCAL end pascal strings * Variable Attributes:: Specifying attributes of variables. * Type Attributes:: Specifying attributes of types. * Alignment:: Inquiring about the alignment of a type or variable. @@ -63,6 +67,8 @@ extensions, accepted by GCC in C89 mode and in C++. * Constraints:: Constraints for asm operands * Asm Labels:: Specifying the assembler name to use for a C symbol. * Explicit Reg Vars:: Defining variables residing in specified registers. +@c APPLE LOCAL CW asm blocks +* Asm Blocks and Functions:: Block and functions of assembly code. * Alternate Keywords:: @code{__const__}, @code{__asm__}, etc., for header files. * Incomplete Enums:: @code{enum foo;}, with details to follow. * Function Names:: Printable strings which are the name of the current @@ -187,6 +193,29 @@ work with C++. (Note that some versions of the GNU C Library contained header files using statement-expression that lead to precisely this bug.) +Jumping into a statement expression with @code{goto} or using a +@code{switch} statement outside the statement expression with a +@code{case} or @code{default} label inside the statement expression is +not permitted. Jumping into a statement expression with a computed +@code{goto} (@pxref{Labels as Values}) yields undefined behavior. +Jumping out of a statement expression is permitted, but if the +statement expression is part of a larger expression then it is +unspecified which other subexpressions of that expression have been +evaluated except where the language definition requires certain +subexpressions to be evaluated before or after the statement +expression. In any case, as with a function call the evaluation of a +statement expression is not interleaved with the evaluation of other +parts of the containing expression. For example, + +@smallexample + foo (), ((@{ bar1 (); goto a; 0; @}) + bar2 ()), baz(); +@end smallexample + +@noindent +will call @code{foo} and @code{bar1} and will not call @code{baz} but +may or may not call @code{bar2}. If @code{bar2} is called, it will be +called after @code{foo} and before @code{bar1} + @node Local Labels @section Locally Declared Labels @cindex local labels @@ -449,8 +478,10 @@ bar (int *array, int offset, int size) @end group @end smallexample +@c APPLE LOCAL begin mainline 2005-03-04 A nested function always has no linkage. Declaring one with @code{extern} or @code{static} is erroneous. If you need to declare the nested function +@c APPLE LOCAL end mainline 2005-03-04 before its definition, use @code{auto} (which is otherwise meaningless for function declarations). @@ -1527,7 +1558,8 @@ void f () __attribute__ ((weak, alias ("__f"))); @end smallexample declares @samp{f} to be a weak alias for @samp{__f}. In C++, the -mangled name for the target must be used. +mangled name for the target must be used. It is an error if @samp{__f} +is not defined in the same translation unit. Not all target machines support this attribute. @@ -1549,7 +1581,7 @@ useful to override the effects of the @option{-mrtd} switch. @cindex @code{const} function attribute Many functions do not examine any values except their arguments, and have no effects except the return value. Basically this is just slightly -more strict class than the @code{pure} attribute above, since function is not +more strict class than the @code{pure} attribute below, since function is not allowed to read global memory. @cindex pointer arguments @@ -1868,6 +1900,8 @@ the specified function is an interrupt handler. The compiler will generate function entry and exit sequences suitable for use in an interrupt handler when this attribute is present. +@c APPLE LOCAL Apple customers doesn't care about ARM options. +@ignore @item long_call/short_call @cindex indirect calls on ARM This attribute specifies how a particular function is called on @@ -1878,6 +1912,8 @@ function by first loading its address into a register and then using the contents of that register. The @code{short_call} attribute always places the offset to the function from the call site into the @samp{BL} instruction directly. +@c APPLE LOCAL Apple customers don't care about ARM options. +@end ignore @item longcall/shortcall @cindex functions called via pointer on the RS/6000 and PowerPC @@ -2034,6 +2070,8 @@ typedef void voidfn (); volatile voidfn fatal; @end smallexample +This approach does not work in GNU C++. + @item nothrow @cindex @code{nothrow} function attribute The @code{nothrow} attribute is used to inform the compiler that a @@ -2573,7 +2611,7 @@ int isroot P((uid_t)); /* @r{Old-style function definition.} */ int -isroot (x) /* ??? lossage here ??? */ +isroot (x) /* @r{??? lossage here ???} */ uid_t x; @{ return x == 0; @@ -2640,6 +2678,62 @@ machines, typically because the target assembler does not allow them. You can use the sequence @samp{\e} in a string or character constant to stand for the ASCII character @key{ESC}. +@c APPLE LOCAL begin pascal strings +@node Pascal Strings +@section Constructing String Literals with a Pascal-style Length Byte +@cindex Pascal length byte +@cindex Pascal strings + +Specifying the @w{@option{-fpascal-strings}} option will cause the +compiler to recognize and construct Pascal-style string literals. This +functionality is disabled by default; furthermore, its use in new code +is discouraged. + +Pascal string literals take the form @samp{"\pstring"}. The special +escape sequence @samp{\p} denotes the Pascal length byte for the string, +and will be replaced at compile time with the number of characters that +follow. The @samp{\p} may only appear at the beginning of a string +literal, and may @emph{not} appear in wide string literals or as an +integral constant. + +As is the case with C string literals, Pascal string literals are +terminated with a NUL character; this character is @emph{not} counted +when computing the value of the length byte. The maximum @samp{unsigned +char} value that can be stored in the length byte is also the maximum +permissible length for the Pascal literal itself. On most target +platforms, this value is 255 (excluding both the length byte and the +terminating NUL). + +Pascal-style literals are treated by the compiler as being of type +@samp{const unsigned char []} in C++ and @samp{unsigned char []} (or +@samp{const unsigned char []}, if the @w{@option{-Wwrite-strings}} +option is given) in C. Pascal string literals may be used as static +initializers for @samp{char} arrays (whose elements need not be +@samp{unsigned} or @samp{const}). They may also be converted to +@samp{const unsigned char *} and, in the C language to @samp{const char +*} of any signedness (In C, if the @w{@option{-Wwrite-strings}} is not +given, then @samp{const} may be omitted as well). For example: + +@example +const unsigned char a[] = "\pHello"; +char b[] = "\pGoodbye"; +const unsigned char *c = "\pHello"; +const signed char *d = "\pHello"; /* error in C++ */ +char *e = "\pHi"; /* error in C++; warning in C with -Wwrite-strings */ +unsigned char *f = "\pHello"; /* error in C++ */ +@end example + +@noindent +In all other respects, Pascal-style string literals behave the same as +ordinary string literals. For example, if a program attempts to modify +the conents of a Pascal-style string literal at run-time, the behaviour +is undefined, unless the @w{@option{-fwritable-strings}} option is used. + +Pascal-style literals are useful for calling external routines that +expect Pascal strings as arguments, as is true with some Apple MacOS +Toolbox calls. +@c APPLE LOCAL end pascal strings + @node Alignment @section Inquiring on Alignment of Types or Variables @cindex alignment @@ -2852,13 +2946,13 @@ int init_data __attribute__ ((section ("INITDATA"))) = 0; main() @{ - /* Initialize stack pointer */ + /* @r{Initialize stack pointer} */ init_sp (stack + sizeof (stack)); - /* Initialize initialized data */ + /* @r{Initialize initialized data} */ memcpy (&init_data, &data, &edata - &data); - /* Turn on the serial ports */ + /* @r{Turn on the serial ports} */ init_duart (&a); init_duart (&b); @} @@ -2897,8 +2991,8 @@ int foo __attribute__((section ("shared"), shared)) = 0; int main() @{ - /* Read and write foo. All running - copies see the same value. */ + /* @r{Read and write foo. All running + copies see the same value.} */ return 0; @} @end smallexample @@ -3462,7 +3556,7 @@ GCC does not inline any functions when not optimizing unless you specify the @samp{always_inline} attribute for the function, like this: @smallexample -/* Prototype. */ +/* @r{Prototype.} */ inline void foo (const char) __attribute__((always_inline)); @end smallexample @@ -3632,7 +3726,7 @@ example for the VAX: @smallexample asm volatile ("movc3 %0,%1,%2" - : /* no outputs */ + : /* @r{no outputs} */ : "g" (from), "g" (to), "g" (count) : "r0", "r1", "r2", "r3", "r4", "r5"); @end smallexample @@ -4195,6 +4289,85 @@ register int *p2 asm ("r1") = @dots{}; In those cases, a solution is to use a temporary variable for each arbitrary expression. @xref{Example of asm with clobbered asm reg}. +@c APPLE LOCAL begin CW asm blocks +@node Asm Blocks and Functions +@section Blocks and Functions of Assembly Language + +(This feature is APPLE ONLY.) + +In addition to writing single statements in assembly, you can also +define blocks and entire functions to use a mixed assembly and C +syntax. The syntax follows that used in Metrowerks' CodeWarrior. +This extension must be explicitly enabled with the +@option{-fasm-blocks} option. + +The block syntax consists of @code{asm} followed by braces, with the +assembly instructions on separate lines. (However, @code{';'} may be +used to put several instructions on one line.) You write labels with +either a preceding @code{'@@'} or a trailing @code{':'} (or both, if +you prefer); labels are always local to the asm block, and there is no +way for a label in one block to refer to a label in another block. +Comments and lexical rules are as for standard C/C++. + +@verbatim +int foo (int arg) { + register int bar; + asm { + li bar, 42 + add bar, arg, bar ; nop ; ; nop + } + return bar; +} +@end verbatim + +The function syntax uses @code{asm} as a keyword in the function +definition. In this form, C declarations may appear at the beginning +of the function body, in order to declare variables that you want to +use in the body, but may not be used after the first assembly opcode +or label (even in C99 or C++). + +@verbatim +asm int baz (int arg1) { + register int loc1, loc2; + @123 + li loc1,4 * 89 + nand. r5,arg1,loc1 + ble- cr0, @123 + otherlab: nop + mr r3,r5 +} +@end verbatim + +Note that the compiler just passes the instructions through to the +assembler with only necessary changes, such as a substitution of +globally unique labels. Assembly syntax errors will therefore be +reported by the assembler. + +Also note that the use of literal registers (such as r3) in functions +may not work properly with functions that are being inlined. + +The following instructions are assumed to affect memory: @code{l...} +except @code{la}, @code{li} and @code{lis} (all memory loads), +@code{st...} (all memory stores), @code{sc}, @code{td...}, +@code{trap}, @code{tw...}. All other instructions are assumed to not +affect memory. + +The following instructions take a memory operand (address operand) as +their second operand, all other instructions are assumed to not: + +@code{la}, @code{lbzu}, @code{ld}, @code{ldu}, @code{lfd}, +@code{lfdu}, @code{lfs}, @code{lfsu}, @code{lha}, @code{lhau}, +@code{lhz}, @code{lhzu}, @code{lmw}, @code{lwa}, @code{lwz}, +@code{lwzu}, @code{stb}, @code{stbu}, @code{std}, @code{stdu}, +@code{stfd}, @code{stfdu}, @code{stfs}, @code{stfsu}, @code{sth}, +@code{sthu}, @code{stmw}, @code{stw}, @code{stwu}. + +Arguments that require substitution beyond vector registers, floating +point registers, general registers are not supported; an example +would be trying to use the compiler to allocate condition code +registers instead of just writting a specific condition code register. +@c APPLE LOCAL end CW asm blocks + @node Alternate Keywords @section Alternate Keywords @cindex alternate keywords @@ -5247,11 +5420,11 @@ type is @code{long double}. @deftypefn {Built-in Function} double __builtin_inf (void) Similar to @code{__builtin_huge_val}, except a warning is generated if the target floating-point format does not support infinities. -This function is suitable for implementing the ISO C99 macro @code{INFINITY}. @end deftypefn @deftypefn {Built-in Function} float __builtin_inff (void) Similar to @code{__builtin_inf}, except the return type is @code{float}. +This function is suitable for implementing the ISO C99 macro @code{INFINITY}. @end deftypefn @deftypefn {Built-in Function} {long double} __builtin_infl (void) @@ -7448,7 +7621,11 @@ vector unsigned short vec_vmuloub (vector unsigned char, vector unsigned char); vector float vec_nmsub (vector float, vector float, vector float); +@c APPLE LOCAL begin fixhtml --mrs +@end smallexample +@smallexample +@c APPLE LOCAL end fixhtml --mrs vector float vec_nor (vector float, vector float); vector signed int vec_nor (vector signed int, vector signed int); vector unsigned int vec_nor (vector unsigned int, vector unsigned int); @@ -8566,6 +8743,7 @@ for further explanation. * Solaris Pragmas:: * Symbol-Renaming Pragmas:: * Structure-Packing Pragmas:: +* Weak Pragmas:: @end menu @node ARM Pragmas @@ -8748,7 +8926,7 @@ way of knowing that that happened.) @node Structure-Packing Pragmas @subsection Structure-Packing Pragmas -For compatibility with Win32, GCC supports as set of @code{#pragma} +For compatibility with Win32, GCC supports a set of @code{#pragma} directives which change the maximum alignment of members of structures, unions, and classes subsequently defined. The @var{n} value below always is required to be a small power of two and specifies the new alignment @@ -8769,6 +8947,28 @@ multiple @code{#pragma pack(@var{n})} instances and finalized by a single @code{#pragma pack(pop)}. @end enumerate +@node Weak Pragmas +@subsection Weak Pragmas + +For compatibility with SVR4, GCC supports a set of @code{#pragma} +directives for declaring symbols to be weak, and defining weak +aliases. + +@table @code +@item #pragma weak @var{symbol} +@cindex pragma, weak +This pragma declares @var{symbol} to be weak, as if the declaration +had the attribute of the same name. The pragma may appear before +or after the declaration of @var{symbol}, but must appear before +either its first use or its definition. It is not an error for +@var{symbol} to never be defined at all. + +@item #pragma weak @var{symbol1} = @var{symbol2} +This pragma declares @var{symbol1} to be a weak alias of @var{symbol2}. +It is an error if @var{symbol2} is not defined in the current +translation unit. +@end table + @node Unnamed Fields @section Unnamed struct/union fields within structs/unions @cindex struct @@ -9093,7 +9293,6 @@ test specifically for GNU C++ (@pxref{Common Predefined Macros,, Predefined Macros,cpp,The GNU C Preprocessor}). @menu -* Min and Max:: C++ Minimum and maximum operators. * Volatiles:: What constitutes an access to a volatile object. * Restricted Pointers:: C99 restricted pointers and references. * Vague Linkage:: Where G++ puts inlines, vtables and such. @@ -9110,51 +9309,6 @@ Predefined Macros,cpp,The GNU C Preprocessor}). * Backwards Compatibility:: Compatibilities with earlier definitions of C++. @end menu -@node Min and Max -@section Minimum and Maximum Operators in C++ - -It is very convenient to have operators which return the ``minimum'' or the -``maximum'' of two arguments. In GNU C++ (but not in GNU C), - -@table @code -@item @var{a} <? @var{b} -@findex <? -@cindex minimum operator -is the @dfn{minimum}, returning the smaller of the numeric values -@var{a} and @var{b}; - -@item @var{a} >? @var{b} -@findex >? -@cindex maximum operator -is the @dfn{maximum}, returning the larger of the numeric values @var{a} -and @var{b}. -@end table - -These operations are not primitive in ordinary C++, since you can -use a macro to return the minimum of two things in C++, as in the -following example. - -@smallexample -#define MIN(X,Y) ((X) < (Y) ? : (X) : (Y)) -@end smallexample - -@noindent -You might then use @w{@samp{int min = MIN (i, j);}} to set @var{min} to -the minimum value of variables @var{i} and @var{j}. - -However, side effects in @code{X} or @code{Y} may cause unintended -behavior. For example, @code{MIN (i++, j++)} will fail, incrementing -the smaller counter twice. The GNU C @code{typeof} extension allows you -to write safe macros that avoid this kind of problem (@pxref{Typeof}). -However, writing @code{MIN} and @code{MAX} as macros also forces you to -use function-call notation for a fundamental arithmetic operation. -Using GNU C++ extensions, you can write @w{@samp{int min = i <? j;}} -instead. - -Since @code{<?} and @code{>?} are built into the compiler, they properly -handle expressions with side-effects; @w{@samp{int min = i++ <? j++;}} -works correctly. - @node Volatiles @section When is a Volatile Object Accessed? @cindex accessing volatiles @@ -9801,6 +9955,11 @@ by one returning a different pointer type. This extension to the covariant return type rules is now deprecated and will be removed from a future version. +The G++ minimum and maximum operators (@samp{<?} and @samp{>?}) and +their compound forms (@samp{<?=}) and @samp{>?=}) have been deprecated +and will be removed in a future version. Code using these operators +should be modified to use @code{std::min} and @code{std::max} instead. + The named return value extension has been deprecated, and is now removed from G++. diff --git a/gcc/doc/gcc.texi b/gcc/doc/gcc.texi index 66e22ed3b48..5a4fa107292 100644 --- a/gcc/doc/gcc.texi +++ b/gcc/doc/gcc.texi @@ -145,6 +145,8 @@ Introduction, gccint, GNU Compiler Collection (GCC) Internals}. * Copying:: GNU General Public License says how you can copy and share GCC. +@c APPLE LOCAL GPL compliance +* Source Code:: How to get the source code for this compiler. * GNU Free Documentation License:: How you can copy and share this manual. * Contributors:: People who have contributed to GCC. @@ -167,6 +169,8 @@ Introduction, gccint, GNU Compiler Collection (GCC) Internals}. @include funding.texi @include gnu.texi +@c APPLE LOCAL GPL compliance +@include sourcecode.texi @include gpl.texi @c --------------------------------------------------------------------- diff --git a/gcc/doc/gcov.texi b/gcc/doc/gcov.texi index 3278a4b5a97..bfe4a3d204e 100644 --- a/gcc/doc/gcov.texi +++ b/gcc/doc/gcov.texi @@ -207,7 +207,7 @@ option is not supplied, it defaults to the current directory. @item -u @itemx --unconditional-branches -When branch counts are given, include those of unconditional branches. +When branch probabilities are given, include those of unconditional branches. Unconditional branches are normally not interesting. @end table @@ -232,9 +232,27 @@ program source code. The format is Additional block information may succeed each line, when requested by command line option. The @var{execution_count} is @samp{-} for lines -containing no code and @samp{#####} for lines which were never -executed. Some lines of information at the start have @var{line_number} -of zero. +containing no code and @samp{#####} for lines which were never executed. +Some lines of information at the start have @var{line_number} of zero. + +The preamble lines are of the form + +@smallexample +-:0:@var{tag}:@var{value} +@end smallexample + +The ordering and number of these preamble lines will be augmented as +@command{gcov} development progresses --- do not rely on them remaining +unchanged. Use @var{tag} to locate a particular preamble line. + +The additional block information is of the form + +@smallexample +@var{tag} @var{information} +@end smallexample + +The @var{information} is human readable, but designed to be simple +enough for machine parsing too. When printing percentages, 0% and 100% are only printed when the values are @emph{exactly} 0% and 100% respectively. Other values which would @@ -278,7 +296,6 @@ Here is a sample: -: 1:#include <stdio.h> -: 2: -: 3:int main (void) -function main called 1 returned 1 blocks executed 75% 1: 4:@{ 1: 5: int i, total; -: 6: @@ -307,7 +324,6 @@ counts, and the output looks like this: -: 1:#include <stdio.h> -: 2: -: 3:int main (void) -function main called 1 returned 1 blocks executed 75% 1: 4:@{ 1: 4-block 0 1: 5: int i, total; @@ -390,6 +406,10 @@ call 0 called 1 returned 100% -: 17:@} @end smallexample +For each function, a line is printed showing how many times the function +is called, how many times it returns and what percentage of the +function's blocks were executed. + For each basic block, a line is printed after the last line of the basic block describing the branch or call that ends the basic block. There can be multiple branches and calls listed for a single source line if there diff --git a/gcc/doc/include/gcc-common.texi b/gcc/doc/include/gcc-common.texi index e6396574936..30fc8f10cca 100644 --- a/gcc/doc/include/gcc-common.texi +++ b/gcc/doc/include/gcc-common.texi @@ -9,7 +9,7 @@ @c DEVELOPMENT is set to indicate an in-development version, @c as compared to a release version. When making a release @c branch, clear this. -@set DEVELOPMENT +@clear DEVELOPMENT @c Common macros to support generating man pages: diff --git a/gcc/doc/include/sourcecode.texi b/gcc/doc/include/sourcecode.texi new file mode 100644 index 00000000000..8661d51864f --- /dev/null +++ b/gcc/doc/include/sourcecode.texi @@ -0,0 +1,36 @@ +@c APPLE LOCAL file GPL compliance +@node Source Code +@unnumbered Source Code + +The source code for Apple's versions of GCC is available using +anonymous CVS, from +@samp{:pserver:anonymous@@anoncvs.opensource.apple.com:/cvs/root} +with password @samp{anonymous}, as module @samp{gcc}, branch +@samp{apple-local-200502-branch}. + +For example, you can fetch the latest version by entering: + +@smallexample +$ cvs -d :pserver:anonymous@@anoncvs.opensource.apple.com:/cvs/root login +Password: anonymous +$ cvs -d :pserver:anonymous@@anoncvs.opensource.apple.com:/cvs/root -z6 \ + co -r apple-local-200502-branch gcc +@end smallexample + +Each version will be tagged based on its build number, which +you can find by executing @samp{gcc --version}; for instance, if this prints + +@smallexample +gcc (GCC) 3.3 20030304 (Apple Computer, Inc. build 1402) +@end smallexample + +then the build number is 1402. Some older compilers may require you +use @samp{gcc -v} to obtain the build number. Most versions are +tagged like @samp{apple-gcc-1402}; you can find a list of suitable tags with +a command like @samp{cvs log gcc/gcc/version.c}. Once you have the +tag, you can use the @samp{-r} flag to CVS, for instance + +@smallexample +$ cvs -d :pserver:anonymous@@anoncvs.opensource.apple.com:/cvs/root -z6 \ + co -r apple-gcc-1402 gcc +@end smallexample diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi index fd9cb66655a..8fb057097d9 100644 --- a/gcc/doc/install.texi +++ b/gcc/doc/install.texi @@ -973,12 +973,6 @@ systems that support conditional traps). Division by zero checks use the break instruction. @end table -@item --enable-altivec -Specify that the target supports AltiVec vector enhancements. This -option will adjust the ABI for AltiVec enhancements, as well as generate -AltiVec code when appropriate. This option is only available for -PowerPC systems. - @item --enable-__cxa_atexit Define if you want to use __cxa_atexit, rather than atexit, to register C++ destructors for local statics and global objects. @@ -1041,6 +1035,13 @@ particularly useful if you intend to use several versions of GCC in parallel. This is currently supported by @samp{libgfortran}, @samp{libjava}, @samp{libmudflap}, @samp{libstdc++}, and @samp{libobjc}. +@item --with-java-home=@var{dirname} +This @samp{libjava} option overrides the default value of the +@samp{java.home} system property. It is also used to set +@samp{sun.boot.class.path} to @file{@var{dirname}/lib/rt.jar}. By +default @samp{java.home} is set to @file{@var{prefix}} and +@samp{sun.boot.class.path} to +@file{@var{datadir}/java/libgcj-@var{version}.jar}. @item --enable-languages=@var{lang1},@var{lang2},@dots{} Specify that only a particular subset of compilers and @@ -1145,6 +1146,12 @@ When this option is specified more detailed information on memory allocation is gathered. This information is printed when using @option{-fmem-report}. +@item --with-gc +@itemx --with-gc=@var{choice} +With this option you can specify the garbage collector implementation +used during the compilation process. @var{choice} can be one of +@samp{page} and @samp{zone}, where @samp{page} is the default. + @item --enable-nls @itemx --disable-nls The @option{--enable-nls} option enables Native Language Support (NLS), @@ -1823,7 +1830,7 @@ testsuite at @file{libjava/testsuite/libjava.mauve/mauve}, or by specifying the location of that tree when invoking @samp{make}, as in @samp{make MAUVEDIR=~/mauve check}. -@uref{http://www-124.ibm.com/developerworks/oss/cvs/jikes/~checkout~/jacks/jacks.html,,Jacks} +@uref{http://sources.redhat.com/mauve/,,Jacks} is a free testsuite that tests Java compiler front ends. This suite can be run as part of libgcj testing by placing the Jacks tree within the libjava testsuite at @file{libjava/testsuite/libjava.jacks/jacks}. @@ -2232,7 +2239,7 @@ GNU Compiler Collection on your machine. @item @uref{#powerpc-*-elf,,powerpc-*-elf, powerpc-*-sysv4} @item -@uref{#powerpc-*-linux-gnu*,,powerpc-*-linux-gnu*} +@uref{#powerpc*-*-linux-gnu*,,powerpc*-*-linux-gnu*} @item @uref{#powerpc-*-netbsd*,,powerpc-*-netbsd*} @item @@ -3362,7 +3369,7 @@ PowerPC running Darwin (Mac OS X kernel). Pre-installed versions of Mac OS X may not include any developer tools, meaning that you will not be able to build GCC from source. Tool binaries are available at -@uref{http://developer.apple.com/tools/compilers.html} (free +@uref{http://developer.apple.com/darwin/projects/compiler/} (free registration required). This version of GCC requires at least cctools-528. @@ -3380,10 +3387,10 @@ PowerPC system in big endian mode, running System V.4. @html <hr /> @end html -@heading @anchor{powerpc-*-linux-gnu*}powerpc-*-linux-gnu* +@heading @anchor{powerpc*-*-linux-gnu*}powerpc*-*-linux-gnu* You will need -@uref{ftp://ftp.kernel.org/pub/linux/devel/binutils,,binutils 2.13.90.0.10} +@uref{ftp://ftp.kernel.org/pub/linux/devel/binutils,,binutils 2.15} or newer for a working GCC@. @html @@ -3596,6 +3603,14 @@ ld: warning: relocation error: R_SPARC_UA32: @dots{} To work around this problem, compile with @option{-gstabs+} instead of plain @option{-g}. +When configuring the GNU Multiple Precision Library (GMP) on a Solaris 7 +or later system, the canonical target triplet must be specified as the +@command{build} parameter on the configure line: + +@smallexample +./configure --build=sparc-sun-solaris2.7 --prefix=xxx --enable-mpfr +@end smallexample + @html <hr /> @end html diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index 88f19dc4afc..593fc50d82b 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -40,6 +40,21 @@ gcc [@option{-c}|@option{-S}|@option{-E}] [@option{-std=}@var{standard}] Only the most useful options are listed here; see below for the remainder. @samp{g++} accepts mostly the same options as @samp{gcc}. + +@c APPLE LOCAL begin manual +In Apple's version of GCC, both @samp{cc} and @samp{gcc} are actually +symbolic links to a compiler named like @samp{gcc-3.4}; which compiler +is linked to may be changed using the command @samp{gcc_select}. +Similarly, @samp{c++} and @samp{g++} are links to a compiler named like +@samp{g++-3.4}. + +Note that Apple's GCC includes a number of extensions to standard GCC +(flagged below with ``APPLE ONLY''), and that not all generic GCC +options are available or supported on Darwin / Mac OS X. In particular, +Apple does not currently support the compilation of Fortran, Ada, or +Java, although there are third parties who have made these work. +@c APPLE LOCAL end manual + @c man end @c man begin SEEALSO gpl(7), gfdl(7), fsf-funding(7), @@ -48,8 +63,10 @@ and the Info entries for @file{gcc}, @file{cpp}, @file{as}, @file{ld}, @file{binutils} and @file{gdb}. @c man end @c man begin BUGS -For instructions on reporting bugs, see -@w{@uref{http://gcc.gnu.org/bugs.html}}. +@c APPLE LOCAL begin Apple bug-report +To report bugs to Apple, see +@w{@uref{http://developer.apple.com/bugreporter}}. +@c APPLE LOCAL end Apple bug-report @c man end @c man begin AUTHOR See the Info entry for @command{gcc}, or @@ -156,17 +173,44 @@ in the following sections. @item Overall Options @xref{Overall Options,,Options Controlling the Kind of Output}. @gccoptlist{-c -S -E -o @var{file} -combine -pipe -pass-exit-codes @gol +@c APPLE LOCAL -ObjC 2001-08-03 --sts ** +-ObjC (APPLE ONLY) -ObjC++ (APPLE ONLY) @gol +@c APPLE LOCAL fat builds +-arch @var{arch} (APPLE ONLY) @gol -x @var{language} -v -### --help --target-help --version} @item C Language Options @xref{C Dialect Options,,Options Controlling C Dialect}. @gccoptlist{-ansi -std=@var{standard} -aux-info @var{filename} @gol +@c APPLE LOCAL AltiVec +-faltivec (APPLE ONLY) @gol +@c APPLE LOCAL CW asm blocks +-fasm-blocks (APPLE ONLY) @gol -fno-asm -fno-builtin -fno-builtin-@var{function} @gol -fhosted -ffreestanding -fms-extensions @gol -trigraphs -no-integrated-cpp -traditional -traditional-cpp @gol -fallow-single-precision -fcond-mismatch @gol +@c APPLE LOCAL constant cfstrings --mrs +-fconstant-cfstrings (APPLE ONLY) @gol +@c APPLE LOCAL non lvalue assign +-fnon-lvalue-assign (APPLE ONLY) @gol +@c APPLE LOCAL pch distcc --mrs +-fpch-preprocess (APPLE ONLY) @gol -fsigned-bitfields -fsigned-char @gol --funsigned-bitfields -funsigned-char} +@c APPLE LOCAL pascal strings +-fpascal-strings (APPLE ONLY) @gol +@c APPLE LOCAL -Wno-#warnings +-Wno-#warnings (APPLE ONLY) @gol +@c APPLE LOCAL -Wextra-tokens 2001-08-02 --sts ** +-Wextra-tokens (APPLE ONLY) @gol +@c APPLE LOCAL -Wpragma-once 2001-08-01 --sts ** +-Wpragma-once (APPLE ONLY) @gol +@c APPLE LOCAL -Wnewline-eof 2001-08-23 --sts ** +-Wnewline-eof (APPLE ONLY) @gol +@c APPLE LOCAL -Wno-altivec-long-deprecated --ilr ** +-Wno-altivec-long-deprecated (APPLE ONLY) +@c APPLE LOCAL fwritable strings +-funsigned-bitfields -funsigned-char -fwritable-strings} @item C++ Language Options @xref{C++ Dialect Options,,Options Controlling C++ Dialect}. @@ -188,7 +232,7 @@ in the following sections. -Weffc++ -Wno-deprecated @gol -Wno-non-template-friend -Wold-style-cast @gol -Woverloaded-virtual -Wno-pmf-conversions @gol --Wsign-promo -Wsynth} +-Wsign-promo} @item Objective-C and Objective-C++ Language Options @xref{Objective-C and Objective-C++ Dialect Options,,Options Controlling @@ -197,11 +241,17 @@ Objective-C and Objective-C++ Dialects}. -fconstant-string-class=@var{class-name} @gol -fgnu-runtime -fnext-runtime @gol -fno-nil-receivers @gol +@c APPLE LOCAL ObjC C++ ivars +-fobjc-call-cxx-cdtors (APPLE ONLY) @gol -fobjc-exceptions @gol -freplace-objc-classes @gol -fzero-link @gol -gen-decls @gol --Wno-protocol -Wselector -Wundeclared-selector} +@c APPLE LOCAL begin Objective-C +-Wno-protocol -Wselector @gol +-Wstrict-selector-match @gol +-Wundeclared-selector} +@c APPLE LOCAL end Objective-C @item Language Independent Options @xref{Language Independent Options,,Options to Control Diagnostic Messages Formatting}. @@ -226,6 +276,8 @@ Objective-C and Objective-C++ Dialects}. -Wmain -Wmissing-braces -Wmissing-field-initializers @gol -Wmissing-format-attribute -Wmissing-include-dirs @gol -Wmissing-noreturn @gol +@c APPLE LOCAL -Wmost +-Wmost (APPLE ONLY) @gol -Wno-multichar -Wnonnull -Wpacked -Wpadded @gol -Wparentheses -Wpointer-arith -Wredundant-decls @gol -Wreturn-type -Wsequence-point -Wshadow @gol @@ -258,6 +310,11 @@ Objective-C and Objective-C++ Dialects}. -fdump-tree-ssa@r{[}-@var{n}@r{]} -fdump-tree-pre@r{[}-@var{n}@r{]} @gol -fdump-tree-ccp@r{[}-@var{n}@r{]} -fdump-tree-dce@r{[}-@var{n}@r{]} @gol -fdump-tree-gimple@r{[}-raw@r{]} -fdump-tree-mudflap@r{[}-@var{n}@r{]} @gol +@c APPLE LOCAL begin lno +-fdump-tree-scev @r{[}-@var{n}@r{]} @gol +-fdump-tree-ddall @r{[}-@var{n}@r{]}@gol +-fdump-tree-elck @r{[}-@var{n}@r{]} @gol +@c APPLE LOCAL end lno -fdump-tree-dom@r{[}-@var{n}@r{]} @gol -fdump-tree-dse@r{[}-@var{n}@r{]} @gol -fdump-tree-phiopt@r{[}-@var{n}@r{]} @gol @@ -266,6 +323,10 @@ Objective-C and Objective-C++ Dialects}. -fdump-tree-nrv -fdump-tree-vect @gol -fdump-tree-sra@r{[}-@var{n}@r{]} @gol -fdump-tree-fre@r{[}-@var{n}@r{]} @gol +@c APPLE LOCAL begin lno +-fdump-tree-loop@r{[}-@var{n}@r{]} @gol +-fdump-tree-vect@r{[}-@var{n}@r{]} @gol +@c APPLE LOCAL end lno -ftree-vectorizer-verbose=@var{n} @gol -feliminate-dwarf2-dups -feliminate-unused-debug-types @gol -feliminate-unused-debug-symbols -fmem-report -fprofile-arcs -ftree-based-profiling @gol @@ -285,8 +346,9 @@ Objective-C and Objective-C++ Dialects}. -fbounds-check -fmudflap -fmudflapth -fmudflapir @gol -fbranch-probabilities -fprofile-values -fvpt -fbranch-target-load-optimize @gol -fbranch-target-load-optimize2 -fbtr-bb-exclusive @gol --fcaller-saves -fcprop-registers @gol --fcse-follow-jumps -fcse-skip-blocks -fdata-sections @gol +@c APPLE LOCAL add fcreate-profile +-fcaller-saves -fcprop-registers -fcreate-profile -fcse-follow-jumps @gol +-fcse-skip-blocks -fcx-limited-range -fdata-sections @gol -fdelayed-branch -fdelete-null-pointer-checks @gol -fexpensive-optimizations -ffast-math -ffloat-store @gol -fforce-addr -fforce-mem -ffunction-sections @gol @@ -321,8 +383,14 @@ Objective-C and Objective-C++ Dialects}. -ftree-loop-linear -ftree-loop-im -ftree-loop-ivcanon -fivopts @gol -ftree-dominator-opts -ftree-dse -ftree-copyrename @gol -ftree-ch -ftree-sra -ftree-ter -ftree-lrs -ftree-fre -ftree-vectorize @gol +@c APPLE LOCAL add fuse-profile +-fuse-profile @gol +-fweb @gol +@c APPLE LOCAL lno +-fscalar-evolutions -fall-data-deps @gol --param @var{name}=@var{value} --O -O0 -O1 -O2 -O3 -Os} +@c APPLE LOCAL -fast +-O -O0 -O1 -O2 -O3 -Os -fast (APPLE ONLY)} @item Preprocessor Options @xref{Preprocessor Options,,Options Controlling the Preprocessor}. @@ -346,6 +414,8 @@ Objective-C and Objective-C++ Dialects}. @item Linker Options @xref{Link Options,,Options for Linking}. @gccoptlist{@var{object-file-name} -l@var{library} @gol +@c APPLE LOCAL radar 2466994 - -no-c++filt --ilr +-no-c++filt (APPLE ONLY) @gol -nostartfiles -nodefaultlibs -nostdlib -pie @gol -s -static -static-libgcc -shared -shared-libgcc -symbolic @gol -Wl,@var{option} -Xlinker @var{option} @gol @@ -366,6 +436,8 @@ Objective-C and Objective-C++ Dialects}. @c Try and put the significant identifier (CPU or system) first, @c so users have a clue at guessing where the ones they want will be. +@c APPLE LOCAL prune man page +@ignore @emph{ARC Options} @gccoptlist{-EB -EL @gol -mmangle-cpu -mcpu=@var{cpu} -mtext=@var{text-section} @gol @@ -406,6 +478,8 @@ Objective-C and Objective-C++ Dialects}. -m32-bit -m16-bit -m8-bit -mno-prologue-epilogue -mno-gotplt @gol -melf -maout -melinux -mlinux -sim -sim2 @gol -mmul-bug-workaround -mno-mul-bug-workaround} +@c APPLE LOCAL prune man page +@end ignore @emph{Darwin Options} @gccoptlist{-all_load -allowable_client -arch -arch_errors_fatal @gol @@ -432,6 +506,8 @@ Objective-C and Objective-C++ Dialects}. -unexported_symbols_list -weak_reference_mismatches @gol -whatsloaded -F -gused -gfull -mone-byte-bool} +@c APPLE LOCAL prune man page +@ignore @emph{DEC Alpha Options} @gccoptlist{-mno-fp-regs -msoft-float -malpha-as -mgas @gol -mieee -mieee-with-inexact -mieee-conformant @gol @@ -481,6 +557,8 @@ Objective-C and Objective-C++ Dialects}. -mpa-risc-1-1 -mpa-risc-2-0 -mportable-runtime @gol -mschedule=@var{cpu-type} -mspace-regs -msio -mwsio @gol -munix=@var{unix-std} -nolibdld -static -threads} +@c APPLE LOCAL prune man page +@end ignore @emph{i386 and x86-64 Options} @gccoptlist{-mtune=@var{cpu-type} -march=@var{cpu-type} @gol @@ -497,9 +575,11 @@ Objective-C and Objective-C++ Dialects}. -mcmodel=@var{code-model} @gol -m32 -m64} +@c APPLE LOCAL prune man page +@ignore @emph{IA-64 Options} @gccoptlist{-mbig-endian -mlittle-endian -mgnu-as -mgnu-ld -mno-pic @gol --mvolatile-asm-stop -mb-step -mregister-names -mno-sdata @gol +-mvolatile-asm-stop -mregister-names -mno-sdata @gol -mconstant-gp -mauto-pic -minline-float-divide-min-latency @gol -minline-float-divide-max-throughput @gol -minline-int-divide-min-latency @gol @@ -547,7 +627,7 @@ Objective-C and Objective-C++ Dialects}. -mxgot -mno-xgot -mgp32 -mgp64 -mfp32 -mfp64 @gol -mhard-float -msoft-float -msingle-float -mdouble-float @gol -mpaired-single -mips3d @gol --mint64 -mlong64 -mlong32 @gol +-mint64 -mlong64 -mlong32 -msym32 -mno-sym32 @gol -G@var{num} -membedded-data -mno-embedded-data @gol -muninit-const-in-rodata -mno-uninit-const-in-rodata @gol -msplit-addresses -mno-split-addresses @gol @@ -557,7 +637,8 @@ Objective-C and Objective-C++ Dialects}. -mmemcpy -mno-memcpy -mlong-calls -mno-long-calls @gol -mmad -mno-mad -mfused-madd -mno-fused-madd -nocpp @gol -mfix-r4000 -mno-fix-r4000 -mfix-r4400 -mno-fix-r4400 @gol --mfix-vr4120 -mno-fix-vr4120 -mfix-sb1 -mno-fix-sb1 @gol +-mfix-vr4120 -mno-fix-vr4120 -mfix-vr4130 @gol +-mfix-sb1 -mno-fix-sb1 @gol -mflush-func=@var{func} -mno-flush-func @gol -mbranch-likely -mno-branch-likely @gol -mfp-exceptions -mno-fp-exceptions @gol @@ -588,6 +669,8 @@ Objective-C and Objective-C++ Dialects}. -mfloat64 -mno-float32 -mabshi -mno-abshi @gol -mbranch-expensive -mbranch-cheap @gol -msplit -mno-split -munix-asm -mdec-asm} +@c APPLE LOCAL prune man page +@end ignore @emph{PowerPC Options} See RS/6000 and PowerPC Options. @@ -598,6 +681,8 @@ See RS/6000 and PowerPC Options. -mpower -mno-power -mpower2 -mno-power2 @gol -mpowerpc -mpowerpc64 -mno-powerpc @gol -maltivec -mno-altivec @gol +@c APPLE LOCAL AltiVec +-mpim-altivec -mno-pim-altivec @gol -mpowerpc-gpopt -mno-powerpc-gpopt @gol -mpowerpc-gfxopt -mno-powerpc-gfxopt @gol -mnew-mnemonics -mold-mnemonics @gol @@ -625,6 +710,8 @@ See RS/6000 and PowerPC Options. -msim -mmvme -mads -myellowknife -memb -msdata @gol -msdata=@var{opt} -mvxworks -mwindiss -G @var{num} -pthread} +@c APPLE LOCAL prune man page +@ignore @emph{S/390 and zSeries Options} @gccoptlist{-mtune=@var{cpu-type} -march=@var{cpu-type} @gol -mhard-float -msoft-float -mbackchain -mno-backchain @gol @@ -697,6 +784,8 @@ See i386 and x86-64 Options. @emph{zSeries Options} See S/390 and zSeries Options. +@c APPLE LOCAL prune man page +@end ignore @item Code Generation Options @xref{Code Gen Options,,Options for Code Generation Conventions}. @@ -797,6 +886,15 @@ C++ source code which must be preprocessed. Note that in @samp{.cxx}, the last two letters must both be literally @samp{x}. Likewise, @samp{.C} refers to a literal capital C@. +@c APPLE LOCAL begin Objective-C++ +@item @var{file}.mm +@itemx @var{file}.M +Objective-C++ source code which must be preprocessed. (APPLE ONLY) + +@item @var{file}.mii +Objective-C++ source code which should not be preprocessed. (APPLE ONLY) +@c APPLE LOCAL end Objective-C++ + @item @var{file}.hh @itemx @var{file}.H C++ header file to be turned into a precompiled header. @@ -843,7 +941,10 @@ package body). Such files are also called @dfn{bodies}. @c @var{file}.pas @item @var{file}.s -Assembler code. +@c APPLE LOCAL begin preprocess .s files +Assembler code. Apple's version of GCC runs the preprocessor +on these files as well as those ending in @samp{.S}. +@c APPLE LOCAL end preprocess .s files @item @var{file}.S Assembler code which must be preprocessed. @@ -880,6 +981,27 @@ Turn off any specification of a language, so that subsequent files are handled according to their file name suffixes (as they are if @option{-x} has not been used at all). +@c APPLE LOCAL begin -ObjC 2001-08-03 --sts ** +@item -ObjC +@item -ObjC++ +@opindex ObjC +@opindex ObjC++ +These are similar in effect to @option{-x objective-c} and @option{-x +objective-c++}, but affect only the choice of compiler for files already +identified as source files. (APPLE ONLY) +@c APPLE LOCAL end -ObjC 2001-08-03 --sts ** + +@c APPLE LOCAL begin fat builds +@item -arch @var{arch} +Compile for the specified target architecture @var{arch}. The allowable +values are @samp{i386} and @samp{ppc}. Multiple options work, and +direct the compiler to produce ``fat'' binaries including object code +for each architecture specified with @option{-arch}. This option only +works if assembler and libraries are available for each architecture +specified. (APPLE ONLY) +@opindex arch +@c APPLE LOCAL end fat builds + @item -pass-exit-codes @opindex pass-exit-codes Normally the @command{gcc} program will exit with the code of 1 if any @@ -1102,7 +1224,7 @@ ISO C90 as modified in amendment 1. @itemx iso9899:1999 @itemx iso9899:199x ISO C99. Note that this standard is not yet fully supported; see -@w{@uref{http://gcc.gnu.org/c99status.html}} for more information. The +@w{@uref{http://gcc.gnu.org/gcc-4.0/c99status.html}} for more information. The names @samp{c9x} and @samp{iso9899:199x} are deprecated. @item gnu89 @@ -1150,6 +1272,20 @@ character). In the case of function definitions, a K&R-style list of arguments followed by their declarations is also provided, inside comments, after the declaration. +@c APPLE LOCAL begin AltiVec +@item -faltivec +This flag is provided for compatibility with Metrowerks CodeWarrior and MrC +compilers as well as previous Apple versions of GCC. It causes the +@option{-mpim-altivec} option to be turned on. +@c APPLE LOCAL end AltiVec + +@c APPLE LOCAL begin CW asm blocks +@item -fasm-blocks +Enable the use of blocks and entire functions of assembly code within +a C or C++ file. The syntax follows that used in CodeWarrior. (APPLE +ONLY) +@c APPLE LOCAL end CW asm blocks + @item -fno-asm @opindex fno-asm Do not recognize @code{asm}, @code{inline} or @code{typeof} as a @@ -1268,6 +1404,41 @@ Allow conditional expressions with mismatched types in the second and third arguments. The value of such an expression is void. This option is not supported for C++. +@c APPLE LOCAL begin pch distcc --mrs +@item -fpch-preprocess +@opindex fpch-preprocess +Enable PCH processing even when @option{-E} or @option{-save-temps} is used. +@c APPLE LOCAL end pch distcc --mrs + +@c APPLE LOCAL begin non lvalue assign +@item -fnon-lvalue-assign +@item fnon-lvalue-assign +C and C++ forbid the use of casts and conditional expressions as lvalues, e.g.: + +@smallexample +float *p, q, r; +((int *)p)++; +(cond ? q : r) = 3.0; +@end smallexample + +@noindent +As a transitional measure, the Apple version of GCC 4.0 allows casts and +conditional expressions to be used as lvalues in certain situations. This +is accomplished via the @option{-fnon-lvalue-assign} switch, which is on +by default. Whenever an lvalue cast or an lvalue conditional expression is +encountered, the compiler will issue a deprecation warning and then rewrite +the expression as follows: + +@smallexample +(type)expr ---becomes---> *(type *)&expr +cond ? expr1 : expr2 ---becomes---> *(cond ? &expr1 : &expr2) +@end smallexample + +To disallow lvalue casts and lvalue conditional expressions altogether, +specify @option{-fno-non-lvalue-assign}; lvalue casts and lvalue conditional +expressions will be disallowed in future versions of Apple's GCC. +@c APPLE LOCAL end non lvalue assign + @item -funsigned-char @opindex funsigned-char Let the type @code{char} be unsigned, like @code{unsigned char}. @@ -1307,6 +1478,36 @@ These options control whether a bit-field is signed or unsigned, when the declaration does not use either @code{signed} or @code{unsigned}. By default, such a bit-field is signed, because this is consistent: the basic integer types such as @code{int} are signed types. + +@c APPLE LOCAL begin constant cfstrings +@item -fconstant-cfstrings +@opindex fconstant-cfstrings +Enable the automatic creation of a CoreFoundation-type constant string +whenever a special builtin @code{__builtin__CFStringMakeConstantString} +is called on a literal string. (APPLE ONLY) +@c APPLE LOCAL end constant cfstrings + +@c APPLE LOCAL begin pascal strings +@item -fpascal-strings +Allow Pascal-style string literals to be constructed. (APPLE ONLY) + +@xref{Pascal Strings,,Constructing String Literals with a Pascal-style +Length Byte}, for more information on the syntax and semantics of Pascal +string literals. +@c APPLE LOCAL end pascal strings + +@c APPLE LOCAL begin fwritable strings. +@item -fwritable-strings +@opindex fwritable-strings +Store string constants in the writable data segment and don't uniquize +them. This is for compatibility with old programs which assume they can +write into string constants. + +Writing into string constants is a very bad idea; ``constants'' should +be constant. + +This option is deprecated. +@c APPLE LOCAL end fwritable strings. @end table @node C++ Dialect Options @@ -1378,7 +1579,10 @@ been added for putting variables into BSS without making them common. Give string constants type @code{char *} instead of type @code{const char *}. By default, G++ uses type @code{const char *} as required by the standard. Even if you use @option{-fno-const-strings}, you cannot -actually modify the value of a string constant. +@c APPLE LOCAL begin fwritable strings. +actually modify the value of a string constant, unless you also use +@option{-fwritable-strings}. +@c APPLE LOCAL end fwritable strings. This option might be removed in a future release of G++. For maximum portability, you should structure your code so that it works with @@ -1508,6 +1712,8 @@ Register destructors for objects with static storage duration with the This option is required for fully standards-compliant handling of static destructors, but will only work if your C library supports @code{__cxa_atexit}. +@c APPLE LOCAL manual +This option is not supported on Mac OS X. @item -fvisibility-inlines-hidden @opindex fvisibility-inlines-hidden @@ -1790,13 +1996,6 @@ enumerated type to a signed type, over a conversion to an unsigned type of the same size. Previous versions of G++ would try to preserve unsignedness, but the standard mandates the current behavior. -@item -Wsynth @r{(C++ only)} -@opindex Wsynth -@cindex warning for synthesized methods -@cindex synthesized methods, warning -Warn when G++'s synthesis behavior does not match that of cfront. For -instance: - @smallexample struct A @{ operator int (); @@ -1877,6 +2076,32 @@ is not @code{nil}. This allows for more efficient entry points in the runtime to be used. Currently, this option is only available in conjunction with the NeXT runtime on Mac OS X 10.3 and later. +@c APPLE LOCAL begin ObjC C++ ivars +@item -fobjc-call-cxx-cdtors +@opindex fobjc-call-cxx-cdtors +For each Objective-C class, check if any of its instance variables is a +C++ object with a non-trivial default constructor. If so, synthesize a +special @code{- (id) .cxx_construct} instance method that will run +non-trivial default constructors on any such instance variables, in order, +and then return @code{self}. Similarly, check if any instance variable +is a C++ object with a non-trivial destructor, and if so, synthesize a +special @code{- (void) .cxx_destruct} method that will run +all such default destructors, in reverse order. + +The @code{- (id) .cxx_construct} and/or @code{- (void) .cxx_destruct} methods +thusly generated will only operate on instance variables declared in the +current Objective-C class, and not those inherited from superclasses. It +is the responsibility of the Objective-C runtime to invoke all such methods +in an object's inheritance hierarchy. The @code{- (id) .cxx_construct} methods +will be invoked by the runtime immediately after a new object +instance is allocated; the @code{- (void) .cxx_destruct} methods will +be invoked immediately before the runtime deallocates an object instance. + +As of this writing, only the NeXT runtime on Mac OS X 10.4 and later has +support for invoking the @code{- (id) .cxx_construct} and +@code{- (void) .cxx_destruct} methods. +@c APPLE LOCAL end ObjC C++ ivars + @item -fobjc-exceptions @opindex fobjc-exceptions Enable syntactic support for structured exception handling in Objective-C, @@ -2018,6 +2243,17 @@ stage of compilation is not reached, for example because an error is found during compilation, or because the @option{-fsyntax-only} option is being used. +@c APPLE LOCAL begin Objective-C +@item -Wstrict-selector-match +@opindex Wstrict-selector-match +Warn if multiple methods with differing argument and/or return types are +found for a given selector when attempting to send a message using this +selector to a receiver of type @code{id} or @code{Class}. When this flag +is off (which is the default behavior), the compiler will omit such warnings +if any differences found are confined to types which share the same size +and alignment. +@c APPLE LOCAL end Objective-C + @item -Wundeclared-selector @opindex Wundeclared-selector Warn if a @code{@@selector(@dots{})} expression referring to an @@ -2161,6 +2397,37 @@ Inhibit all warning messages. @opindex Wno-import Inhibit warning messages about the use of @samp{#import}. +@c APPLE LOCAL begin -Wno-#warnings +@item -Wno-#warnings +@opindex Wno-#warnings +Inhibit warning messages issued by @samp{#warning}. +@c APPLE LOCAL end -Wno-#warnings + +@c APPLE LOCAL begin -Wpragma-once 2001-08-01 --sts ** +@item -Wpragma-once +@opindex Wpragma-once +Warn about the use of @samp{#pragma once}. (APPLE ONLY) +@c APPLE LOCAL end -Wpragma-once 2001-08-01 --sts ** + +@c APPLE LOCAL begin -Wextra-tokens 2001-08-02 --sts ** +@item -Wextra-tokens +@opindex Wextra-tokens +Warn about extra tokens at the end of prepreprocessor directives. (APPLE ONLY) +@c APPLE LOCAL end -Wextra-tokens 2001-08-02 --sts ** + +@c APPLE LOCAL begin -Wnewline-eof 2001-08-23 --sts ** +@item -Wnewline-eof +@opindex Wnewline-eof +Warn about files missing a newline at the end of the file. (APPLE ONLY) +@c APPLE LOCAL end -Wnewline-eof 2001-08-23 --sts ** + +@c APPLE LOCAL begin -Wno-altivec-long-deprecated --ilr ** +@item -Wno-altivec-long-deprecated +@opindex Wno-altivec-long-deprecated +Do not warn about the use of the deprecated 'long' keyword in +AltiVec data types. (APPLE ONLY) +@c APPLE LOCAL end -Wno-altivec-long-deprecated --ilr ** + @item -Wchar-subscripts @opindex Wchar-subscripts Warn if an array subscript has type @code{char}. This is a common cause @@ -2638,7 +2905,12 @@ that are easy to avoid (or modify to prevent the warning), even in conjunction with macros. This also enables some language-specific warnings described in @ref{C++ Dialect Options} and @ref{Objective-C and Objective-C++ Dialect Options}. +@c APPLE LOCAL begin -Wmost +@item -Wmost +@opindex Wmost +This is equivalent to -Wall -Wno-parentheses. (APPLE ONLY) @end table +@c APPLE LOCAL end -Wmost The following @option{-W@dots{}} options are not implied by @option{-Wall}. Some of them warn about constructions that users generally do not @@ -2777,6 +3049,13 @@ would check to see whether the two values have ranges that overlap; and this is done with the relational operators, so equality comparisons are probably mistaken. +@c APPLE LOCAL begin -Wfour-char-constants +@item -Wfour-char-constants +@opindex Wfour-char-constants +Warn about four char constants, e.g. OSType 'APPL'. This warning is +disabled by default. +@c APPLE LOCAL end + @item -Wtraditional @r{(C only)} @opindex Wtraditional Warn about certain constructs that behave differently in traditional and @@ -2941,6 +3220,12 @@ converted to an unsigned type. For example, warn about the assignment @code{x = -1} if @code{x} is unsigned. But do not warn about explicit casts like @code{(unsigned) -1}. +@c APPLE LOCAL begin 64bit shorten warning 3865314 +@item -Wshorten-64-to-32 +@opindex Wshorten-64-to-32 +Warn if a value is implicitly converted from a 64 bit type to a 32 bit type. +@c APPLE LOCAL end 64bit shorten warning 3865314 */ + @item -Wsign-compare @opindex Wsign-compare @cindex warning for comparison of signed and unsigned values @@ -3031,9 +3316,60 @@ appropriate may not be detected. This option has no effect unless @item -Wno-multichar @opindex Wno-multichar @opindex Wmultichar -Do not warn if a multicharacter constant (@samp{'FOOF'}) is used. +@c APPLE LOCAL begin -Wfour-char-constants +Do not warn if a multicharacter constant (@samp{'FOO'}) is used. Usually they indicate a typo in the user's code, as they have implementation-defined values, and should not be used in portable code. +This flag does not control warning for a constant with four characters, +use -Wfour-char-constants instead. +@c APPLE LOCAL end -Wfour-char-constants + +@c APPLE LOCAL begin mainline UCNs 2005-04-17 3892809 +@item -Wnormalized=<none|id|nfc|nfkc> +@opindex Wnormalized +@cindex NFC +@cindex NFKC +@cindex character set, input normalization +In ISO C and ISO C++, two identifiers are different if they are +different sequences of characters. However, sometimes when characters +outside the basic ASCII character set are used, you can have two +different character sequences that look the same. To avoid confusion, +the ISO 10646 standard sets out some @dfn{normalization rules} which +when applied ensure that two sequences that look the same are turned into +the same sequence. GCC can warn you if you are using identifiers which +have not been normalized; this option controls that warning. + +There are four levels of warning that GCC supports. The default is +@option{-Wnormalized=nfc}, which warns about any identifier which is +not in the ISO 10646 ``C'' normalized form, @dfn{NFC}. NFC is the +recommended form for most uses. + +Unfortunately, there are some characters which ISO C and ISO C++ allow +in identifiers that when turned into NFC aren't allowable as +identifiers. That is, there's no way to use these symbols in portable +ISO C or C++ and have all your identifiers in NFC. +@option{-Wnormalized=id} suppresses the warning for these characters. +It is hoped that future versions of the standards involved will correct +this, which is why this option is not the default. + +You can switch the warning off for all characters by writing +@option{-Wnormalized=none}. You would only want to do this if you +were using some other normalization scheme (like ``D''), because +otherwise you can easily create bugs that are literally impossible to see. + +Some characters in ISO 10646 have distinct meanings but look identical +in some fonts or display methodologies, especially once formatting has +been applied. For instance @code{\u207F}, ``SUPERSCRIPT LATIN SMALL +LETTER N'', will display just like a regular @code{n} which has been +placed in a superscript. ISO 10646 defines the @dfn{NFKC} +normalisation scheme to convert all these into a standard form as +well, and GCC will warn if your code is not in NFKC if you use +@option{-Wnormalized=nfkc}. This warning is comparable to warning +about every identifier that contains the letter O because it might be +confused with the digit 0, and so is not the default, but may be +useful as a local coding convention if the programming environment is +unable to be fixed to display these characters distinctly. +@c APPLE LOCAL end mainline UCNs 2005-04-17 3892809 @item -Wno-deprecated-declarations @opindex Wno-deprecated-declarations @@ -3190,8 +3526,10 @@ debugging information that only GDB can use; this extra information makes debugging work better in GDB but will probably make other debuggers crash or refuse to read the program. If you want to control for certain whether -to generate the extra information, use @option{-gstabs+}, @option{-gstabs}, -@option{-gxcoff+}, @option{-gxcoff}, or @option{-gvms} (see below). +@c APPLE LOCAL begin prune man page +to generate the extra information, use @option{-gstabs+} or @option{-gstabs} +(see below). +@c APPLE LOCAL end prune man page GCC allows you to use @option{-g} with @option{-O}. The shortcuts taken by optimized code may occasionally @@ -3234,6 +3572,8 @@ using GNU extensions understood only by the GNU debugger (GDB)@. The use of these extensions is likely to make other debuggers crash or refuse to read the program. +@c APPLE LOCAL prune man page +@ignore @item -gcoff @opindex gcoff Produce debugging information in COFF format (if that is supported). @@ -3252,6 +3592,8 @@ using GNU extensions understood only by the GNU debugger (GDB)@. The use of these extensions is likely to make other debuggers crash or refuse to read the program, and may cause assemblers other than the GNU assembler (GAS) to fail with an error. +@c APPLE LOCAL prune man page +@end ignore @item -gdwarf-2 @opindex gdwarf-2 @@ -3261,17 +3603,27 @@ option, GCC uses features of DWARF version 3 when they are useful; version 3 is upward compatible with version 2, but may still cause problems for older debuggers. +@c APPLE LOCAL begin prune man page +(Other debug formats, such as @option{-gcoff}, are not supported in +Darwin or Mac OS X.) +@ignore @item -gvms @opindex gvms Produce debugging information in VMS debug format (if that is supported). This is the format used by DEBUG on VMS systems. +@end ignore +@c APPLE LOCAL end prune man page @item -g@var{level} @itemx -ggdb@var{level} @itemx -gstabs@var{level} +@c APPLE LOCAL prune man page +@ignore @itemx -gcoff@var{level} @itemx -gxcoff@var{level} @itemx -gvms@var{level} +@c APPLE LOCAL prune man page +@end ignore Request debugging information and also use @var{level} to specify how much information. The default level is 2. @@ -3838,6 +4190,24 @@ appending @file{.dce} to the source file name. Dump each function after adding mudflap instrumentation. The file name is made by appending @file{.mudflap} to the source file name. +@c APPLE LOCAL begin lno +@item scev +@opindex fdump-tree-scev +Dump the information gathered by the scalar evolution analyzer. +The file name is made by appending @file{.scev} to the source file name. + +@item ddall +@opindex fdump-tree-ddall +Dump all the data dependence relations. +The file name is made by appending @file{.ddall} to the source file name. + +@item elck +@opindex fdump-tree-elck +Dump each function after performing checks elimination based on scalar +evolution informations. The file name is made by appending +@file{.elck} to the source file name. +@c APPLE LOCAL end lno + @item sra @opindex fdump-tree-sra Dump each function after performing scalar replacement of aggregates. The @@ -3874,6 +4244,13 @@ Dump each function after applying the named return value optimization on generic trees. The file name is made by appending @file{.nrv} to the source file name. +@c APPLE LOCAL begin lno +@item loop +@opindex fdump-tree-loop +Dump each function after applying tree-level loop optimizations. The file +name is made by appending @file{.loop} to the source file name. +@c APPLE LOCAL end lno + @item vect @opindex fdump-tree-vect Dump each function after applying vectorization of loops. The file name is @@ -4093,7 +4470,7 @@ compilation time. -ftree-dom @gol -ftree-dse @gol -ftree-ter @gol --ftree-live_range_split @gol +-ftree-lrs @gol -ftree-sra @gol -ftree-copyrename @gol -ftree-fre @gol @@ -4138,6 +4515,12 @@ also turns on the following optimization flags: Please note the warning under @option{-fgcse} about invoking @option{-O2} on programs that use computed gotos. +@c APPLE LOCAL begin optimization +In Apple's version of GCC, @option{-fstrict-aliasing}, +@option{-freorder-blocks}, and @option{-fsched-interblock} +are disabled by default when optimizing. +@c APPLE LOCAL end optimization + @item -O3 @opindex O3 Optimize yet more. @option{-O3} turns on all optimizations specified by @@ -4148,6 +4531,52 @@ Optimize yet more. @option{-O3} turns on all optimizations specified by @opindex O0 Do not optimize. This is the default. +@c APPLE LOCAL begin -fast +@item -fast +@opindex fast +Optimize for maximum performance. @option{-fast} changes the overall optimization +strategy of GCC in order to produce the fastest possible running code for PPC7450 +and G5 architectures. By default, @option{-fast} optimizes for G5. Programs +optimized for G5 will not run on PPC7450. To optimize for PPC7450, add +@option{-mcpu=7450} on command line. + +@option{-fast} currently enables the following optimization flags (for G5 and PPC7450). +These flags may change in the future. You cannot override any of these options if you use +@option{-fast} except by setting @option{-mcpu=7450}. + +To build shared libraries with @option{-fast}, specify @option{-fPIC} on command line. + +@gccoptlist{-O3 +-fgcse-sm +-funroll-loops +-fstrict-aliasing +-fsched-interblock +-falign-loops=16 +-falign-jumps=16 +-falign-functions=16 +-falign-jumps-max-skip=15 +-falign-loops-max-skip=15 +-malign-natural +-ffast-math +-freorder-blocks +-freorder-blocks-and-partition +-finline-floor +-mdynamic-no-pic +-mpowerpc-gpopt +-force_cpusubtype_ALL +-fstrict-aliasing +-mtune=G5 +-mcpu=G5 +-mpowerpc64} + +Important notes: @option{-ffast-math} results in code that is not necessarily +IEEE-compliant. @option{-fstrict-aliasing} is highly likely break +non-standard-compliant programs. @option{-malign-natural} only works properly if +the entire program is compiled with it, and none of the standard headers/libraries +contain any code that changes alignment when this option is used. + +@c APPLE LOCAL end -fast + @item -Os @opindex Os Optimize for size. @option{-Os} enables all @option{-O2} optimizations that @@ -4158,6 +4587,15 @@ optimizations designed to reduce code size. @gccoptlist{-falign-functions -falign-jumps -falign-loops @gol -falign-labels -freorder-blocks -freorder-blocks-and-partition -fprefetch-loop-arrays} +@c APPLE LOCAL begin Disable string insns with -Os on Darwin (radar 3509006) +When compiling for Apple powerPC targets, -Os disables use of the string +instructions even though they would usually be smaller, because +the kernel can't emulate them correctly in some rare cases. +This behavior is not portable to any other gcc environment, and will +not affect most programs at all. If you really want the string instructions, +use -mstring. +@c APPLE LOCAL end Disable string insns with -Os on Darwin (radar 3509006) + If you use multiple @option{-O} options, with or without level numbers, the last such option is the one that is effective. @end table @@ -4697,6 +5135,12 @@ effectiveness of code motion optimizations. It also saves one jump. This flag is enabled by default at @option{-O} and higher. It is not enabled for @option{-Os}, since it usually increases code size. +@c APPLE LOCAL begin lno +@item -ftree-elim-checks +Perform elimination of checks based on scalar evolution informations. +This flag is disabled by default. +@c APPLE LOCAL end lno + @item -ftree-loop-optimize Perform loop optimizations on trees. This flag is enabled by default at @option{-O} and higher. @@ -4705,15 +5149,15 @@ at @option{-O} and higher. Perform linear loop transformations on tree. This flag can improve cache performance and allow further loop optimizations to take place. -@item -ftree-lim -Perform loop invariant motion on trees. This pass moves only invartiants that +@item -ftree-loop-im +Perform loop invariant motion on trees. This pass moves only invariants that would be hard to handle on rtl level (function calls, operations that expand to nontrivial sequences of insns). With @option{-funswitch-loops} it also moves operands of conditions that are invariant out of the loop, so that we can use just trivial invariantness analysis in loop unswitching. The pass also includes store motion. -@item -fivcanon +@item -ftree-loop-ivcanon Create a canonical counter for number of iterations in the loop for that determining number of iterations requires complicated analysis. Later optimizations then may determine the number easily. Useful especially @@ -4749,6 +5193,12 @@ optimization later. This is enabled by default at @option{-O} and higher. @item -ftree-vectorize Perform loop vectorization on trees. +@c APPLE LOCAL begin optimization +In Apple's version of GCC, @option{-fstrict-aliasing} is enabled by default +when loop vectorization is enabled. See @option{-fstrict-aliasing} document +for more information. +@c APPLE LOCAL end optimization + @item -ftracer @opindex ftracer Perform tail duplication to enlarge superblock size. This transformation @@ -5072,7 +5522,8 @@ them to store all pertinent intermediate computations into variables. @opindex ffast-math Sets @option{-fno-math-errno}, @option{-funsafe-math-optimizations}, @* @option{-fno-trapping-math}, @option{-ffinite-math-only}, -@option{-fno-rounding-math} and @option{-fno-signaling-nans}. +@option{-fno-rounding-math}, @option{-fno-signaling-nans} +and @option{fcx-limited-range}. This option causes the preprocessor macro @code{__FAST_MATH__} to be defined. @@ -5088,12 +5539,19 @@ with a single instruction, e.g., sqrt. A program that relies on IEEE exceptions for math error handling may want to use this flag for speed while maintaining IEEE arithmetic compatibility. +@c APPLE LOCAL begin disable math-errno +@ignore This option should never be turned on by any @option{-O} option since it can result in incorrect output for programs which depend on an exact implementation of IEEE or ISO rules/specifications for math functions. The default is @option{-fmath-errno}. +@end ignore +(APPLE ONLY) The Darwin math libraries never set errno, so there is +no point in having the compiler generate code that assumes they +might. Therefore, the default is @option{-fno-math-errno} on Darwin. +@c APPLE LOCAL end disable math-errno @item -funsafe-math-optimizations @opindex funsafe-math-optimizations @@ -5176,6 +5634,17 @@ disable all GCC optimizations that affect signaling NaN behavior. Treat floating point constant as single precision constant instead of implicitly converting it to double precision constant. +@item -fcx-limited-range +@itemx -fno-cx-limited-range +@opindex fcx-limited-range +@opindex fno-cx-limited-range +When enabled, this option states that a range reduction step is not +needed when performing complex division. The default is +@option{-fno-cx-limited-range}, but is enabled by @option{-ffast-math}. + +This option controls the default setting of the ISO C99 +@code{CX_LIMITED_RANGE} pragma. Nevertheless, the option applies to +all languages. @end table @@ -5430,7 +5899,7 @@ This number sets the maximum number of instructions (counted in GCC's internal representation) in a single function that the tree inliner will consider for inlining. This only affects functions declared inline and methods implemented in a class declaration (C++). -The default value is 500. +The default value is 450. @item max-inline-insns-auto When you use @option{-finline-functions} (included in @option{-O3}), @@ -5438,7 +5907,7 @@ a lot of functions that would otherwise not be considered for inlining by the compiler will be investigated. To those functions, a different (more restrictive) limit compared to functions declared inline can be applied. -The default value is 120. +The default value is 90. @item large-function-insns The limit specifying really large functions. For functions larger than this @@ -5447,7 +5916,7 @@ limit after inlining inlining is constrained by to avoid extreme compilation time caused by non-linear algorithms used by the backend. This parameter is ignored when @option{-funit-at-a-time} is not used. -The default value is 3000. +The default value is 2700. @item large-function-growth Specifies maximal growth of large function caused by inlining in percents. @@ -5470,7 +5939,7 @@ For functions declared inline @option{--param max-inline-insns-recursive} is taken into acount. For function not declared inline, recursive inlining happens only when @option{-finline-functions} (included in @option{-O3}) is enabled and @option{--param max-inline-insns-recursive-auto} is used. The -default value is 500. +default value is 450. @item max-inline-recursive-depth @itemx max-inline-recursive-depth-auto @@ -5480,7 +5949,16 @@ For functions declared inline @option{--param max-inline-recursive-depth} is taken into acount. For function not declared inline, recursive inlining happens only when @option{-finline-functions} (included in @option{-O3}) is enabled and @option{--param max-inline-recursive-depth-auto} is used. The -default value is 500. +default value is 450. + +@item inline-call-cost +Specify cost of call instruction relative to simple arithmetics operations +(having cost of 1). Increasing this cost disqualify inlinining of non-leaf +functions and at same time increase size of leaf function that is believed to +reduce function size by being inlined. In effect it increase amount of +inlining for code having large abstraction penalty (many functions that just +pass the argumetns to other functions) and decrease inlining for code with low +abstraction penalty. Default value is 16. @item max-unrolled-insns The maximum number of instructions that a loop should have if that loop @@ -5748,6 +6226,15 @@ These options come into play when the compiler links object files into an executable output file. They are meaningless if the compiler is not doing a link step. +@c APPLE LOCAL begin linker flags +In addition to the options listed below, Apple's GCC also accepts and +passes nearly all of the options defined by the linker @samp{ld} and by +the library tool @samp{libtool}. Common options include +@samp{-framework}, @samp{-dynamic}, @samp{-bundle}, +@samp{-flat_namespace}, and so forth. See the ld and libtool man pages +for further details. +@c APPLE LOCAL end linker flags + @table @gcctabopt @cindex file names @item @var{object-file-name} @@ -5819,6 +6306,12 @@ These entries are usually resolved by entries in libc. These entry points should be supplied through some other mechanism when this option is specified. +@c APPLE LOCAL begin radar 2466994 - -no-c++filt --ilr +@item -no-c++filt +By default all linker diagnostic output is piped through c++filt. +This option suppresses that behavior. (APPLE ONLY) +@c APPLE LOCAL end radar 2466994 - -no-c++filt --ilr + @item -nostdlib @opindex nostdlib Do not use the standard system startup files or libraries when linking. @@ -5866,6 +6359,13 @@ Remove all symbol table and relocation information from the executable. On systems that support dynamic linking, this prevents linking with the shared libraries. On other systems, this option has no effect. +@c APPLE LOCAL begin manual +This option will not work on Mac OS X unless all libraries (including +@file{libgcc.a}) have also been compiled with @option{-static}. Since +neither a static version of libSystem.dylib nor crt0.o are provided, this +option is not useful to most people. +@c APPLE LOCAL end manual + @item -shared @opindex shared Produce a shared object which can then be linked with other objects to @@ -5879,6 +6379,10 @@ libraries to link against. Failing to supply the correct flags may lead to subtle defects. Supplying them in cases where they are not necessary is innocuous.} +@c APPLE LOCAL begin manual +This option is not supported on Mac OS X. +@c APPLE LOCAL end manual + @item -shared-libgcc @itemx -static-libgcc @opindex shared-libgcc @@ -6373,11 +6877,6 @@ Dump out a @option{-L} option for each directory that GCC believes might contain startup files. If the target supports multilibs then the current multilib directory will be prepended to each of these paths. -@item %M -Output the multilib directory with directory separators replaced with -@samp{_}. If multilib directories are not set, or the multilib directory is -@file{.} then this option emits nothing. - @item %L Process the @code{lib} spec. This is a spec string for deciding which libraries should be included on the command line to the linker. @@ -6642,17 +7141,27 @@ that macro, which enables you to change the defaults. @c in Machine Dependent Options @menu +@c APPLE LOCAL prune man page +@ignore * ARC Options:: * ARM Options:: * AVR Options:: * CRIS Options:: +@c APPLE LOCAL prune man page +@end ignore * Darwin Options:: +@c APPLE LOCAL prune man page +@ignore * DEC Alpha Options:: * DEC Alpha/VMS Options:: * FRV Options:: * H8/300 Options:: * HPPA Options:: +@c APPLE LOCAL prune man page +@end ignore * i386 and x86-64 Options:: +@c APPLE LOCAL prune man page +@ignore * IA-64 Options:: * M32R/D Options:: * M680x0 Options:: @@ -6663,8 +7172,12 @@ that macro, which enables you to change the defaults. * MN10300 Options:: * NS32K Options:: * PDP-11 Options:: +@c APPLE LOCAL prune man page +@end ignore * PowerPC Options:: * RS/6000 and PowerPC Options:: +@c APPLE LOCAL prune man page +@ignore * S/390 and zSeries Options:: * SH Options:: * SPARC Options:: @@ -6676,8 +7189,12 @@ that macro, which enables you to change the defaults. * Xstormy16 Options:: * Xtensa Options:: * zSeries Options:: +@c APPLE LOCAL prune man page +@end ignore @end menu +@c APPLE LOCAL prune man page +@ignore @node ARC Options @subsection ARC Options @cindex ARC Options @@ -6746,7 +7263,8 @@ leaf functions. The default is @option{-mno-apcs-frame}. @opindex mapcs This is a synonym for @option{-mapcs-frame}. -@ignore +@c APPLE LOCAL We already have ignore running -- do not do this one --bowdidge +@c @ignore @c not currently implemented @item -mapcs-stack-check @opindex mapcs-stack-check @@ -6773,7 +7291,8 @@ size if @option{-mapcs-float} is used. @opindex mapcs-reentrant Generate reentrant, position independent code. The default is @option{-mno-apcs-reentrant}. -@end ignore +@c APPLE LOCAL We already have ignore running -- do not do this one --bowdidge +@c @end ignore @item -mthumb-interwork @opindex mthumb-interwork @@ -7239,6 +7758,8 @@ initialized data and zero-initialized data are allocated consecutively. Like @option{-sim}, but pass linker options to locate initialized data at 0x40000000 and zero-initialized data at 0x80000000. @end table +@c APPLE LOCAL prune man page +@end ignore @node Darwin Options @subsection Darwin Options @@ -7259,7 +7780,7 @@ The subtype of the file created (like @samp{ppc7400} or @samp{ppc970} or that GCC is targetting, like @option{-mcpu} or @option{-march}. The @option{-force_cpusubtype_ALL} option can be used to override this. -The Darwin tools vary in their behaviour when presented with an ISA +The Darwin tools vary in their behavior when presented with an ISA mismatch. The assembler, @file{as}, will only permit instructions to be used that are valid for the subtype of the file it is generating, so you cannot put 64-bit instructions in an @samp{ppc750} object file. @@ -7333,6 +7854,32 @@ enable gdb to dynamically load @code{.o} files into already running programs. @option{-findirect-data} and @option{-ffix-and-continue} are provided for backwards compatibility. +@c APPLE LOCAL KEXT +@item -fapple-kext +@c APPLE LOCAL KEXT indirect-virtual-calls --sts +@itemx -findirect-virtual-calls +@c APPLE LOCAL KEXT terminated-vtables +@itemx -fterminated-vtables +@c APPLE LOCAL KEXT +@opindex fapple-kext +@c APPLE LOCAL KEXT indirect-virtual-calls --sts +@opindex findirect-virtual-calls +@c APPLE LOCAL KEXT terminated-vtables +@opindex fterminated-vtables +@c APPLE LOCAL begin KEXT +Alter vtables, destructors, and other implementation details to more +closely resemble the GCC 2.95 ABI. This is to make kernel extensions +loadable by Darwin kernels, and is required to build any Darwin kernel +extension. In addition, virtual calls are not made directly, instead, +code is generated to always go through the virtual table, as virtual +tables can be patched by the kernel module loader. Vtables are +altered by adding a zero word at the end of every vtable. +@option{-fno-exceptions} and @option{-static} must also be used with +this flag. @option{-findirect-virtual-calls} and +@option{-fterminated-vtables} are accepted for backwards compatibility +but will be removed in the future. (APPLE ONLY) +@c APPLE LOCAL end KEXT + @item -all_load @opindex all_load Loads all members of static archive libraries. @@ -7490,6 +8037,8 @@ These options are passed to the Darwin linker. The Darwin linker man page describes them in detail. @end table +@c APPLE LOCAL prune man page +@ignore @node DEC Alpha Options @subsection DEC Alpha Options @@ -8382,6 +8931,8 @@ Add support for multithreading with the @dfn{dce thread} library under HP-UX@. This option sets flags for both the preprocessor and linker. @end table +@c APPLE LOCAL prune man page +@end ignore @node i386 and x86-64 Options @subsection Intel 386 and AMD x86-64 Options @@ -8822,6 +9373,8 @@ about addresses and sizes of sections. Currently GCC does not implement this model. @end table +@c APPLE LOCAL prune man page +@ignore @node IA-64 Options @subsection IA-64 Options @cindex IA-64 Options @@ -8866,10 +9419,6 @@ is not position independent code, and violates the IA-64 ABI@. Generate (or don't) a stop bit immediately before and after volatile asm statements. -@item -mb-step -@opindex mb-step -Generate code that works around Itanium B step errata. - @item -mregister-names @itemx -mno-register-names @opindex mregister-names @@ -9657,6 +10206,15 @@ uses 64-bit @code{long}s, as does the 64-bit EABI; the others use 32-bit @code{long}s. Pointers are the same size as @code{long}s, or the same size as integer registers, whichever is smaller. +@item -msym32 +@itemx -mno-sym32 +@opindex msym32 +@opindex mno-sym32 +Assume (do not assume) that all symbols have 32-bit values, regardless +of the selected ABI@. This option is useful in combination with +@option{-mabi=64} and @option{-mno-abicalls} because it allows GCC +to generate shorter and faster references to symbolic addresses. + @item -G @var{num} @opindex G @cindex smaller data references (MIPS) @@ -9689,7 +10247,7 @@ This option is only meaningful in conjunction with @option{-membedded-data}. @opindex msplit-addresses @opindex mno-split-addresses Enable (disable) use of the @code{%hi()} and @code{%lo()} assembler -relocation operators. This option has been superceded by +relocation operators. This option has been superseded by @option{-mexplicit-relocs} but is retained for backwards compatibility. @item -mexplicit-relocs @@ -9817,6 +10375,14 @@ the @code{mips64vr*-elf} configurations. Other VR4120 errata require a nop to be inserted between certain pairs of instructions. These errata are handled by the assembler, not by GCC itself. +@item -mfix-vr4130 +@opindex mfix-vr4130 +Work around the VR4130 @code{mflo}/@code{mfhi} errata. The +workarounds are implemented by the assembler rather than by GCC, +although GCC will avoid using @code{mflo} and @code{mfhi} if the +VR4130 @code{macc}, @code{macchi}, @code{dmacc} and @code{dmacchi} +instructions are available instead. + @item -mfix-sb1 @itemx -mno-fix-sb1 @opindex mfix-sb1 @@ -10242,6 +10808,8 @@ Use Unix assembler syntax. This is the default when configured for Use DEC assembler syntax. This is the default when configured for any PDP-11 target other than @samp{pdp11-*-bsd}. @end table +@c APPLE LOCAL prune man page +@end ignore @node PowerPC Options @subsection PowerPC Options @@ -10351,7 +10919,7 @@ Supported values for @var{cpu_type} are @samp{401}, @samp{403}, @samp{601}, @samp{602}, @samp{603}, @samp{603e}, @samp{604}, @samp{604e}, @samp{620}, @samp{630}, @samp{740}, @samp{7400}, @samp{7450}, @samp{750}, @samp{801}, @samp{821}, @samp{823}, -@samp{860}, @samp{970}, @samp{common}, @samp{ec603e}, @samp{G3}, +@samp{860}, @samp{970}, @samp{8540}, @samp{common}, @samp{ec603e}, @samp{G3}, @samp{G4}, @samp{G5}, @samp{power}, @samp{power2}, @samp{power3}, @samp{power4}, @samp{power5}, @samp{powerpc}, @samp{powerpc64}, @samp{rios}, @samp{rios1}, @samp{rios2}, @samp{rsc}, and @samp{rs64a}. @@ -10410,6 +10978,35 @@ the AltiVec instruction set. You may also need to set @option{-mabi=altivec} to adjust the current ABI with AltiVec ABI enhancements. +@c APPLE LOCAL begin AltiVec +@item -mpim-altivec +@itemx -mno-pim-altivec +@opindex mpim-altivec +@opindex mno-pim-altivec +Enable (or disable) built-in compiler support for the syntactic extensions as +well as operations and predicates defined in the Motorola AltiVec +Technology Programming Interface Manual (PIM). This includes the +recognition of @code{vector} and @code{pixel} as (context-dependent) +keywords, the definition of built-in functions such as @code{vec_add}, +and the use of parenthesized comma expression as AltiVec literals. +Note that unlike the option @option{-maltivec}, the extension does not require +the inclusion of any special header files; if @code{<altivec.h>} is included, +a warning will be issued and the contents of the header will be +ignored. The preprocessor shall provide an @code{__APPLE_ALTIVEC__} +manifest constant when @option{-mpim-altivec} is specified. (APPLE ONLY) + +In addition, the @option{-mpim-altivec} option disables the inlining of +functions containing AltiVec instructions into functions that do not make +use of the vector unit. Certain other optimizations, such as inline +vectorization of @code{memset} and @code{memcpy} calls, are also disabled. +These adjustments make it possible to compile programs whose use of AltiVec +instructions is preceded by a run-time check for the presence of AltiVec +functionality, and that can therefore be made to run on G3 processors. +Note that all of these optimizations may be re-enabled by supplying +the @option{-maltivec} option, or an @option{-mcpu} option specifying +a processor that supports AltiVec instructions. +@c APPLE LOCAL end AltiVec + @item -mabi=spe @opindex mabi=spe Extend the current ABI with SPE ABI extensions. This does not change @@ -10537,12 +11134,15 @@ option are incompatible. @itemx -malign-power @opindex malign-natural @opindex malign-power -On AIX, Darwin, and 64-bit PowerPC GNU/Linux, the option +On AIX, 32-bit Darwin, and 64-bit PowerPC GNU/Linux, the option @option{-malign-natural} overrides the ABI-defined alignment of larger types, such as floating-point doubles, on their natural size-based boundary. The option @option{-malign-power} instructs GCC to follow the ABI-specified alignment rules. GCC defaults to the standard alignment defined in the ABI@. +On 64-bit Darwin, natural alignment is the default, and @option{-malign-power} +is not supported. + @item -msoft-float @itemx -mhard-float @opindex msoft-float @@ -10551,6 +11151,16 @@ Generate code that does not use (uses) the floating-point register set. Software floating point emulation is provided if you use the @option{-msoft-float} option, and pass the option to GCC when linking. +@c APPLE LOCAL begin describe actual behavior 3888787 +(APPLE ONLY) While the -msoft-float option is supported, the libraries that +do the floating point emulation are not shipped on Apple PowerPCs, with the +effect that the emulation does not work. However, the option +may be useful for a different reason. Normally the compiler can use floating +point registers in contexts where you might not expect it, for example, to +copy data from one memory location to another. The -msoft-float option will +prevent it from doing this. +@c APPLE LOCAL end describe actual behavior 3888787 + @item -mmultiple @itemx -mno-multiple @opindex mmultiple @@ -10925,6 +11535,8 @@ This option sets flags for both the preprocessor and linker. @end table +@c APPLE LOCAL prune man page +@ignore @node S/390 and zSeries Options @subsection S/390 and zSeries Options @cindex S/390 and zSeries Options @@ -11445,7 +12057,7 @@ on SPARC-V9 processors in 64-bit environments: @item -mlittle-endian @opindex mlittle-endian Generate code for a processor running in little-endian mode. It is only -available for a few configurations and most notably not on Solaris. +available for a few configurations and most notably not on Solaris and Linux. @item -m32 @itemx -m64 @@ -11929,6 +12541,8 @@ every cross-file call, not just those that really will be out of range. @cindex zSeries options These are listed under @xref{S/390 and zSeries Options}. +@c APPLE LOCAL prune man page +@end ignore @node Code Gen Options @section Options for Code Generation Conventions @@ -12127,6 +12741,10 @@ only on certain machines. For the 386, GCC supports PIC for System V but not for the Sun 386i. Code generated for the IBM RS/6000 is always position-independent. +@c APPLE LOCAL begin manual +@option{-fpic} is not supported on Mac OS X. +@c APPLE LOCAL end manual + @item -fPIC @opindex fPIC If supported for the target machine, emit position-independent code, @@ -12137,6 +12755,10 @@ PowerPC and SPARC@. Position-independent code requires special support, and therefore works only on certain machines. +@c APPLE LOCAL begin manual +@option{-fPIC} is the default on Darwin and Mac OS X. +@c APPLE LOCAL end manual + @item -fpie @itemx -fPIE @opindex fpie diff --git a/gcc/doc/md.texi b/gcc/doc/md.texi index a2b992e4323..d3312f75bc5 100644 --- a/gcc/doc/md.texi +++ b/gcc/doc/md.texi @@ -4678,9 +4678,9 @@ an equality comparison of a register and a large constant: (set (match_dup 0) (compare:CC (match_dup 3) (match_dup 5)))] " @{ - /* Get the constant we are comparing against, C, and see what it + /* @r{Get the constant we are comparing against, C, and see what it looks like sign-extended to 16 bits. Then see what constant - could be XOR'ed with C to get the sign-extended value. */ + could be XOR'ed with C to get the sign-extended value.} */ int c = INTVAL (operands[2]); int sextc = (c << 16) >> 16; diff --git a/gcc/doc/objc.texi b/gcc/doc/objc.texi index 481b51c09b8..795e281f726 100644 --- a/gcc/doc/objc.texi +++ b/gcc/doc/objc.texi @@ -56,7 +56,7 @@ FileStream *Stderr = nil; Stderr = [[FileStream new] initWithFd:2]; @} -/* Other methods here */ +/* @r{Other methods here} */ @@end @end smallexample @@ -84,7 +84,7 @@ method instead of @code{+initialize}: Stderr = [[FileStream new] initWithFd:2]; @} -/* Other methods here */ +/* @r{Other methods here} */ @@end @end smallexample diff --git a/gcc/doc/sourcebuild.texi b/gcc/doc/sourcebuild.texi index f4927e80382..6712d046988 100644 --- a/gcc/doc/sourcebuild.texi +++ b/gcc/doc/sourcebuild.texi @@ -1269,7 +1269,7 @@ failures for a test run against the list of expected failures in Update this file when adding new failing tests to Mauve, or when fixing bugs in libgcj that had caused Mauve test failures. -The @uref{http://oss.software.ibm.com/developerworks/opensource/jacks/,, +The @uref{http://sources.redhat.com/mauve/,, Jacks} project provides a testsuite for Java compilers that can be used to test changes that affect the GCJ front end. This testsuite is run as part of Java testing by placing the Jacks tree within the the libjava @@ -1321,8 +1321,8 @@ kind. A command @code{branch(end)} or @code{returns(end)} marks the end of a range without starting a new one. For example: @smallexample -if (i > 10 && j > i && j < 20) /* branch(27 50 75) */ - /* branch(end) */ +if (i > 10 && j > i && j < 20) /* @r{branch(27 50 75)} */ + /* @r{branch(end)} */ foo (i, j); @end smallexample diff --git a/gcc/doc/standards.texi b/gcc/doc/standards.texi index c2418defd8d..2a439ad3014 100644 --- a/gcc/doc/standards.texi +++ b/gcc/doc/standards.texi @@ -79,7 +79,7 @@ as @dfn{AMD1}; the amended standard is sometimes known as @dfn{C94} or A new edition of the ISO C standard was published in 1999 as ISO/IEC 9899:1999, and is commonly known as @dfn{C99}. GCC has incomplete support for this standard version; see -@uref{http://gcc.gnu.org/c99status.html} for details. To select this +@uref{http://gcc.gnu.org/gcc-4.0/c99status.html} for details. To select this standard, use @option{-std=c99} or @option{-std=iso9899:1999}. (While in development, drafts of this standard version were referred to as @dfn{C9X}.) diff --git a/gcc/doc/tm.texi b/gcc/doc/tm.texi index c14ce5d5248..06c0168f84f 100644 --- a/gcc/doc/tm.texi +++ b/gcc/doc/tm.texi @@ -31,7 +31,6 @@ through the macros defined in the @file{.h} file. * Per-Function Data:: Defining data structures for per-function information. * Storage Layout:: Defining sizes and alignments of data. * Type Layout:: Defining sizes and properties of basic user data types. -* Escape Sequences:: Defining the value of target character escape sequences * Registers:: Naming and describing the hardware registers. * Register Classes:: Defining the classes of hardware registers. * Stack and Calling:: Defining which way the stack grows and by how much. @@ -413,20 +412,10 @@ while the @file{config/rs6000/eabiaix.h} target file defines @end smallexample @end defmac -@defmac LINK_LIBGCC_SPECIAL -Define this macro if the driver program should find the library -@file{libgcc.a} itself and should not pass @option{-L} options to the -linker. If you do not define this macro, the driver program will pass -the argument @option{-lgcc} to tell the linker to do the search and will -pass @option{-L} options to it. -@end defmac - @defmac LINK_LIBGCC_SPECIAL_1 Define this macro if the driver program should find the library @file{libgcc.a}. If you do not define this macro, the driver program will pass the argument @option{-lgcc} to tell the linker to do the search. -This macro is similar to @code{LINK_LIBGCC_SPECIAL}, except that it does -not affect @option{-L} options. @end defmac @defmac LINK_GCC_C_SEQUENCE_SPEC @@ -860,7 +849,7 @@ checking the state of the option (documentation is elided for brevity). @smallexample [chip.c] -char *chip_alu = ""; /* Specify default here. */ +char *chip_alu = ""; /* @r{Specify default here.} */ [chip.h] extern char *chip_alu; @@ -1646,6 +1635,36 @@ the target machine. If you don't define this, the default is two words. @end defmac +@defmac LIBGCC2_LONG_DOUBLE_TYPE_SIZE +Define this macro if @code{LONG_DOUBLE_TYPE_SIZE} is not constant or +if you want routines in @file{libgcc2.a} for a size other than +@code{LONG_DOUBLE_TYPE_SIZE}. If you don't define this, the +default is @code{LONG_DOUBLE_TYPE_SIZE}. +@end defmac + +@defmac LIBGCC2_HAS_DF_MODE +Define this macro if neither @code{LIBGCC2_DOUBLE_TYPE_SIZE} nor +@code{LIBGCC2_LONG_DOUBLE_TYPE_SIZE} is +@code{DFmode} but you want @code{DFmode} routines in @file{libgcc2.a} +anyway. If you don't define this and either @code{LIBGCC2_DOUBLE_TYPE_SIZE} +or @code{LIBGCC2_LONG_DOUBLE_TYPE_SIZE} is 64 then the default is 1, +otherwise it is 0. +@end defmac + +@defmac LIBGCC2_HAS_XF_MODE +Define this macro if @code{LIBGCC2_LONG_DOUBLE_TYPE_SIZE} is not +@code{XFmode} but you want @code{XFmode} routines in @file{libgcc2.a} +anyway. If you don't define this and @code{LIBGCC2_LONG_DOUBLE_TYPE_SIZE} +is 80 then the default is 1, otherwise it is 0. +@end defmac + +@defmac LIBGCC2_HAS_TF_MODE +Define this macro if @code{LIBGCC2_LONG_DOUBLE_TYPE_SIZE} is not +@code{TFmode} but you want @code{TFmode} routines in @file{libgcc2.a} +anyway. If you don't define this and @code{LIBGCC2_LONG_DOUBLE_TYPE_SIZE} +is 128 then the default is 1, otherwise it is 0. +@end defmac + @defmac TARGET_FLT_EVAL_METHOD A C expression for the value for @code{FLT_EVAL_METHOD} in @file{float.h}, assuming, if applicable, that the floating-point control word is in its @@ -1816,42 +1835,6 @@ specified by @code{TARGET_VTABLE_ENTRY_ALIGN}), set this to the number of words in each data entry. @end defmac -@node Escape Sequences -@section Target Character Escape Sequences -@cindex escape sequences - -By default, GCC assumes that the C character escape sequences and other -characters take on their ASCII values for the target. If this is not -correct, you must explicitly define all of the macros below. All of -them must evaluate to constants; they are used in @code{case} -statements. - -@findex TARGET_BELL -@findex TARGET_BS -@findex TARGET_CR -@findex TARGET_DIGIT0 -@findex TARGET_ESC -@findex TARGET_FF -@findex TARGET_NEWLINE -@findex TARGET_TAB -@findex TARGET_VT -@multitable {@code{TARGET_NEWLINE}} {Escape} {ASCII character} -@item Macro @tab Escape @tab ASCII character -@item @code{TARGET_BELL} @tab @kbd{\a} @tab @code{07}, @code{BEL} -@item @code{TARGET_BS} @tab @kbd{\b} @tab @code{08}, @code{BS} -@item @code{TARGET_CR} @tab @kbd{\r} @tab @code{0D}, @code{CR} -@item @code{TARGET_DIGIT0} @tab @kbd{0} @tab @code{30}, @code{ZERO} -@item @code{TARGET_ESC} @tab @kbd{\e}, @kbd{\E} @tab @code{1B}, @code{ESC} -@item @code{TARGET_FF} @tab @kbd{\f} @tab @code{0C}, @code{FF} -@item @code{TARGET_NEWLINE} @tab @kbd{\n} @tab @code{0A}, @code{LF} -@item @code{TARGET_TAB} @tab @kbd{\t} @tab @code{09}, @code{HT} -@item @code{TARGET_VT} @tab @kbd{\v} @tab @code{0B}, @code{VT} -@end multitable - -@noindent -Note that the @kbd{\e} and @kbd{\E} escapes are GNU extensions, not -part of the C standard. - @node Registers @section Register Usage @cindex register usage @@ -2931,6 +2914,18 @@ length of the outgoing arguments. The default is correct for most machines. See @file{function.c} for details. @end defmac +@defmac INITIAL_FRAME_ADDRESS_RTX +A C expression whose value is RTL representing the address of the initial + stack frame. This address is passed to @code{RETURN_ADDR_RTX} and +@code{DYNAMIC_CHAIN_ADDRESS}. +If you don't define this macro, the default is to return +@code{hard_frame_pointer_rtx}. +This default is usually correct unless @code{-fomit-frame-pointer} is in +effect. +Define this macro in order to make @code{__builtin_frame_address (0)} and +@code{__builtin_return_address (0)} work even in absence of a hard frame pointer. +@end defmac + @defmac DYNAMIC_CHAIN_ADDRESS (@var{frameaddr}) A C expression whose value is RTL representing the address in a stack frame where the pointer to the caller's frame is stored. Assume that @@ -4837,7 +4832,7 @@ This macro should evaluate to @code{true} if the integer comparison functions (like @code{__cmpdi2}) return 0 to indicate that the first operand is smaller than the second, 1 to indicate that they are equal, and 2 to indicate that the first operand is greater than the second. -If this macro evalutes to @code{false} the comparison functions return +If this macro evaluates to @code{false} the comparison functions return @minus{}1, 0, and 1 instead of 0, 1, and 2. If the target uses the routines in @file{libgcc.a}, you do not need to define this macro. @end defmac diff --git a/gcc/doc/tree-ssa.texi b/gcc/doc/tree-ssa.texi index cef4212c05d..6aba70bbe9b 100644 --- a/gcc/doc/tree-ssa.texi +++ b/gcc/doc/tree-ssa.texi @@ -685,7 +685,7 @@ void f() The optimizers need to associate attributes with statements and variables during the optimization process. For instance, we need to -know what basic block does a statement belong to or whether a variable +know what basic block a statement belongs to or whether a variable has aliases. All these attributes are stored in data structures called annotations which are then linked to the field @code{ann} in @code{struct tree_common}. @@ -938,14 +938,14 @@ tree FOR_EACH_SSA_TREE_OPERAND @file{tree-ssa-operands.h}: @smallexample -#define SSA_OP_USE 0x01 /* Real USE operands. */ -#define SSA_OP_DEF 0x02 /* Real DEF operands. */ -#define SSA_OP_VUSE 0x04 /* VUSE operands. */ -#define SSA_OP_VMAYUSE 0x08 /* USE portion of V_MAY_DEFS. */ -#define SSA_OP_VMAYDEF 0x10 /* DEF portion of V_MAY_DEFS. */ -#define SSA_OP_VMUSTDEF 0x20 /* V_MUST_DEF definitions. */ - -/* These are commonly grouped operand flags. */ +#define SSA_OP_USE 0x01 /* @r{Real USE operands.} */ +#define SSA_OP_DEF 0x02 /* @r{Real DEF operands.} */ +#define SSA_OP_VUSE 0x04 /* @r{VUSE operands.} */ +#define SSA_OP_VMAYUSE 0x08 /* @r{USE portion of V_MAY_DEFS.} */ +#define SSA_OP_VMAYDEF 0x10 /* @r{DEF portion of V_MAY_DEFS.} */ +#define SSA_OP_VMUSTDEF 0x20 /* @r{V_MUST_DEF definitions.} */ + +/* @r{These are commonly grouped operand flags.} */ #define SSA_OP_VIRTUAL_USES (SSA_OP_VUSE | SSA_OP_VMAYUSE) #define SSA_OP_VIRTUAL_DEFS (SSA_OP_VMAYDEF | SSA_OP_VMUSTDEF) #define SSA_OP_ALL_USES (SSA_OP_VIRTUAL_USES | SSA_OP_USE) diff --git a/gcc/doc/trouble.texi b/gcc/doc/trouble.texi index 01c0c192d59..1cfc212f5ed 100644 --- a/gcc/doc/trouble.texi +++ b/gcc/doc/trouble.texi @@ -275,15 +275,19 @@ string its argument points to. @cindex @code{sscanf}, and constant strings @cindex @code{fscanf}, and constant strings @cindex @code{scanf}, and constant strings -Another consequence is that @code{sscanf} does not work on some very -old systems when passed a string constant as its format control string -or input. This is because @code{sscanf} incorrectly tries to write -into the string constant. Likewise @code{fscanf} and @code{scanf}. - -The solution to these problems is to change the program to use +@c APPLE LOCAL begin fwritable strings. +Another consequence is that @code{sscanf} does not work on some systems +when passed a string constant as its format control string or input. +This is because @code{sscanf} incorrectly tries to write into the string +constant. Likewise @code{fscanf} and @code{scanf}. + +@opindex fwritable-strings +The best solution to these problems is to change the program to use @code{char}-array variables with initialization strings for these -purposes instead of string constants. - +purposes instead of string constants. But if this is not possible, +you can use the @option{-fwritable-strings} flag, which directs GCC +to handle string constants the same way most C compilers do. +@c APPLE LOCAL end fwritable strings. @item @code{-2147483648} is positive. |