diff options
Diffstat (limited to 'gcc/gcc.texi')
| -rw-r--r-- | gcc/gcc.texi | 535 |
1 files changed, 265 insertions, 270 deletions
diff --git a/gcc/gcc.texi b/gcc/gcc.texi index 16828160c32..9c1f4505b05 100644 --- a/gcc/gcc.texi +++ b/gcc/gcc.texi @@ -47,15 +47,15 @@ @ifset INTERNALS @ifset USING -@settitle Using and Porting GNU CC +@settitle Using and Porting the GNU Compiler Collection (GCC) @end ifset @end ifset @c seems reasonable to assume at least one of INTERNALS or USING is set... @ifclear INTERNALS -@settitle Using GNU CC +@settitle Using the GNU Compiler Collection @end ifclear @ifclear USING -@settitle Porting GNU CC +@settitle Porting the GNU Compiler Collection @end ifclear @syncodeindex fn cp @@ -82,7 +82,7 @@ @ifinfo @dircategory Programming @direntry -* gcc: (gcc). The GNU C compiler. +* gcc: (gcc). The GNU Compiler Collection. @end direntry @ifset INTERNALS @ifset USING @@ -100,7 +100,7 @@ Published by the Free Software Foundation 59 Temple Place - Suite 330 Boston, MA 02111-1307 USA -Copyright (C) 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998 Free Software Foundation, Inc. +Copyright (C) 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000 Free Software Foundation, Inc. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice @@ -133,29 +133,29 @@ instead of in the original English. @titlepage @ifset INTERNALS @ifset USING -@center @titlefont{Using and Porting GNU CC} +@center @titlefont{Using and Porting the GNU Compiler Collection} @end ifset @end ifset @ifclear INTERNALS -@title Using GNU CC +@title Using the GNU Compiler Collection @end ifclear @ifclear USING -@title Porting GNU CC +@title Porting the GNU Compiler Collection @end ifclear @sp 2 @center Richard M. Stallman @sp 3 -@center Last updated 16 March 1998 +@center Last updated 28 July 1999 @sp 1 @c The version number appears five times more in this file. -@center for egcs-1.1 +@center for gcc-2.95 @page @vskip 0pt plus 1filll -Copyright @copyright{} 1988, 89, 92, 93, 94, 95, 96, 98 Free Software Foundation, Inc. +Copyright @copyright{} 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1998, 1999 Free Software Foundation, Inc. @sp 2 -For EGCS Version 1.0@* +For GCC Version 2.95@* @sp 1 Published by the Free Software Foundation @* 59 Temple Place - Suite 330@* @@ -194,19 +194,19 @@ instead of in the original English. @ifset USING This manual documents how to run, install and port the GNU compiler, as well as its new features and incompatibilities, and how to -report bugs. It corresponds to EGCS version 1.0. +report bugs. It corresponds to GCC version 2.95. @end ifset @end ifset @ifclear INTERNALS This manual documents how to run and install the GNU compiler, as well as its new features and incompatibilities, and how to report -bugs. It corresponds to EGCS version 1.0. +bugs. It corresponds to GCC version 2.95. @end ifclear @ifclear USING This manual documents how to port the GNU compiler, as well as its new features and incompatibilities, and how to report -bugs. It corresponds to EGCS version 1.0. +bugs. It corresponds to GCC version 2.95. @end ifclear @end ifinfo @@ -214,19 +214,19 @@ bugs. It corresponds to EGCS version 1.0. @ifset USING * G++ and GCC:: You can compile C or C++ programs. * Invoking GCC:: Command options supported by @samp{gcc}. -* Installation:: How to configure, compile and install GNU CC. +* Installation:: How to configure, compile and install GCC. * C Extensions:: GNU extensions to the C language family. * C++ Extensions:: GNU extensions to the C++ language. -* Gcov:: gcov: a GNU CC test coverage program. -* Trouble:: If you have trouble installing GNU CC. +* Gcov:: gcov: a GCC test coverage program. +* Trouble:: If you have trouble installing GCC. * Bugs:: How, why and where to report bugs. -* Service:: How to find suppliers of support for GNU CC. -* Contributing:: How to contribute to testing and developing GNU CC. -* VMS:: Using GNU CC on VMS. +* Service:: How to find suppliers of support for GCC. +* Contributing:: How to contribute to testing and developing GCC. +* VMS:: Using GCC on VMS. @end ifset @ifset INTERNALS -* Portability:: Goals of GNU CC's portability features. -* Interface:: Function-call interface of GNU CC output. +* Portability:: Goals of GCC's portability features. +* Interface:: Function-call interface of GCC output. * Passes:: Order of passes, what they do, and what each file is for. * RTL:: The intermediate representation that most passes work on. * Machine Desc:: How to write machine description instruction patterns. @@ -239,24 +239,27 @@ bugs. It corresponds to EGCS version 1.0. * GNU/Linux:: Linux and the GNU Project * Copying:: GNU General Public License says - how you can copy and share GNU CC. -* Contributors:: People who have contributed to GNU CC. + how you can copy and share GCC. +* Contributors:: People who have contributed to GCC. * Index:: Index of concepts and symbol names. @end menu @ifset USING @node G++ and GCC -@chapter Compile C, C++, or Objective C +@chapter Compile C, C++, Objective C, or Fortran @cindex Objective C -The C, C++, and Objective C versions of the compiler are integrated; the -GNU C compiler can compile programs written in C, C++, or Objective C. +The C, C++, and Objective C, and Fortran versions of the compiler are +integrated; this is why we use the name ``GNU Compiler Collection''. +GCC can compile programs written in C, C++, Objective C, or Fortran. +The Fortran compiler is described in a separate manual. @cindex GCC -``GCC'' is a common shorthand term for the GNU C compiler. This is both +``GCC'' is a common shorthand term for the GNU Compiler Collection. This is both the most general name for the compiler, and the name used when the -emphasis is on compiling C programs. +emphasis is on compiling C programs (as the abbreviation formerly +stood for ``GNU C Compiler''). @cindex C++ @cindex G++ @@ -265,20 +268,20 @@ When referring to C++ compilation, it is usual to call the compiler it ``GCC'' no matter what the language context; however, the term ``G++'' is more useful when the emphasis is on compiling C++ programs. -We use the name ``GNU CC'' to refer to the compilation system as a +We use the name ``GCC'' to refer to the compilation system as a whole, and more specifically to the language-independent part of the compiler. For example, we refer to the optimization options as -affecting the behavior of ``GNU CC'' or sometimes just ``the compiler''. +affecting the behavior of ``GCC'' or sometimes just ``the compiler''. Front ends for other languages, such as Ada 9X, Fortran, Modula-3, and Pascal, are under development. These front-ends, like that for C++, are -built in subdirectories of GNU CC and link to it. The result is an +built in subdirectories of GCC and link to it. The result is an integrated compiler that can compile programs written in C, C++, Objective C, or any of the languages for which you have installed front ends. In this manual, we only discuss the options for the C, Objective-C, and -C++ compilers and those of the GNU CC core. Consult the documentation +C++ compilers and those of the GCC core. Consult the documentation of the other front ends for the options to use when compiling programs written in other languages. @@ -308,13 +311,13 @@ give you comprehensive C++ source-level editing capabilities @include gcov.texi @node Trouble -@chapter Known Causes of Trouble with GNU CC +@chapter Known Causes of Trouble with GCC @cindex bugs, known @cindex installation trouble @cindex known causes of trouble -This section describes known problems that affect users of GNU CC. Most -of these are not GNU CC bugs per se---if they were, we would fix them. +This section describes known problems that affect users of GCC. Most +of these are not GCC bugs per se---if they were, we would fix them. But the result for a user may be like the result of a bug. Some of these problems are due to bugs in other software, some are @@ -323,12 +326,12 @@ where people's opinions differ as to what is best. @menu * Actual Bugs:: Bugs we will fix later. -* Installation Problems:: Problems that manifest when you install GNU CC. -* Cross-Compiler Problems:: Common problems of cross compiling with GNU CC. -* Interoperation:: Problems using GNU CC with other compilers, +* Installation Problems:: Problems that manifest when you install GCC. +* Cross-Compiler Problems:: Common problems of cross compiling with GCC. +* Interoperation:: Problems using GCC with other compilers, and with certain linkers, assemblers and debuggers. * External Bugs:: Problems compiling certain programs. -* Incompatibilities:: GNU CC is incompatible with traditional C. +* Incompatibilities:: GCC is incompatible with traditional C. * Fixed Headers:: GNU C uses corrected versions of system header files. This is necessary, but doesn't always work smoothly. * Standard Libraries:: GNU C uses the system C library, which might not be @@ -363,7 +366,7 @@ There are several obscure case of mis-using struct, union, and enum tags that are not detected as errors by the compiler. @item -When @samp{-pedantic-errors} is specified, GNU C will incorrectly give +When @samp{-pedantic-errors} is specified, GCC will incorrectly give an error message when a function name is specified in an expression involving the comma operator. @@ -393,19 +396,19 @@ directory. Make sure you have done all the necessary preparations. @xref{Other Dir}. @item -If you build GNU CC on a BSD system using a directory stored in a System +If you build GCC on a BSD system using a directory stored in a System V file system, problems may occur in running @code{fixincludes} if the System V file system doesn't support symbolic links. These problems result in a failure to fix the declaration of @code{size_t} in @file{sys/types.h}. If you find that @code{size_t} is a signed type and that type mismatches occur, this could be the cause. -The solution is not to use such a directory for building GNU CC. +The solution is not to use such a directory for building GCC. @item -In previous versions of GNU CC, the @code{gcc} driver program looked for +In previous versions of GCC, the @code{gcc} driver program looked for @code{as} and @code{ld} in various places; for example, in files -beginning with @file{/usr/local/lib/gcc-}. GNU CC version 2 looks for +beginning with @file{/usr/local/lib/gcc-}. GCC version 2 looks for them in the directory @file{/usr/local/lib/gcc-lib/@var{target}/@var{version}}. @@ -433,12 +436,12 @@ the compiler. In one case, this was traced down to a bug in @item If you have installed a program known as purify, you may find that it causes errors while linking @code{enquire}, which is part of building -GNU CC. The fix is to get rid of the file @code{real-ld} which purify -installs---so that GNU CC won't try to use it. +GCC. The fix is to get rid of the file @code{real-ld} which purify +installs---so that GCC won't try to use it. @item On GNU/Linux SLS 1.01, there is a problem with @file{libc.a}: it does not -contain the obstack functions. However, GNU CC assumes that the obstack +contain the obstack functions. However, GCC assumes that the obstack functions are in @file{libc.a} when it is the GNU C library. To work around this problem, change the @code{__GNU_LIBRARY__} conditional around line 31 to @samp{#if 1}. @@ -447,7 +450,7 @@ around line 31 to @samp{#if 1}. On some 386 systems, building the compiler never finishes because @code{enquire} hangs due to a hardware problem in the motherboard---it reports floating point exceptions to the kernel incorrectly. You can -install GNU CC except for @file{float.h} by patching out the command to +install GCC except for @file{float.h} by patching out the command to run @code{enquire}. You may also be able to fix the problem for real by getting a replacement motherboard. This problem was observed in Revision E of the Micronics motherboard, and is fixed in Revision F. @@ -459,7 +462,7 @@ are running SCO Unix, you can reboot and force the FPU to be ignored. To do this, type @samp{hd(40)unix auto ignorefpu}. @item -On some 386 systems, GNU CC crashes trying to compile @file{enquire.c}. +On some 386 systems, GCC crashes trying to compile @file{enquire.c}. This happens on machines that don't have a 387 FPU chip. On 386 machines, the system kernel is supposed to emulate the 387 when you don't have one. The crash is due to a bug in the emulator. @@ -490,48 +493,48 @@ enquire.c:2328: floating overflow @end example @item -On SCO systems, when compiling GNU CC with the system's compiler, +On SCO systems, when compiling GCC with the system's compiler, do not use @samp{-O}. Some versions of the system's compiler miscompile -GNU CC with @samp{-O}. +GCC with @samp{-O}. @cindex @code{genflags}, crash on Sun 4 @item Sometimes on a Sun 4 you may observe a crash in the program -@code{genflags} or @code{genoutput} while building GNU CC. This is said to +@code{genflags} or @code{genoutput} while building GCC. This is said to be due to a bug in @code{sh}. You can probably get around it by running @code{genflags} or @code{genoutput} manually and then retrying the @code{make}. @item -On Solaris 2, executables of GNU CC version 2.0.2 are commonly +On Solaris 2, executables of GCC version 2.0.2 are commonly available, but they have a bug that shows up when compiling current -versions of GNU CC: undefined symbol errors occur during assembly if you +versions of GCC: undefined symbol errors occur during assembly if you use @samp{-g}. -The solution is to compile the current version of GNU CC without +The solution is to compile the current version of GCC without @samp{-g}. That makes a working compiler which you can use to recompile with @samp{-g}. @item Solaris 2 comes with a number of optional OS packages. Some of these -packages are needed to use GNU CC fully. If you did not install all +packages are needed to use GCC fully. If you did not install all optional packages when installing Solaris, you will need to verify that -the packages that GNU CC needs are installed. +the packages that GCC needs are installed. To check whether an optional package is installed, use the @code{pkginfo} command. To add an optional package, use the @code{pkgadd} command. For further details, see the Solaris documentation. -For Solaris 2.0 and 2.1, GNU CC needs six packages: @samp{SUNWarc}, +For Solaris 2.0 and 2.1, GCC needs six packages: @samp{SUNWarc}, @samp{SUNWbtool}, @samp{SUNWesu}, @samp{SUNWhea}, @samp{SUNWlibm}, and @samp{SUNWtoo}. -For Solaris 2.2, GNU CC needs an additional seventh package: @samp{SUNWsprot}. +For Solaris 2.2, GCC needs an additional seventh package: @samp{SUNWsprot}. @item On Solaris 2, trying to use the linker and other tools in -@file{/usr/ucb} to install GNU CC has been observed to cause trouble. +@file{/usr/ucb} to install GCC has been observed to cause trouble. For example, the linker may hang indefinitely. The fix is to remove @file{/usr/ucb} from your @code{PATH}. @@ -555,7 +558,7 @@ optional, and there should not be a warning about their absence. @item In Ultrix 4.0 on the MIPS machine, @file{stdio.h} does not work with GNU CC at all unless it has been fixed with @code{fixincludes}. This causes -problems in building GNU CC. Once GNU CC is installed, the problems go +problems in building GCC. Once GCC is installed, the problems go away. To work around this problem, when making the stage 1 compiler, specify @@ -585,7 +588,7 @@ Some versions of the MIPS linker will issue an assertion failure when linking code that uses @code{alloca} against shared libraries on RISC-OS 5.0, and DEC's OSF/1 systems. This is a bug in the linker, that is supposed to be fixed in future revisions. -To protect against this, GNU CC passes @samp{-non_shared} to the +To protect against this, GCC passes @samp{-non_shared} to the linker unless you pass an explicit @samp{-shared} or @samp{-call_shared} switch. @@ -618,7 +621,7 @@ On System V, if you get an error like this, that too indicates a problem with disk space, ULIMIT, or @code{MAXUMEM}. @item -Current GNU CC versions probably do not work on version 2 of the NeXT +Current GCC versions probably do not work on version 2 of the NeXT operating system. @item @@ -628,7 +631,7 @@ does not happen on 3.1. @item On the Tower models 4@var{n}0 and 6@var{n}0, by default a process is not -allowed to have more than one megabyte of memory. GNU CC cannot compile +allowed to have more than one megabyte of memory. GCC cannot compile itself (or many other programs) with @samp{-O} in that much memory. To solve this problem, reconfigure the kernel adding the following line @@ -640,7 +643,7 @@ MAXUMEM = 4096 @item On HP 9000 series 300 or 400 running HP-UX release 8.0, there is a bug -in the assembler that must be fixed before GNU CC can be built. This +in the assembler that must be fixed before GCC can be built. This bug manifests itself during the first stage of compilation, while building @file{libgcc2.a}: @@ -677,13 +680,13 @@ use BASH (the GNU shell) to run @code{fixproto}. @item Some versions of the Pyramid C compiler are reported to be unable to -compile GNU CC. You must use an older version of GNU CC for +compile GCC. You must use an older version of GCC for bootstrapping. One indication of this problem is if you get a crash -when GNU CC compiles the function @code{muldi3} in file @file{libgcc2.c}. +when GCC compiles the function @code{muldi3} in file @file{libgcc2.c}. -You may be able to succeed by getting GNU CC version 1, installing it, -and using it to compile GNU CC version 2. The bug in the Pyramid C -compiler does not seem to affect GNU CC version 1. +You may be able to succeed by getting GCC version 1, installing it, +and using it to compile GCC version 2. The bug in the Pyramid C +compiler does not seem to affect GCC version 1. @item There may be similar problems on System V Release 3.1 on 386 systems. @@ -691,7 +694,7 @@ There may be similar problems on System V Release 3.1 on 386 systems. @item On the Intel Paragon (an i860 machine), if you are using operating system version 1.0, you will get warnings or errors about redefinition -of @code{va_arg} when you build GNU CC. +of @code{va_arg} when you build GCC. If this happens, then you need to link most programs with the library @file{iclib.a}. You must also modify @file{stdio.h} as follows: before @@ -728,7 +731,7 @@ insert the line These problems don't exist in operating system version 1.1. @item -On the Altos 3068, programs compiled with GNU CC won't work unless you +On the Altos 3068, programs compiled with GCC won't work unless you fix a kernel bug. This happens using system versions V.2.2 1.0gT1 and V.2.2 1.0e and perhaps later versions as well. See the file @file{README.ALTOS}. @@ -819,12 +822,12 @@ run. Incompatible libraries are then detected at link time, rather than at run time. @item -Older GDB versions sometimes fail to read the output of GNU CC version +Older GDB versions sometimes fail to read the output of GCC version 2. If you have trouble, get GDB version 4.4 or later. @item @cindex DBX -DBX rejects some files produced by GNU CC, though it accepts similar +DBX rejects some files produced by GCC, though it accepts similar constructs in output from PCC. Until someone can supply a coherent description of what is valid DBX input and what is not, there is nothing I can do about these problems. You are on your own. @@ -841,10 +844,10 @@ be run. @item Use of @samp{-I/usr/include} may cause trouble. -Many systems come with header files that won't work with GNU CC unless +Many systems come with header files that won't work with GCC unless corrected by @code{fixincludes}. The corrected header files go in a new -directory; GNU CC searches this directory before @file{/usr/include}. -If you use @samp{-I/usr/include}, this tells GNU CC to search +directory; GCC searches this directory before @file{/usr/include}. +If you use @samp{-I/usr/include}, this tells GCC to search @file{/usr/include} earlier on, before the corrected headers. The result is that you get the uncorrected header files. @@ -854,7 +857,7 @@ Instead, you should use these options (when compiling C programs): -I/usr/local/lib/gcc-lib/@var{target}/@var{version}/include -I/usr/include @end smallexample -For C++ programs, GNU CC also uses a special directory that defines C++ +For C++ programs, GCC also uses a special directory that defines C++ interfaces to standard C subroutines. This directory is meant to be searched @emph{before} other standard include directories, so that it takes precedence. If you are compiling C++ programs and specifying @@ -871,7 +874,7 @@ options above: There is a bug in @code{vfork} on the Sun-4 which causes the registers of the child process to clobber those of the parent. Because of this, programs that call @code{vfork} are likely to lose when compiled -optimized with GNU CC when the child code alters registers which contain +optimized with GCC when the child code alters registers which contain C variables in the parent. This affects variables which are live in the parent across the call to @code{vfork}. @@ -884,18 +887,18 @@ using @samp{-O} for those source files. @item On some SGI systems, when you use @samp{-lgl_s} as an option, it gets translated magically to @samp{-lgl_s -lX11_s -lc_s}. -Naturally, this does not happen when you use GNU CC. +Naturally, this does not happen when you use GCC. You must specify all three options explicitly. @item -On a Sparc, GNU CC aligns all values of type @code{double} on an 8-byte +On a Sparc, GCC aligns all values of type @code{double} on an 8-byte boundary, and it expects every @code{double} to be so aligned. The Sun compiler usually gives @code{double} values 8-byte alignment, with one exception: function arguments of type @code{double} may not be aligned. As a result, if a function compiled with Sun CC takes the address of an argument of type @code{double} and passes this pointer of type -@code{double *} to a function compiled with GNU CC, dereferencing the +@code{double *} to a function compiled with GCC, dereferencing the pointer may cause a fatal signal. One way to solve this problem is to compile your entire program with GNU @@ -926,7 +929,7 @@ Storing into the pointer can be done likewise with the same union. @item On Solaris, the @code{malloc} function in the @file{libmalloc.a} library -may allocate memory that is only 4 byte aligned. Since GNU CC on the +may allocate memory that is only 4 byte aligned. Since GCC on the Sparc assumes that doubles are 8 byte aligned, this may result in a fatal signal if doubles are stored in memory allocated by the @file{libmalloc.a} library. @@ -951,20 +954,20 @@ instructions they must be emulated by the operating system. Long doubles do not work in Sun OS versions 4.0.3 and earlier, because the kernel emulator uses an obsolete and incompatible format. Long doubles do not work in Sun OS version 4.1.1 due to a problem in a Sun library. -Long doubles do work on Sun OS versions 4.1.2 and higher, but GNU CC +Long doubles do work on Sun OS versions 4.1.2 and higher, but GCC does not enable them by default. Long doubles appear to work in Sun OS 5.x (Solaris 2.x). @item On HP-UX version 9.01 on the HP PA, the HP compiler @code{cc} does not -compile GNU CC correctly. We do not yet know why. However, GNU CC +compile GCC correctly. We do not yet know why. However, GCC compiled on earlier HP-UX versions works properly on HP-UX 9.01 and can compile itself properly on 9.01. @item On the HP PA machine, ADB sometimes fails to work on functions compiled -with GNU CC. Specifically, it fails to work on functions that use -@code{alloca} or variable-size arrays. This is because GNU CC doesn't +with GCC. Specifically, it fails to work on functions that use +@code{alloca} or variable-size arrays. This is because GCC doesn't generate HP-UX unwind descriptors for such functions. It may even be impossible to generate them. @@ -986,11 +989,11 @@ the HP assembler. GAS for the PA does not have this problem. In extremely rare cases involving some very large functions you may receive errors from the HP linker complaining about an out of bounds unconditional branch offset. This used to occur more often in previous -versions of GNU CC, but is now exceptionally rare. If you should run +versions of GCC, but is now exceptionally rare. If you should run into it, you can work around by making your function smaller. @item -GNU CC compiled code sometimes emits warnings from the HP-UX assembler of +GCC compiled code sometimes emits warnings from the HP-UX assembler of the form: @smallexample @@ -1064,7 +1067,7 @@ by requesting PTF 421749 from IBM. @item There is an assembler bug in versions of DG/UX prior to 5.4.2.01 that -occurs when the @samp{fldcr} instruction is used. GNU CC uses +occurs when the @samp{fldcr} instruction is used. GCC uses @samp{fldcr} on the 88100 to serialize volatile memory references. Use the option @samp{-mno-serialize-volatile} if your version of the assembler has this bug. @@ -1090,7 +1093,7 @@ lines around the definition of @code{size_t}: @cindex Alliant @item On the Alliant, the system's own convention for returning structures -and unions is unusual, and is not compatible with GNU CC no matter +and unions is unusual, and is not compatible with GCC no matter what options are used. @cindex RT PC @@ -1098,7 +1101,7 @@ what options are used. @item On the IBM RT PC, the MetaWare HighC compiler (hc) uses a different convention for structure and union returning. Use the option -@samp{-mhc-struct-return} to tell GNU CC to use a convention compatible +@samp{-mhc-struct-return} to tell GCC to use a convention compatible with it. @cindex Vax calling convention @@ -1108,7 +1111,7 @@ On Ultrix, the Fortran compiler expects registers 2 through 5 to be saved by function calls. However, the C compiler uses conventions compatible with BSD Unix: registers 2 through 5 may be clobbered by function calls. -GNU CC uses the same convention as the Ultrix C compiler. You can use +GCC uses the same convention as the Ultrix C compiler. You can use these options to produce code compatible with the Fortran compiler: @smallexample @@ -1116,7 +1119,7 @@ these options to produce code compatible with the Fortran compiler: @end smallexample @item -On the WE32k, you may find that programs compiled with GNU CC do not +On the WE32k, you may find that programs compiled with GCC do not work with the standard shared C library. You may need to link with the ordinary C compiler. If you do so, you must specify the following options: @@ -1128,7 +1131,7 @@ options: The first specifies where to find the library @file{libgcc.a} specified with the @samp{-lgcc} option. -GNU CC does linking by invoking @code{ld}, just as @code{cc} does, and +GCC does linking by invoking @code{ld}, just as @code{cc} does, and there is no reason why it @emph{should} matter which compilation program you use to invoke @code{ld}. If someone tracks this problem down, it can probably be fixed easily. @@ -1145,7 +1148,7 @@ sometimes reorders instructions incorrectly when optimization is turned on. If you think this may be happening to you, try using the GNU assembler; GAS version 2.1 supports ECOFF on Irix. -Or use the @samp{-noasmopt} option when you compile GNU CC with itself, +Or use the @samp{-noasmopt} option when you compile GCC with itself, and then again when you compile your program. (This is a temporary kludge to turn off assembler optimization on Irix.) If this proves to be what you need, edit the assembler spec in the file @file{specs} so @@ -1197,13 +1200,13 @@ On various 386 Unix systems derived from System V, including SCO, ISC, and ESIX, you may get error messages about running out of virtual memory while compiling certain programs. -You can prevent this problem by linking GNU CC with the GNU malloc +You can prevent this problem by linking GCC with the GNU malloc (which thus replaces the malloc that comes with the system). GNU malloc is available as a separate package, and also in the file @file{src/gmalloc.c} in the GNU Emacs 19 distribution. If you have installed GNU malloc as a separate library package, use this -option when you relink GNU CC: +option when you relink GCC: @example MALLOC=/usr/local/lib/libgmalloc.a @@ -1211,7 +1214,7 @@ MALLOC=/usr/local/lib/libgmalloc.a Alternatively, if you have compiled @file{gmalloc.c} from Emacs 19, copy the object file to @file{gmalloc.o} and use this option when you relink -GNU CC: +GCC: @example MALLOC=gmalloc.o @@ -1219,8 +1222,8 @@ MALLOC=gmalloc.o @end itemize @node Incompatibilities -@section Incompatibilities of GNU CC -@cindex incompatibilities of GNU CC +@section Incompatibilities of GCC +@cindex incompatibilities of GCC There are several noteworthy incompatibilities between GNU C and most existing (non-ANSI) versions of C. The @samp{-traditional} option @@ -1232,8 +1235,8 @@ telling GNU C to behave like the other C compilers. @cindex read-only strings @cindex shared strings @item -GNU CC normally makes string constants read-only. If several -identical-looking string constants are used, GNU CC stores only one +GCC normally makes string constants read-only. If several +identical-looking string constants are used, GCC stores only one copy of the string. @cindex @code{mktemp}, and constant strings @@ -1252,7 +1255,7 @@ constant. Likewise @code{fscanf} and @code{scanf}. 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. But if this is not possible, -you can use the @samp{-fwritable-strings} flag, which directs GNU CC +you can use the @samp{-fwritable-strings} flag, which directs GCC to handle string constants the same way most C compilers do. @samp{-traditional} also has this effect, among others. @@ -1264,8 +1267,8 @@ This is because 2147483648 cannot fit in the type @code{int}, so Negating this value yields 2147483648 again. @item -GNU CC does not substitute macro arguments when they appear inside of -string constants. For example, the following macro in GNU CC +GCC does not substitute macro arguments when they appear inside of +string constants. For example, the following macro in GCC @example #define foo(a) "a" @@ -1274,7 +1277,7 @@ string constants. For example, the following macro in GNU CC @noindent will produce output @code{"a"} regardless of what the argument @var{a} is. -The @samp{-traditional} option directs GNU CC to handle such cases +The @samp{-traditional} option directs GCC to handle such cases (among others) in the old-fashioned (non-ANSI) fashion. @cindex @code{setjmp} incompatibilities @@ -1308,7 +1311,7 @@ its first value is restored; otherwise, it keeps the last value stored in it. If you use the @samp{-W} option with the @samp{-O} option, you will -get a warning when GNU CC thinks such a problem might be possible. +get a warning when GCC thinks such a problem might be possible. The @samp{-traditional} option directs GNU C to put variables in the stack by default, rather than in registers, in functions that @@ -1317,7 +1320,7 @@ traditional C compilers. @item Programs that use preprocessing directives in the middle of macro -arguments do not work with GNU CC. For example, a program like this +arguments do not work with GCC. For example, a program like this will not work: @example @@ -1366,17 +1369,17 @@ difficulty described immediately above applies here too. @cindex whitespace @item PCC allows whitespace in the middle of compound assignment operators -such as @samp{+=}. GNU CC, following the ANSI standard, does not +such as @samp{+=}. GCC, following the ANSI standard, does not allow this. The difficulty described immediately above applies here too. @cindex apostrophes @cindex ' @item -GNU CC complains about unterminated character constants inside of +GCC complains about unterminated character constants inside of preprocessing conditionals that fail. Some programs have English comments enclosed in conditionals that are guaranteed to fail; if these -comments contain apostrophes, GNU CC will probably report an error. For +comments contain apostrophes, GCC will probably report an error. For example, this code would produce an error: @example @@ -1403,38 +1406,38 @@ type of @code{time}. @cindex @code{float} as function value type @item When compiling functions that return @code{float}, PCC converts it to -a double. GNU CC actually returns a @code{float}. If you are concerned +a double. GCC actually returns a @code{float}. If you are concerned with PCC compatibility, you should declare your functions to return @code{double}; you might as well say what you mean. @cindex structures @cindex unions @item -When compiling functions that return structures or unions, GNU CC +When compiling functions that return structures or unions, GCC output code normally uses a method different from that used on most -versions of Unix. As a result, code compiled with GNU CC cannot call +versions of Unix. As a result, code compiled with GCC cannot call a structure-returning function compiled with PCC, and vice versa. -The method used by GNU CC is as follows: a structure or union which is +The method used by GCC is as follows: a structure or union which is 1, 2, 4 or 8 bytes long is returned like a scalar. A structure or union with any other size is stored into an address supplied by the caller (usually in a special, fixed register, but on some machines it is passed on the stack). The machine-description macros @code{STRUCT_VALUE} and -@code{STRUCT_INCOMING_VALUE} tell GNU CC where to pass this address. +@code{STRUCT_INCOMING_VALUE} tell GCC where to pass this address. By contrast, PCC on most target machines returns structures and unions of any size by copying the data into an area of static storage, and then returning the address of that storage as if it were a pointer value. The caller must copy the data from that memory area to the place where -the value is wanted. GNU CC does not use this method because it is +the value is wanted. GCC does not use this method because it is slower and nonreentrant. On some newer machines, PCC uses a reentrant convention for all -structure and union returning. GNU CC on most of these machines uses a +structure and union returning. GCC on most of these machines uses a compatible convention when returning structures and unions in memory, but still returns small structures and unions in registers. -You can tell GNU CC to use a compatible convention for all structure and +You can tell GCC to use a compatible convention for all structure and union returning with the option @samp{-fpcc-struct-return}. @cindex preprocessing tokens @@ -1460,13 +1463,13 @@ the minus sign. This whitespace will end the preprocessing number. @node Fixed Headers @section Fixed Header Files -GNU CC needs to install corrected versions of some system header files. +GCC needs to install corrected versions of some system header files. This is because most target systems have some header files that won't -work with GNU CC unless they are changed. Some have bugs, some are +work with GCC unless they are changed. Some have bugs, some are incompatible with ANSI C, and some depend on special features of other compilers. -Installing GNU CC automatically creates and installs the fixed header +Installing GCC automatically creates and installs the fixed header files, by running a program called @code{fixincludes} (or for certain targets an alternative such as @code{fixinc.svr4}). Normally, you don't need to pay attention to this. But there are cases where it @@ -1475,8 +1478,8 @@ doesn't do the right thing automatically. @itemize @bullet @item If you update the system's header files, such as by installing a new -system version, the fixed header files of GNU CC are not automatically -updated. The easiest way to update them is to reinstall GNU CC. (If +system version, the fixed header files of GCC are not automatically +updated. The easiest way to update them is to reinstall GCC. (If you want to be clever, look in the makefile and you can find a shortcut.) @@ -1499,18 +1502,18 @@ different machine models, and arrange a structure of symbolic links so as to use the proper set, but you'll have to do this by hand. @item -On Lynxos, GNU CC by default does not fix the header files. This is +On Lynxos, GCC by default does not fix the header files. This is because bugs in the shell cause the @code{fixincludes} script to fail. This means you will encounter problems due to bugs in the system header -files. It may be no comfort that they aren't GNU CC's fault, but it +files. It may be no comfort that they aren't GCC's fault, but it does mean that there's nothing for us to do about them. @end itemize @node Standard Libraries @section Standard Libraries -GNU CC by itself attempts to be what the ISO/ANSI C standard calls a +GCC by itself attempts to be what the ISO/ANSI C standard calls a @dfn{conforming freestanding implementation}. This means all ANSI C language features are available, as well as the contents of @file{float.h}, @file{limits.h}, @file{stdarg.h}, and @@ -1526,7 +1529,7 @@ this function match the Standard, but that would be wrong, since the function will still return @code{char *}. If you need a Standard compliant library, then you need to find one, as -GNU CC does not provide one. The GNU C library (called @code{glibc}) +GCC does not provide one. The GNU C library (called @code{glibc}) has been ported to a number of operating systems, and provides ANSI/ISO, POSIX, BSD and SystemV compatibility. You could also ask your operating system vendor if newer libraries are available. @@ -1542,10 +1545,10 @@ way around them. Certain local variables aren't recognized by debuggers when you compile with optimization. -This occurs because sometimes GNU CC optimizes the variable out of +This occurs because sometimes GCC optimizes the variable out of existence. There is no way to tell the debugger how to compute the value such a variable ``would have had'', and it is not clear that would -be desirable anyway. So GNU CC simply does not mention the eliminated +be desirable anyway. So GCC simply does not mention the eliminated variable when it writes debugging information. You have to expect a certain amount of disagreement between the @@ -1554,7 +1557,7 @@ executable and your source code, when you use optimization. @cindex conflicting types @cindex scope of declaration @item -Users often think it is a bug when GNU CC reports an error for code +Users often think it is a bug when GCC reports an error for code like this: @example @@ -1592,14 +1595,14 @@ If you care about controlling the amount of memory that is accessed, use volatile but do not use bitfields. @item -GNU CC comes with shell scripts to fix certain known problems in system +GCC comes with shell scripts to fix certain known problems in system header files. They install corrected copies of various header files in -a special directory where only GNU CC will normally look for them. The +a special directory where only GCC will normally look for them. The scripts adapt to various systems by searching all the system header files for the problem cases that we know about. If new system header files are installed, nothing automatically arranges -to update the corrected header files. You will have to reinstall GNU CC +to update the corrected header files. You will have to reinstall GCC to fix the new header files. More specifically, go to the build directory and delete the files @file{stmp-fixinc} and @file{stmp-headers}, and the subdirectory @code{include}; then do @@ -1891,7 +1894,7 @@ eighty characters in any case.) @section Certain Changes We Don't Want to Make This section lists changes that people frequently request, but which -we do not make because we think GNU CC is better without them. +we do not make because we think GCC is better without them. @itemize @bullet @item @@ -1992,12 +1995,12 @@ that machine. But such applications are rare. And users writing a program to run on more than one type of machine cannot possibly benefit from this kind of compatibility. -This is why GNU CC does and will treat plain bitfields in the same +This is why GCC does and will treat plain bitfields in the same fashion on all types of machines (by default). There are some arguments for making bitfields unsigned by default on all machines. If, for example, this becomes a universal de facto standard, -it would make sense for GNU CC to go along with it. This is something +it would make sense for GCC to go along with it. This is something to be considered in the future. (Of course, users strongly concerned about portability should indicate @@ -2007,7 +2010,7 @@ they write programs which have the same meaning in both C dialects.) @item Undefining @code{__STDC__} when @samp{-ansi} is not used. -Currently, GNU CC defines @code{__STDC__} as long as you don't use +Currently, GCC defines @code{__STDC__} as long as you don't use @samp{-traditional}. This provides good results in practice. Programmers normally use conditionals on @code{__STDC__} to ask whether @@ -2033,11 +2036,11 @@ compilers such as plain @samp{gcc}. Whatever the ANSI C standard says is relevant to the design of plain @samp{gcc} without @samp{-ansi} only for pragmatic reasons, not as a requirement. -GNU CC normally defines @code{__STDC__} to be 1, and in addition +GCC normally defines @code{__STDC__} to be 1, and in addition defines @code{__STRICT_ANSI__} if you specify the @samp{-ansi} option. On some hosts, system include files use a different convention, where @code{__STDC__} is normally 0, but is 1 if the user specifies strict -conformance to the C Standard. GNU CC follows the host convention when +conformance to the C Standard. GCC follows the host convention when processing system include files, but when processing user files it follows the usual GNU C convention. @@ -2063,7 +2066,7 @@ test explicitly for C++ as well. @item Deleting ``empty'' loops. -Historically, GNU CC has not deleted ``empty'' loops under the +Historically, GCC has not deleted ``empty'' loops under the assumption that the most likely reason you would put one in a program is to have a delay, so deleting them will not make real programs run any faster. @@ -2118,7 +2121,7 @@ warnings. Each kind has a different purpose: @itemize @w{} @item @emph{Errors} report problems that make it impossible to compile your -program. GNU CC reports errors with the source file name and line +program. GCC reports errors with the source file name and line number where the problem is apparent. @item @@ -2136,12 +2139,12 @@ warnings are issued only if you ask for them, with one of the @samp{-W} options (for instance, @samp{-Wall} requests a variety of useful warnings). -GNU CC always tries to compile your program if possible; it never +GCC always tries to compile your program if possible; it never gratuitously rejects a program whose meaning is clear merely because (for instance) it fails to conform to a standard. In some cases, however, the C and C++ standards specify that certain extensions are forbidden, and a diagnostic @emph{must} be issued by a conforming -compiler. The @samp{-pedantic} option tells GNU CC to issue warnings in +compiler. The @samp{-pedantic} option tells GCC to issue warnings in such cases; @samp{-pedantic-errors} says to make them errors instead. This does not mean that @emph{all} non-ANSI constructs get warnings or errors. @@ -2154,7 +2157,7 @@ more detail on these and related command-line options. @cindex bugs @cindex reporting bugs -Your bug reports play an essential role in making GNU CC reliable. +Your bug reports play an essential role in making GCC reliable. When you encounter a problem, the first thing to do is to see if it is already known. @xref{Trouble}. If it isn't known, then you should @@ -2163,8 +2166,8 @@ report the problem. Reporting a bug may help you by bringing a solution to your problem, or it may not. (If it does not, look in the service directory; see @ref{Service}.) In any case, the principal function of a bug report is -to help the entire community by making the next version of GNU CC work -better. Bug reports are your contribution to the maintenance of GNU CC. +to help the entire community by making the next version of GCC work +better. Bug reports are your contribution to the maintenance of GCC. Since the maintainers are very overloaded, we cannot respond to every bug report. However, if the bug has not been fixed, we are likely to @@ -2177,7 +2180,7 @@ information that makes for fixing the bug. * Criteria: Bug Criteria. Have you really found a bug? * Where: Bug Lists. Where to send your bug report. * Reporting: Bug Reporting. How to report a bug effectively. -* Patches: Sending Patches. How to send a patch for GNU CC. +* Patches: Sending Patches. How to send a patch for GCC. * Known: Trouble. Known problems. * Help: Service. Where to ask for help. @end menu @@ -2221,11 +2224,11 @@ by chance to give the desired results with another C or C++ compiler. For example, in many nonoptimizing compilers, you can write @samp{x;} at the end of a function instead of @samp{return x;}, with the same results. But the value of the function is undefined if @code{return} -is omitted; it is not a bug when GNU CC produces different results. +is omitted; it is not a bug when GCC produces different results. Problems often result from expressions with two increment operators, as in @code{f (*p++, *p++)}. Your previous compiler might have -interpreted that expression the way you intended; GNU CC might +interpreted that expression the way you intended; GCC might interpret it another way. Neither compiler is wrong. The bug is in your code. @@ -2245,20 +2248,23 @@ that is a compiler bug. However, you should note that your idea of for traditional practice''. @item -If you are an experienced user of C or C++ compilers, your suggestions -for improvement of GNU CC or GNU C++ are welcome in any case. +If you are an experienced user of C or C++ (or Fortran or Objective-C) +compilers, your suggestions +for improvement of GCC are welcome in any case. @end itemize @node Bug Lists @section Where to Report Bugs @cindex bug report mailing lists -@kindex egcs-bugs@@egcs.cygnus.com -Send bug reports for GNU C to @samp{egcs-bugs@@egcs.cygnus.com}. +@kindex gcc-bugs@@gcc.gnu.org or bug-gcc@@gnu.org +Send bug reports for the GNU Compiler Collection to +@samp{gcc-bugs@@gcc.gnu.org}. In accordance with the GNU-wide +convention, in which bug reports for tool ``foo'' are sent +to @samp{bug-foo@@gnu.org}, the address @samp{bug-gcc@@gnu.org} +may also be used; it will forward to the address given above. -@kindex egcs-bugs@@egcs.cygnus.com -@kindex egcs-bugs@@egcs.cygnus.com -Send bug reports for GNU C++ and the C++ runtime libraries to -@samp{egcs-bugs@@egcs.cygnus.com}. +Please read @samp{<URL:http://www.gnu.org/software/gcc/bugs.html>} for +bug reporting instructions before you post a bug report. Often people think of posting bug reports to the newsgroup instead of mailing them. This appears to work, but it has one problem which can be @@ -2280,6 +2286,9 @@ Boston, MA 02111-1307, USA @section How to Report Bugs @cindex compiler bugs, reporting +You may find additional and/or more up-to-date instructions at +@samp{<URL:http://www.gnu.org/software/gcc/bugs.html>}. + The fundamental principle of reporting bugs usefully is this: @strong{report all the facts}. If you are not sure whether to state a fact or leave it out, state it! @@ -2312,30 +2321,16 @@ Please report each bug in a separate message. This makes it easier for us to track which bugs have been fixed and to forward your bugs reports to the appropriate maintainer. -If you include source code in your message, you can send it as clear -text if it is small. If the message is larger, you may compress it using -@file{gzip}, @file{bzip2}, or @file{pkzip}. Please be aware that sending -compressed files needs an additional binary-safe mechanism such as -@code{MIME} or @code{uuencode}. There is a 100k message limit on the -@samp{egcs-bugs@@egcs.cygnus.com} mailing list at the time of this -writing (March 1999). We're trying to create some mechanism for larger -bug reports to be submitted; please check the on-line FAQ for more -up-to-date instructions. Don't think that just posting a URL to the -code is better, we do want to archive bug reports, and not all -maintainers have good network connectivity to download large pieces of -software when they need them; it's much easier for them to have them in -their mailboxes. - To enable someone to investigate the bug, you should include all these things: @itemize @bullet @item -The version of GNU CC. You can get this by running it with the +The version of GCC. You can get this by running it with the @samp{-v} option. Without this, we won't know whether there is any point in looking for -the bug in the current version of GNU CC. +the bug in the current version of GCC. @item A complete input file that will reproduce the bug. If the bug is in the @@ -2357,16 +2352,16 @@ provoke the bug. For example, bugs in register allocation and reloading frequently depend on every little detail of the function they happen in. Even if the input file that fails comes from a GNU program, you should -still send the complete test case. Don't ask the GNU CC maintainers to +still send the complete test case. Don't ask the GCC maintainers to do the extra work of obtaining the program in question---they are all overworked as it is. Also, the problem may depend on what is in the -header files on your system; it is unreliable for the GNU CC maintainers +header files on your system; it is unreliable for the GCC maintainers to try the problem with the header files available to them. By sending CPP output, you can eliminate this source of uncertainty and save us a certain percentage of wild goose chases. @item -The command arguments you gave GNU CC or GNU C++ to compile that example +The command arguments you gave GCC to compile that example and observe the bug. For example, did you use @samp{-O}? To guarantee you won't omit something important, list all the options. @@ -2395,7 +2390,7 @@ don't support) is a modification of the compiler source. @item Details of any other deviations from the standard procedure for installing -GNU CC. +GCC. @item A description of what behavior you observe that you believe is @@ -2418,7 +2413,7 @@ was not happening. If you don't say to expect a crash, then we would not know whether the bug was happening. We would not be able to draw any conclusion from our observations. -If the problem is a diagnostic when compiling GNU CC with some other +If the problem is a diagnostic when compiling GCC with some other compiler, say whether it is a warning or an error. Often the observed symptom is incorrect output when your program is run. @@ -2431,13 +2426,13 @@ person who understands the program can find this as easily as finding a bug in the program itself. @item -If you send examples of assembler code output from GNU CC or GNU C++, +If you send examples of assembler code output from GCC, please use @samp{-g} when you make them. The debugging information includes source line numbers which are essential for correlating the output with the input. @item -If you wish to mention something in the GNU CC source, refer to it by +If you wish to mention something in the GCC source, refer to it by context, not by line number. The line numbers in the development sources don't match those in your @@ -2453,7 +2448,7 @@ any chance of being useful. @cindex backtrace for bug reports For example, many people send just a backtrace, but that is never useful by itself. A simple backtrace with arguments conveys little -about GNU CC because the compiler is largely data-driven; the same +about GCC because the compiler is largely data-driven; the same functions are called over and over for different RTL insns, doing different things depending on the details of the insn. @@ -2497,7 +2492,7 @@ as well save your time for something else. Of course, if you can find a simpler example to report @emph{instead} of the original one, that is a convenience. Errors in the output will be easier to spot, running under the debugger will take less time, etc. -Most GNU CC bugs involve just one function, so the most straightforward +Most GCC bugs involve just one function, so the most straightforward way to simplify an example is to delete all the function definitions except the one where the bug occurs. Those earlier in the file may be replaced by external declarations if the crucial function depends on @@ -2521,7 +2516,7 @@ necessary information, such as the test case, on the assumption that a patch is all we need. We might see problems with your patch and decide to fix the problem another way, or we might not understand it at all. -Sometimes with a program as complicated as GNU CC it is very hard to +Sometimes with a program as complicated as GCC it is very hard to construct an example that will make the program follow a certain path through the code. If you don't send the example, we won't be able to construct one, so we won't be able to verify that the bug is fixed. @@ -2548,11 +2543,11 @@ we should be able to reproduce the crash ourselves. @end itemize @node Sending Patches,, Bug Reporting, Bugs -@section Sending Patches for GNU CC +@section Sending Patches for GCC If you would like to write bug fixes or improvements for the GNU C -compiler, that is very helpful. Send suggested fixes to the bug report -mailing list, @code{egcs-bugs@@egcs.cygnus.com}. +compiler, that is very helpful. Send suggested fixes to the patches +mailing list, @code{gcc-patches@@gcc.gnu.org}. Please follow these guidelines so we can study your patches efficiently. If you don't follow these guidelines, your information might still be @@ -2645,7 +2640,7 @@ would break other systems. People often suggest fixing a problem by changing machine-independent files such as @file{toplev.c} to do something special that a particular system needs. Sometimes it is totally obvious that such changes would -break GNU CC for almost all users. We can't possibly make a change like +break GCC for almost all users. We can't possibly make a change like that. At best it might tell us how to write another patch that would solve the problem acceptably. @@ -2664,48 +2659,48 @@ form that is good to install. @end itemize @node Service -@chapter How To Get Help with GNU CC +@chapter How To Get Help with GCC -If you need help installing, using or changing GNU CC, there are two +If you need help installing, using or changing GCC, there are two ways to find it: @itemize @bullet @item Send a message to a suitable network mailing list. First try -@code{egcs-bugs@@egcs.cygnus.com}, and if that brings no response, try -@code{egcs@@egcs.cygnus.com}. +@code{gcc-bugs@@gcc.gnu.org} or @code{bug-gcc@@gnu.org}, and if that +brings no response, try @code{gcc@@gcc.gnu.org}. @item Look in the service directory for someone who might help you for a fee. The service directory is found in the file named @file{SERVICE} in the -GNU CC distribution. +GCC distribution. @end itemize @node Contributing -@chapter Contributing to GNU CC Development +@chapter Contributing to GCC Development -If you would like to help pretest GNU CC releases to assure they work -well, or if you would like to work on improving GNU CC, please contact -the maintainers at @code{egcs@@egcs.cygnus.com}. A pretester should +If you would like to help pretest GCC releases to assure they work +well, or if you would like to work on improving GCC, please contact +the maintainers at @code{gcc@@gcc.gnu.org}. A pretester should be willing to try to investigate bugs as well as report them. If you'd like to work on improvements, please ask for suggested projects or suggest your own ideas. If you have already written an improvement, please tell us about it. If you have not yet started work, it is useful -to contact @code{egcs@@egcs.cygnus.com} before you start; the +to contact @code{gcc@@gcc.gnu.org} before you start; the maintainers may be able to suggest ways to make your extension fit in -better with the rest of GNU CC and with other development plans. +better with the rest of GCC and with other development plans. @node VMS -@chapter Using GNU CC on VMS +@chapter Using GCC on VMS @c prevent bad page break with this line -Here is how to use GNU CC on VMS. +Here is how to use GCC on VMS. @menu * Include Files and VMS:: Where the preprocessor looks for the include files. * Global Declarations:: How to do globaldef, globalref and globalvalue with - GNU CC. + GCC. * VMS Misc:: Misc information. @end menu @@ -2715,11 +2710,11 @@ Here is how to use GNU CC on VMS. @cindex include files and VMS @cindex VMS and include files @cindex header files and VMS -Due to the differences between the filesystems of Unix and VMS, GNU CC +Due to the differences between the filesystems of Unix and VMS, GCC attempts to translate file names in @samp{#include} into names that VMS will understand. The basic strategy is to prepend a prefix to the specification of the include file, convert the whole filename to a VMS -filename, and then try to open the file. GNU CC tries various prefixes +filename, and then try to open the file. GCC tries various prefixes one by one until one of them succeeds: @enumerate @@ -2763,9 +2758,9 @@ Include directives of the form: @end example @noindent -are a common source of incompatibility between VAX-C and GNU CC. VAX-C +are a common source of incompatibility between VAX-C and GCC. VAX-C treats this much like a standard @code{#include <foobar.h>} directive. -That is incompatible with the ANSI C behavior implemented by GNU CC: to +That is incompatible with the ANSI C behavior implemented by GCC: to expand the name @code{foobar} as a macro. Macro expansion should eventually yield one of the two standard formats for @code{#include}: @@ -2794,17 +2789,17 @@ Another source of incompatibility is that VAX-C assumes that: @end example @noindent -is actually asking for the file @file{foobar.h}. GNU CC does not +is actually asking for the file @file{foobar.h}. GCC does not make this assumption, and instead takes what you ask for literally; it tries to read the file @file{foobar}. The best way to avoid this problem is to always specify the desired file extension in your include directives. -GNU CC for VMS is distributed with a set of include files that is +GCC for VMS is distributed with a set of include files that is sufficient to compile most general purpose programs. Even though the -GNU CC distribution does not contain header files to define constants +GCC distribution does not contain header files to define constants and structures for some VMS system-specific functions, there is no -reason why you cannot use GNU CC with any of these functions. You first +reason why you cannot use GCC with any of these functions. You first may have to generate or create header files, either by using the public domain utility @code{UNSDL} (which can be found on a DECUS tape), or by extracting the relevant modules from one of the system macro libraries, @@ -2821,7 +2816,7 @@ whether explicitly, or implicitly via a logical name. @findex GLOBALDEF @findex GLOBALVALUEDEF @findex GLOBALVALUEREF -GNU CC does not provide the @code{globalref}, @code{globaldef} and +GCC does not provide the @code{globalref}, @code{globaldef} and @code{globalvalue} keywords of VAX-C. You can get the same effect with an obscure feature of GAS, the GNU assembler. (This requires GAS version 1.39 or later.) The following macros allow you to use this @@ -2940,19 +2935,19 @@ enum globaldef color @{RED, BLUE, GREEN = 3@}; @cindex exit status and VMS @cindex return value of @code{main} @cindex @code{main} and the exit status -GNU CC automatically arranges for @code{main} to return 1 by default if +GCC automatically arranges for @code{main} to return 1 by default if you fail to specify an explicit return value. This will be interpreted by VMS as a status code indicating a normal successful completion. -Version 1 of GNU CC did not provide this default. +Version 1 of GCC did not provide this default. -GNU CC on VMS works only with the GNU assembler, GAS. You need version +GCC on VMS works only with the GNU assembler, GAS. You need version 1.37 or later of GAS in order to produce value debugging information for the VMS debugger. Use the ordinary VMS linker with the object files produced by GAS. @cindex shared VMS run time system @cindex @file{VAXCRTL} -Under previous versions of GNU CC, the generated code would occasionally +Under previous versions of GCC, the generated code would occasionally give strange results when linked to the sharable @file{VAXCRTL} library. Now this should work. @@ -2969,10 +2964,10 @@ placed in writable storage. Although the VMS linker does distinguish between upper and lower case letters in global symbols, most VMS compilers convert all such symbols into upper case and most run-time library routines also have upper case -names. To be able to reliably call such routines, GNU CC (by means of +names. To be able to reliably call such routines, GCC (by means of the assembler GAS) converts global symbols into upper case like other VMS compilers. However, since the usual practice in C is to distinguish -case, GNU CC (via GAS) tries to preserve usual C behavior by augmenting +case, GCC (via GAS) tries to preserve usual C behavior by augmenting each name that is not all lower case. This means truncating the name to at most 23 characters and then adding more characters at the end which encode the case pattern of those 23. Names which contain at @@ -3026,16 +3021,16 @@ number of changes to your source code. @ifset INTERNALS @node Portability -@chapter GNU CC and Portability +@chapter GCC and Portability @cindex portability -@cindex GNU CC and portability +@cindex GCC and portability -The main goal of GNU CC was to make a good, fast compiler for machines in +The main goal of GCC was to make a good, fast compiler for machines in the class that the GNU system aims to run on: 32-bit machines that address 8-bit bytes and have several general registers. Elegance, theoretical power and simplicity are only secondary. -GNU CC gets most of the information about the target machine from a machine +GCC gets most of the information about the target machine from a machine description which gives an algebraic formula for each of the machine's instructions. This is a very clean way to describe the target. But when the compiler needs information that is difficult to express in this @@ -3046,7 +3041,7 @@ on the compiler; it was not of interest for its own sake. @cindex endianness @cindex autoincrement addressing, availability @findex abort -GNU CC does not contain machine dependent code, but it does contain code +GCC does not contain machine dependent code, but it does contain code that depends on machine parameters such as endianness (whether the most significant byte has the highest or lowest address of the bytes in a word) and the availability of autoincrement addressing. In the RTL-generation @@ -3062,13 +3057,13 @@ affect only the target machines that need them. @ifset INTERNALS @node Interface -@chapter Interfacing to GNU CC Output -@cindex interfacing to GNU CC output +@chapter Interfacing to GCC Output +@cindex interfacing to GCC output @cindex run-time conventions @cindex function call conventions @cindex conventions, run-time -GNU CC is normally configured to use the same function calling convention +GCC is normally configured to use the same function calling convention normally in use on the target system. This is done with the machine-description macros described (@pxref{Target Macros}). @@ -3077,43 +3072,43 @@ machine-description macros described (@pxref{Target Macros}). @cindex returning structures and unions However, returning of structure and union values is done differently on some target machines. As a result, functions compiled with PCC -returning such types cannot be called from code compiled with GNU CC, +returning such types cannot be called from code compiled with GCC, and vice versa. This does not cause trouble often because few Unix library routines return structures or unions. -GNU CC code returns structures and unions that are 1, 2, 4 or 8 bytes +GCC code returns structures and unions that are 1, 2, 4 or 8 bytes long in the same registers used for @code{int} or @code{double} return -values. (GNU CC typically allocates variables of such types in +values. (GCC typically allocates variables of such types in registers also.) Structures and unions of other sizes are returned by storing them into an address passed by the caller (usually in a register). The machine-description macros @code{STRUCT_VALUE} and -@code{STRUCT_INCOMING_VALUE} tell GNU CC where to pass this address. +@code{STRUCT_INCOMING_VALUE} tell GCC where to pass this address. By contrast, PCC on most target machines returns structures and unions of any size by copying the data into an area of static storage, and then returning the address of that storage as if it were a pointer value. The caller must copy the data from that memory area to the place where -the value is wanted. This is slower than the method used by GNU CC, and +the value is wanted. This is slower than the method used by GCC, and fails to be reentrant. On some target machines, such as RISC machines and the 80386, the standard system convention is to pass to the subroutine the address of -where to return the value. On these machines, GNU CC has been +where to return the value. On these machines, GCC has been configured to be compatible with the standard compiler, when this method is used. It may not be compatible for structures of 1, 2, 4 or 8 bytes. @cindex argument passing @cindex passing arguments -GNU CC uses the system's standard convention for passing arguments. On +GCC uses the system's standard convention for passing arguments. On some machines, the first few arguments are passed in registers; in others, all are passed on the stack. It would be possible to use registers for argument passing on any machine, and this would probably result in a significant speedup. But the result would be complete incompatibility with code that follows the standard convention. So this -change is practical only if you are switching to GNU CC as the sole C +change is practical only if you are switching to GCC as the sole C compiler for the system. We may implement register argument passing on certain machines once we have a complete GNU system so that we can -compile the libraries with GNU CC. +compile the libraries with GCC. On some machines (particularly the Sparc), certain types of arguments are passed ``by invisible reference''. This means that the value is @@ -3123,9 +3118,9 @@ the subroutine. @cindex @code{longjmp} and automatic variables If you use @code{longjmp}, beware of automatic variables. ANSI C says that automatic variables that are not declared @code{volatile} have undefined -values after a @code{longjmp}. And this is all GNU CC promises to do, +values after a @code{longjmp}. And this is all GCC promises to do, because it is very difficult to restore register variables correctly, and -one of GNU CC's features is that it can put variables in registers without +one of GCC's features is that it can put variables in registers without your asking it to. If you want a variable to be unaltered by @code{longjmp}, and you don't @@ -3144,7 +3139,7 @@ go in a register: @cindex arithmetic libraries @cindex math libraries -Code compiled with GNU CC may call certain library routines. Most of +Code compiled with GCC may call certain library routines. Most of them handle arithmetic for which there are no instructions. This includes multiply and divide on some machines, and floating point operations on any machine for which floating point support is disabled @@ -3153,7 +3148,7 @@ with @samp{-msoft-float}. Some standard parts of the C library, such as function call interface is used for calling the library routines. These library routines should be defined in the library @file{libgcc.a}, -which GNU CC automatically searches whenever it links a program. On +which GCC automatically searches whenever it links a program. On machines that have multiply and divide instructions, if hardware floating point is in use, normally @file{libgcc.a} is not needed, but it is searched just in case. @@ -3162,7 +3157,7 @@ Each arithmetic function is defined in @file{libgcc1.c} to use the corresponding C arithmetic operator. As long as the file is compiled with another C compiler, which supports all the C arithmetic operators, this file will work portably. However, @file{libgcc1.c} does not work if -compiled with GNU CC, because each arithmetic function would compile +compiled with GCC, because each arithmetic function would compile into a call to itself! @end ifset @@ -3317,7 +3312,7 @@ function must meet certain criteria, currently related to the size of the function and the types and number of parameters it has. Note that this function may contain loops, recursive calls to itself (tail-recursive functions can be inlined!), gotos, in short, all -constructs supported by GNU CC. The file @file{integrate.c} contains +constructs supported by GCC. The file @file{integrate.c} contains the code to save a function's rtl for later inlining and to inline that rtl when the function is called. The header file @file{integrate.h} is also used for this purpose. @@ -3668,7 +3663,7 @@ definitions that describe the machine and system on which the compiler is running, unlike the definitions in @file{@var{machine}.h}, which describe the machine for which the compiler is producing output. Most of the values in @file{xm-@var{machine}.h} are actually the same on all -machines that GNU CC runs on, so large parts of all configuration files +machines that GCC runs on, so large parts of all configuration files are identical. But there are some macros that vary: @table @code @@ -3693,7 +3688,7 @@ exits without serious errors. @findex HOST_WORDS_BIG_ENDIAN @item HOST_WORDS_BIG_ENDIAN Defined if the host machine stores words of multi-word values in -big-endian order. (GNU CC does not depend on the host byte ordering +big-endian order. (GCC does not depend on the host byte ordering within a word.) @findex HOST_FLOAT_WORDS_BIG_ENDIAN @@ -3772,7 +3767,7 @@ If you do define this macro, you should probably do it as follows: @end example @noindent -so that when the compiler is compiled with GNU CC it uses the more +so that when the compiler is compiled with GCC it uses the more efficient built-in @code{alloca} function. @item FUNCTION_CONVERSION_BUG @@ -3784,7 +3779,7 @@ used in an expression. @findex MULTIBYTE_CHARS @item MULTIBYTE_CHARS Define this macro to enable support for multibyte characters in the -input to GNU CC. This requires that the host system support the ANSI C +input to GCC. This requires that the host system support the ANSI C library functions for converting multibyte characters to wide characters. @@ -3815,7 +3810,7 @@ Therefore, if you define @code{sys_siglist}, you should also define Define this to be 1 if you know that the host compiler supports prototypes, even if it doesn't define __STDC__, or define it to be 0 if you do not want any prototypes used in compiling -GNU CC. If @samp{USE_PROTOTYPES} is not defined, it will be +GCC. If @samp{USE_PROTOTYPES} is not defined, it will be determined automatically whether your compiler supports prototypes by checking if @samp{__STDC__} is defined. @@ -3823,7 +3818,7 @@ prototypes by checking if @samp{__STDC__} is defined. @item NO_MD_PROTOTYPES Define this if you wish suppression of prototypes generated from the machine description file, but to use other prototypes within -GNU CC. If @samp{USE_PROTOTYPES} is defined to be 0, or the +GCC. If @samp{USE_PROTOTYPES} is defined to be 0, or the host compiler does not support prototypes, this macro has no effect. @@ -3848,20 +3843,20 @@ the colon character @item DIR_SEPARATOR If your system uses some character other than slash to separate directory names within a file specification, define this macro to be a C -character constant specifying that character. When GNU CC displays file -names, the character you specify will be used. GNU CC will test for +character constant specifying that character. When GCC displays file +names, the character you specify will be used. GCC will test for both slash and the character you specify when parsing filenames. @findex OBJECT_SUFFIX @item OBJECT_SUFFIX Define this macro to be a C string representing the suffix for object -files on your machine. If you do not define this macro, GNU CC will use +files on your machine. If you do not define this macro, GCC will use @samp{.o} as the suffix for object files. @findex EXECUTABLE_SUFFIX @item EXECUTABLE_SUFFIX Define this macro to be a C string representing the suffix for executable -files on your machine. If you do not define this macro, GNU CC will use +files on your machine. If you do not define this macro, GCC will use the null string as the suffix for object files. @findex COLLECT_EXPORT_LIST @@ -3877,14 +3872,14 @@ lists. @findex bcmp In addition, configuration files for system V define @code{bcopy}, @code{bzero} and @code{bcmp} as aliases. Some files define @code{alloca} -as a macro when compiled with GNU CC, in order to take advantage of the -benefit of GNU CC's built-in @code{alloca}. +as a macro when compiled with GCC, in order to take advantage of the +benefit of GCC's built-in @code{alloca}. @node Fragments @chapter Makefile Fragments @cindex makefile fragment -When you configure GNU CC using the @file{configure} script +When you configure GCC using the @file{configure} script (@pxref{Installation}), it will construct the file @file{Makefile} from the template file @file{Makefile.in}. When it does this, it will incorporate makefile fragment files from the @file{config} directory, @@ -3942,11 +3937,11 @@ in @code{EXTRA-PARTS}. @findex MULTILIB_OPTIONS @item MULTILIB_OPTIONS -For some targets, invoking GNU CC in different ways produces objects -that can not be linked together. For example, for some targets GNU CC +For some targets, invoking GCC in different ways produces objects +that can not be linked together. For example, for some targets GCC produces both big and little endian code. For these targets, you must arrange for multiple versions of @file{libgcc.a} to be compiled, one for -each set of incompatible options. When GNU CC invokes the linker, it +each set of incompatible options. When GCC invokes the linker, it arranges to link in the right version of @file{libgcc.a}, based on the command line options used. @@ -3979,7 +3974,7 @@ you desire a different set of directory names. @findex MULTILIB_MATCHES @item MULTILIB_MATCHES Sometimes the same option may be written in two different ways. If an -option is listed in @code{MULTILIB_OPTIONS}, GNU CC needs to know about +option is listed in @code{MULTILIB_OPTIONS}, GCC needs to know about any synonyms. In that case, set @code{MULTILIB_MATCHES} to a list of items of the form @samp{option=option} to describe all relevant synonyms. For example, @samp{m68000=mc68000 m68020=mc68020}. @@ -4073,7 +4068,7 @@ difference than others. For example, maintaining a separate version of a program contributes very little; maintaining the standard version of a program for the whole community contributes much. Easy new ports contribute little, since someone else would surely do them; difficult -ports such as adding a new CPU to the GNU C compiler contribute more; +ports such as adding a new CPU to the GNU Compiler Collection contribute more; major new features or packages contribute the most. By establishing the idea that supporting further development is ``the @@ -4523,7 +4518,7 @@ the ``copyright'' line and a pointer to where the full notice is found. @smallexample @var{one line to give the program's name and a brief idea of what it does.} -Copyright (C) 19@var{yy} @var{name of author} +Copyright (C) @var{yyyy} @var{name of author} This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by @@ -4546,7 +4541,7 @@ If the program is interactive, make it output a short notice like this when it starts in an interactive mode: @smallexample -Gnomovision version 69, Copyright (C) 19@var{yy} @var{name of author} +Gnomovision version 69, Copyright (C) @var{yyyy} @var{name of author} Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, and you are welcome to redistribute it @@ -4578,11 +4573,11 @@ library. If this is what you want to do, use the GNU Library General Public License instead of this License. @node Contributors -@unnumbered Contributors to GNU CC +@unnumbered Contributors to GCC @cindex contributors In addition to Richard Stallman, several people have written parts -of GNU CC. +of GCC. @itemize @bullet @item @@ -4634,13 +4629,13 @@ Randy Smith finished the Sun FPA support. Robert Brown implemented the support for Encore 32000 systems. @item -David Kashtan of SRI adapted GNU CC to VMS. +David Kashtan of SRI adapted GCC to VMS. @item Alex Crain provided changes for the 3b1. @item -Greg Satz and Chris Hanson assisted in making GNU CC work on HP-UX for +Greg Satz and Chris Hanson assisted in making GCC work on HP-UX for the 9000 series 300. @item @@ -4657,16 +4652,16 @@ Dario Dariol contributed the four varieties of sample programs that print a copy of their source. @item -Alain Lichnewsky ported GNU CC to the Mips cpu. +Alain Lichnewsky ported GCC to the Mips cpu. @item -Devon Bowen, Dale Wiles and Kevin Zachmann ported GNU CC to the Tahoe. +Devon Bowen, Dale Wiles and Kevin Zachmann ported GCC to the Tahoe. @item Jonathan Stone wrote the machine description for the Pyramid computer. @item -Gary Miller ported GNU CC to Charles River Data Systems machines. +Gary Miller ported GCC to Charles River Data Systems machines. @item Richard Kenner of the New York University Ultracomputer Research |