contrib/gcc-3.4/gcc/doc/gccint.texi

   1 \input texinfo  @c -*-texinfo-*-
   2 @c %**start of header
   3 @setfilename gccint.info
   4 @c INTERNALS is used by md.texi to determine whether to include the
   5 @c whole of that file, in the internals manual, or only the part
   6 @c dealing with constraints, in the user manual.
   7 @set INTERNALS
   8
   9 @c See miscellaneous notes in gcc.texi on checks/things to do.
  10
  11 @include gcc-common.texi
  12
  13 @settitle GNU Compiler Collection (GCC) Internals
  14
  15 @c Create a separate index for command line options.
  16 @defcodeindex op
  17 @c Merge the standard indexes into a single one.
  18 @syncodeindex fn cp
  19 @syncodeindex vr cp
  20 @syncodeindex ky cp
  21 @syncodeindex pg cp
  22 @syncodeindex tp cp
  23
  24 @c %**end of header
  25
  26 @copying
  27 Copyright @copyright{} 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
  28 1999, 2000, 2001, 2002, 2003 Free Software Foundation, Inc.
  29
  30 Permission is granted to copy, distribute and/or modify this document
  31 under the terms of the GNU Free Documentation License, Version 1.2 or
  32 any later version published by the Free Software Foundation; with the
  33 Invariant Sections being ``GNU General Public License'' and ``Funding
  34 Free Software'', the Front-Cover texts being (a) (see below), and with
  35 the Back-Cover Texts being (b) (see below).  A copy of the license is
  36 included in the section entitled ``GNU Free Documentation License''.
  37
  38 (a) The FSF's Front-Cover Text is:
  39
  40      A GNU Manual
  41
  42 (b) The FSF's Back-Cover Text is:
  43
  44      You have freedom to copy and modify this GNU Manual, like GNU
  45      software.  Copies published by the Free Software Foundation raise
  46      funds for GNU development.
  47 @end copying
  48 @ifnottex
  49 @dircategory Programming
  50 @direntry
  51 * gccint: (gccint).            Internals of the GNU Compiler Collection.
  52 @end direntry
  53 This file documents the internals of the GNU compilers.
  54 @sp 1
  55 @insertcopying
  56 @end ifnottex
  57
  58 @setchapternewpage odd
  59 @titlepage
  60 @center @titlefont{GNU Compiler Collection Internals}
  61 @sp 2
  62 @center by Richard M. Stallman and the GCC Developer Community
  63 @sp 3
  64 @center Last updated 23 May 2004
  65 @sp 1
  66
  67 @center for GCC @value{version-GCC}
  68 @page
  69 @vskip 0pt plus 1filll
  70 For GCC Version @value{version-GCC}@*
  71 @sp 1
  72 @insertcopying
  73 @end titlepage
  74 @summarycontents
  75 @contents
  76 @page
  77
  78 @node Top, Contributing,, (DIR)
  79 @top Introduction
  80 @cindex introduction
  81
  82 This manual documents the internals of the GNU compilers, including
  83 how to port them to new targets and some information about how to
  84 write front ends for new languages.  It corresponds to GCC version
  85 @value{version-GCC}.  The use of the GNU compilers is documented in a
  86 separate manual.  @xref{Top,, Introduction, gcc, Using the GNU
  87 Compiler Collection (GCC)}.
  88
  89 This manual is mainly a reference manual rather than a tutorial.  It
  90 discusses how to contribute to GCC (@pxref{Contributing}), the
  91 characteristics of the machines supported by GCC as hosts and targets
  92 (@pxref{Portability}), how GCC relates to the ABIs on such systems
  93 (@pxref{Interface}), and the characteristics of the languages for
  94 which GCC front ends are written (@pxref{Languages}).  It then
  95 describes the GCC source tree structure and build system, some of the
  96 interfaces to GCC front ends, and how support for a target system is
  97 implemented in GCC@.
  98
  99 Additional tutorial information is linked to from
 100 @uref{http://gcc.gnu.org/readings.html}.
 101
 102 @menu
 103 * Contributing::    How to contribute to testing and developing GCC.
 104 * Portability::     Goals of GCC's portability features.
 105 * Interface::       Function-call interface of GCC output.
 106 * Libgcc::          Low-level runtime library used by GCC.
 107 * Languages::       Languages for which GCC front ends are written.
 108 * Source Tree::     GCC source tree structure and build system.
 109 * Passes::          Order of passes, what they do, and what each file is for.
 110 * Trees::           The source representation used by the C and C++ front ends.
 111 * RTL::             The intermediate representation that most passes work on.
 112 * Machine Desc::    How to write machine description instruction patterns.
 113 * Target Macros::   How to write the machine description C macros and functions.
 114 * Host Config::     Writing the @file{xm-@var{machine}.h} file.
 115 * Fragments::       Writing the @file{t-@var{target}} and @file{x-@var{host}} files.
 116 * Collect2::        How @code{collect2} works; how it finds @code{ld}.
 117 * Header Dirs::     Understanding the standard header file directories.
 118 * Type Information:: GCC's memory management; generating type information.
 119
 120 * Funding::         How to help assure funding for free software.
 121 * GNU Project::     The GNU Project and GNU/Linux.
 122
 123 * Copying::         GNU General Public License says
 124                      how you can copy and share GCC.
 125 * GNU Free Documentation License:: How you can copy and share this manual.
 126 * Contributors::    People who have contributed to GCC.
 127
 128 * Option Index::    Index to command line options.
 129 * Index::           Index of concepts and symbol names.
 130 @end menu
 131
 132 @include contribute.texi
 133 @include portability.texi
 134 @include interface.texi
 135 @include libgcc.texi
 136 @include languages.texi
 137 @include sourcebuild.texi
 138 @include passes.texi
 139 @include c-tree.texi
 140 @include rtl.texi
 141 @include md.texi
 142 @include tm.texi
 143 @include hostconfig.texi
 144 @include fragments.texi
 145 @include collect2.texi
 146 @include headerdirs.texi
 147 @include gty.texi
 148
 149 @include funding.texi
 150 @include gnu.texi
 151 @include gpl.texi
 152
 153 @c ---------------------------------------------------------------------
 154 @c GFDL
 155 @c ---------------------------------------------------------------------
 156
 157 @include fdl.texi
 158
 159 @include contrib.texi
 160
 161 @c ---------------------------------------------------------------------
 162 @c Indexes
 163 @c ---------------------------------------------------------------------
 164
 165 @node Option Index
 166 @unnumbered Option Index
 167
 168 GCC's command line options are indexed here without any initial @samp{-}
 169 or @samp{--}.  Where an option has both positive and negative forms
 170 (such as @option{-f@var{option}} and @option{-fno-@var{option}}),
 171 relevant entries in the manual are indexed under the most appropriate
 172 form; it may sometimes be useful to look up both forms.
 173
 174 @printindex op
 175
 176 @node Index
 177 @unnumbered Index
 178
 179 @printindex cp
 180
 181 @c ---------------------------------------------------------------------
 182 @c Epilogue
 183 @c ---------------------------------------------------------------------
 184
 185 @bye