contrib/gcc-4.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 @paragraphindent 1
  25
  26 @c %**end of header
  27
  28 @copying
  29 Copyright @copyright{} 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
  30 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007,
  31 2008 Free Software Foundation, Inc.
  32
  33 Permission is granted to copy, distribute and/or modify this document
  34 under the terms of the GNU Free Documentation License, Version 1.2 or
  35 any later version published by the Free Software Foundation; with the
  36 Invariant Sections being ``Funding Free Software'', the Front-Cover
  37 Texts being (a) (see below), and with the Back-Cover Texts being (b)
  38 (see below).  A copy of the license is included in the section entitled
  39 ``GNU Free Documentation License''.
  40
  41 (a) The FSF's Front-Cover Text is:
  42
  43      A GNU Manual
  44
  45 (b) The FSF's Back-Cover Text is:
  46
  47      You have freedom to copy and modify this GNU Manual, like GNU
  48      software.  Copies published by the Free Software Foundation raise
  49      funds for GNU development.
  50 @end copying
  51 @ifnottex
  52 @dircategory Software development
  53 @direntry
  54 * gccint: (gccint).            Internals of the GNU Compiler Collection.
  55 @end direntry
  56 This file documents the internals of the GNU compilers.
  57 @sp 1
  58 @insertcopying
  59 @sp 1
  60 @end ifnottex
  61
  62 @setchapternewpage odd
  63 @titlepage
  64 @title GNU Compiler Collection Internals
  65 @versionsubtitle
  66 @author Richard M. Stallman and the @sc{GCC} Developer Community
  67 @page
  68 @vskip 0pt plus 1filll
  69 @insertcopying
  70 @end titlepage
  71 @summarycontents
  72 @contents
  73 @page
  74
  75 @node Top, Contributing,, (DIR)
  76 @top Introduction
  77 @cindex introduction
  78
  79 This manual documents the internals of the GNU compilers, including
  80 how to port them to new targets and some information about how to
  81 write front ends for new languages.  It corresponds to the compilers
  82 @ifset VERSION_PACKAGE
  83 @value{VERSION_PACKAGE}
  84 @end ifset
  85 version @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 * Options::         Option specification files.
 110 * Passes::          Order of passes, what they do, and what each file is for.
 111 * Trees::           The source representation used by the C and C++ front ends.
 112 * GENERIC::         Language-independent representation generated by Front Ends
 113 * GIMPLE::          Tuple representation used by Tree SSA optimizers
 114 * Tree SSA::        Analysis and optimization of GIMPLE
 115 * RTL::             Machine-dependent low-level intermediate representation.
 116 * Control Flow::    Maintaining and manipulating the control flow graph.
 117 * Loop Analysis and Representation:: Analysis and representation of loops
 118 * Machine Desc::    How to write machine description instruction patterns.
 119 * Target Macros::   How to write the machine description C macros and functions.
 120 * Host Config::     Writing the @file{xm-@var{machine}.h} file.
 121 * Fragments::       Writing the @file{t-@var{target}} and @file{x-@var{host}} files.
 122 * Collect2::        How @code{collect2} works; how it finds @code{ld}.
 123 * Header Dirs::     Understanding the standard header file directories.
 124 * Type Information:: GCC's memory management; generating type information.
 125
 126 * Funding::         How to help assure funding for free software.
 127 * GNU Project::     The GNU Project and GNU/Linux.
 128
 129 * Copying::         GNU General Public License says
 130                     how you can copy and share GCC.
 131 * GNU Free Documentation License:: How you can copy and share this manual.
 132 * Contributors::    People who have contributed to GCC.
 133
 134 * Option Index::    Index to command line options.
 135 * Concept Index::   Index of concepts and symbol names.
 136 @end menu
 137
 138 @include contribute.texi
 139 @include portability.texi
 140 @include interface.texi
 141 @include libgcc.texi
 142 @include languages.texi
 143 @include sourcebuild.texi
 144 @include options.texi
 145 @include passes.texi
 146 @include c-tree.texi
 147 @include rtl.texi
 148 @include generic.texi
 149 @include gimple.texi
 150 @include tree-ssa.texi
 151 @include loop.texi
 152 @include cfg.texi
 153 @include md.texi
 154 @include tm.texi
 155 @include hostconfig.texi
 156 @include fragments.texi
 157 @include collect2.texi
 158 @include headerdirs.texi
 159 @include gty.texi
 160
 161 @include funding.texi
 162 @include gnu.texi
 163 @include gpl_v3.texi
 164
 165 @c ---------------------------------------------------------------------
 166 @c GFDL
 167 @c ---------------------------------------------------------------------
 168
 169 @include fdl.texi
 170
 171 @include contrib.texi
 172
 173 @c ---------------------------------------------------------------------
 174 @c Indexes
 175 @c ---------------------------------------------------------------------
 176
 177 @node Option Index
 178 @unnumbered Option Index
 179
 180 GCC's command line options are indexed here without any initial @samp{-}
 181 or @samp{--}.  Where an option has both positive and negative forms
 182 (such as @option{-f@var{option}} and @option{-fno-@var{option}}),
 183 relevant entries in the manual are indexed under the most appropriate
 184 form; it may sometimes be useful to look up both forms.
 185
 186 @printindex op
 187
 188 @node Concept Index
 189 @unnumbered Concept Index
 190
 191 @printindex cp
 192
 193 @c ---------------------------------------------------------------------
 194 @c Epilogue
 195 @c ---------------------------------------------------------------------
 196
 197 @bye