home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Source Code 1993 July / THE_SOURCE_CODE_CD_ROM.iso / gnu / gccdist / gcc / gcc.info-11 < prev    next >
Encoding:
GNU Info File  |  1992-09-10  |  2.9 KB  |  75 lines

  1. This is Info file gcc.info, produced by Makeinfo-1.47 from the input
  2. file gcc.texinfo.
  3.  
  4.    This file documents the use and the internals of the GNU compiler.
  5.  
  6.    Copyright (C) 1988, 1989, 1990 Free Software Foundation, Inc.
  7.  
  8.    Permission is granted to make and distribute verbatim copies of this
  9. manual provided the copyright notice and this permission notice are
  10. preserved on all copies.
  11.  
  12.    Permission is granted to copy and distribute modified versions of
  13. this manual under the conditions for verbatim copying, provided also
  14. that the sections entitled "GNU General Public License" and "Protect
  15. Your Freedom--Fight `Look And Feel'" are included exactly as in the
  16. original, and provided that the entire resulting derived work is
  17. distributed under the terms of a permission notice identical to this
  18. one.
  19.  
  20.    Permission is granted to copy and distribute translations of this
  21. manual into another language, under the above conditions for modified
  22. versions, except that the sections entitled "GNU General Public
  23. License" and "Protect Your Freedom--Fight `Look And Feel'" and this
  24. permission notice may be included in translations approved by the Free
  25. Software Foundation instead of in the original English.
  26.  
  27. 
  28. File: gcc.info,  Node: Config,  Prev: Machine Macros,  Up: Top
  29.  
  30. The Configuration File
  31. **********************
  32.  
  33.    The configuration file `xm-MACHINE.h' contains macro definitions
  34. that describe the machine and system on which the compiler is running.
  35. Most of the values in it are actually the same on all machines that GNU
  36. CC runs on, so large parts of all configuration files are identical. 
  37. But there are some macros that vary:
  38.  
  39. `FAILURE_EXIT_CODE'
  40.      A C expression for the status code to be returned when the compiler
  41.      exits after serious errors.
  42.  
  43. `SUCCESS_EXIT_CODE'
  44.      A C expression for the status code to be returned when the compiler
  45.      exits without serious errors.
  46.  
  47. `USE_C_ALLOCA'
  48.      Define this macro to indicate that the compiler is running with the
  49.      `alloca' implemented in C.  This version of `alloca' can be found
  50.      in the file `alloca.c'; to use it, you must also alter the
  51.      `Makefile' variable `ALLOCA'.
  52.  
  53.      This macro, unlike most, describes the machine that the compiler is
  54.      running on, rather than the one the compiler is compiling for.
  55.      Therefore, it should be set in the `xm-MACHINE.h' file rather than
  56.      in the `tm-MACHINE.h' file.
  57.  
  58.      If you do define this macro, you should probably do it as follows:
  59.  
  60.           #ifndef __GNUC__
  61.           #define USE_C_ALLOCA
  62.           #else
  63.           #define alloca __builtin_alloca
  64.           #endif
  65.  
  66.      so that when the compiler is compiled with GNU CC it uses the more
  67.      efficient built-in `alloca' function.
  68.  
  69.    In addition, configuration files for system V define `bcopy',
  70. `bzero' and `bcmp' as aliases.  Some files define `alloca' as a macro
  71. when compiled with GNU CC, in order to take advantage of the benefit of
  72. GNU CC's built-in `alloca'.
  73.  
  74.  
  75.