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 Free Software Foundation, Inc.
  31
  32 Permission is granted to copy, distribute and/or modify this document
  33 under the terms of the GNU Free Documentation License, Version 1.2 or
  34 any later version published by the Free Software Foundation; with the
  35 Invariant Sections being ``GNU General Public License'' and ``Funding
  36 Free Software'', the Front-Cover texts being (a) (see below), and with
  37 the Back-Cover Texts being (b) (see below).  A copy of the license is
  38 included in the section entitled ``GNU Free Documentation License''.
  39
  40 (a) The FSF's Front-Cover Text is:
  41
  42      A GNU Manual
  43
  44 (b) The FSF's Back-Cover Text is:
  45
  46      You have freedom to copy and modify this GNU Manual, like GNU
  47      software.  Copies published by the Free Software Foundation raise
  48      funds for GNU development.
  49 @end copying
  50 @ifnottex
  51 @dircategory Software development
  52 @direntry
  53 * gccint: (gccint).            Internals of the GNU Compiler Collection.
  54 @end direntry
  55 This file documents the internals of the GNU compilers.
  56 @sp 1
  57 @insertcopying
  58 @sp 1
  59 @end ifnottex
  60
  61 @setchapternewpage odd
  62 @shorttitlepage GNU Compiler Collection Internals (GCC)
  63 @titlepage
  64 @center @titlefont{GNU Compiler Collection Internals}
  65 @sp 2
  66 @center by Richard M. Stallman and the GCC Developer Community
  67 @page
  68 @vskip 0pt plus 1filll
  69 For GCC Version @value{version-GCC}@*
  70 @sp 1
  71 @insertcopying
  72 @end titlepage
  73 @summarycontents
  74 @contents
  75 @page
  76
  77 @node Top, Contributing,, (DIR)
  78 @top Introduction
  79 @cindex introduction
  80
  81 This manual documents the internals of the GNU compilers, including
  82 how to port them to new targets and some information about how to
  83 write front ends for new languages.  It corresponds to GCC version
  84 @value{version-GCC}.  The use of the GNU compilers is documented in a
  85 separate manual.  @xref{Top,, Introduction, gcc, Using the GNU
  86 Compiler Collection (GCC)}.
  87
  88 This manual is mainly a reference manual rather than a tutorial.  It
  89 discusses how to contribute to GCC (@pxref{Contributing}), the
  90 characteristics of the machines supported by GCC as hosts and targets
  91 (@pxref{Portability}), how GCC relates to the ABIs on such systems
  92 (@pxref{Interface}), and the characteristics of the languages for
  93 which GCC front ends are written (@pxref{Languages}).  It then
  94 describes the GCC source tree structure and build system, some of the
  95 interfaces to GCC front ends, and how support for a target system is
  96 implemented in GCC@.
  97
  98 Additional tutorial information is linked to from
  99 @uref{http://gcc.gnu.org/readings.html}.
 100
 101 @menu
 102 * Contributing::    How to contribute to testing and developing GCC.
 103 * Portability::     Goals of GCC's portability features.
 104 * Interface::       Function-call interface of GCC output.
 105 * Libgcc::          Low-level runtime library used by GCC.
 106 * Languages::       Languages for which GCC front ends are written.
 107 * Source Tree::     GCC source tree structure and build system.
 108 * Options::         Option specification files.
 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 * Control Flow::    Maintaining and manipulating the control flow graph.
 113 * Tree SSA::        Analysis and optimization of the tree representation.
 114 * Loop Representation:: Analysis and representation of loops
 115 * Machine Desc::    How to write machine description instruction patterns.
 116 * Target Macros::   How to write the machine description C macros and functions.
 117 * Host Config::     Writing the @file{xm-@var{machine}.h} file.
 118 * Fragments::       Writing the @file{t-@var{target}} and @file{x-@var{host}} files.
 119 * Collect2::        How @code{collect2} works; how it finds @code{ld}.
 120 * Header Dirs::     Understanding the standard header file directories.
 121 * Type Information:: GCC's memory management; generating type information.
 122
 123 * Funding::         How to help assure funding for free software.
 124 * GNU Project::     The GNU Project and GNU/Linux.
 125
 126 * Copying::         GNU General Public License says
 127                      how you can copy and share GCC.
 128 * GNU Free Documentation License:: How you can copy and share this manual.
 129 * Contributors::    People who have contributed to GCC.
 130
 131 * Option Index::    Index to command line options.
 132 * Concept Index::   Index of concepts and symbol names.
 133 @end menu
 134
 135 @include contribute.texi
 136 @include portability.texi
 137 @include interface.texi
 138 @include libgcc.texi
 139 @include languages.texi
 140 @include sourcebuild.texi
 141 @include options.texi
 142 @include passes.texi
 143 @include c-tree.texi
 144 @include tree-ssa.texi
 145 @include loop.texi
 146 @include rtl.texi
 147 @include cfg.texi
 148 @include md.texi
 149 @include tm.texi
 150 @include hostconfig.texi
 151 @include fragments.texi
 152 @include collect2.texi
 153 @include headerdirs.texi
 154 @include gty.texi
 155
 156 @include funding.texi
 157 @include gnu.texi
 158 @include gpl.texi
 159
 160 @c ---------------------------------------------------------------------
 161 @c GFDL
 162 @c ---------------------------------------------------------------------
 163
 164 @include fdl.texi
 165
 166 @include contrib.texi
 167
 168 @c ---------------------------------------------------------------------
 169 @c Indexes
 170 @c ---------------------------------------------------------------------
 171
 172 @node Option Index
 173 @unnumbered Option Index
 174
 175 GCC's command line options are indexed here without any initial @samp{-}
 176 or @samp{--}.  Where an option has both positive and negative forms
 177 (such as @option{-f@var{option}} and @option{-fno-@var{option}}),
 178 relevant entries in the manual are indexed under the most appropriate
 179 form; it may sometimes be useful to look up both forms.
 180
 181 @printindex op
 182
 183 @node Concept Index
 184 @unnumbered Concept Index
 185
 186 @printindex cp
 187
 188 @c ---------------------------------------------------------------------
 189 @c Epilogue
 190 @c ---------------------------------------------------------------------
 191
 192 @bye