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 @c Use with @@smallbook.
  27
  28 @c Cause even numbered pages to be printed on the left hand side of
  29 @c the page and odd numbered pages to be printed on the right hand
  30 @c side of the page.  Using this, you can print on both sides of a
  31 @c sheet of paper and have the text on the same part of the sheet.
  32
  33 @c The text on right hand pages is pushed towards the right hand
  34 @c margin and the text on left hand pages is pushed toward the left
  35 @c hand margin.
  36 @c (To provide the reverse effect, set bindingoffset to -0.75in.)
  37
  38 @c @tex
  39 @c \global\bindingoffset=0.75in
  40 @c \global\normaloffset =0.75in
  41 @c @end tex
  42
  43 @c Change the font used for @def... commands, since the default
  44 @c proportional one used is bad for names starting __.
  45 @tex
  46 \global\setfont\defbf\ttbshape{10}{\magstep1}
  47 @end tex
  48
  49 @macro copyrightnotice
  50 Copyright @copyright{} 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
  51 1999, 2000, 2001, 2002 Free Software Foundation, Inc.
  52 @end macro
  53 @ifnottex
  54 @dircategory Programming
  55 @direntry
  56 * gccint: (gccint).            Internals of the GNU Compiler Collection.
  57 @end direntry
  58 This file documents the internals of the GNU compilers.
  59 @sp 1
  60 Published by the Free Software Foundation@*
  61 59 Temple Place - Suite 330@*
  62 Boston, MA 02111-1307 USA
  63 @sp 1
  64 @copyrightnotice{}
  65 @sp 1
  66 Permission is granted to copy, distribute and/or modify this document
  67 under the terms of the GNU Free Documentation License, Version 1.1 or
  68 any later version published by the Free Software Foundation; with the
  69 Invariant Sections being ``GNU General Public License'' and ``Funding
  70 Free Software'', the Front-Cover texts being (a) (see below), and with
  71 the Back-Cover Texts being (b) (see below).  A copy of the license is
  72 included in the section entitled ``GNU Free Documentation License''.
  73
  74 (a) The FSF's Front-Cover Text is:
  75
  76      A GNU Manual
  77
  78 (b) The FSF's Back-Cover Text is:
  79
  80      You have freedom to copy and modify this GNU Manual, like GNU
  81      software.  Copies published by the Free Software Foundation raise
  82      funds for GNU development.
  83 @end ifnottex
  84
  85 @setchapternewpage odd
  86 @titlepage
  87 @center @titlefont{GNU Compiler Collection Internals}
  88 @sp 2
  89 @center Richard M. Stallman
  90 @sp 3
  91 @center Last updated 7 January 2002
  92 @sp 1
  93
  94 @center for GCC @value{version-GCC}
  95 @page
  96 @vskip 0pt plus 1filll
  97 @copyrightnotice{}
  98 @sp 2
  99 For GCC Version @value{version-GCC}@*
 100 @sp 1
 101 Published by the Free Software Foundation @*
 102 59 Temple Place---Suite 330@*
 103 Boston, MA 02111-1307, USA@*
 104 Last printed April, 1998.@*
 105 Printed copies are available for $50 each.@*
 106 @c Update this ISBN when printing a new edition.
 107 @ifset FSFPRINT
 108 ISBN 1-882114-37-X
 109 @end ifset
 110 @sp 1
 111 Permission is granted to copy, distribute and/or modify this document
 112 under the terms of the GNU Free Documentation License, Version 1.1 or
 113 any later version published by the Free Software Foundation; with the
 114 Invariant Sections being ``GNU General Public License'', the Front-Cover
 115 texts being (a) (see below), and with the Back-Cover Texts being (b)
 116 (see below).  A copy of the license is included in the section entitled
 117 ``GNU Free Documentation License''.
 118
 119 (a) The FSF's Front-Cover Text is:
 120
 121      A GNU Manual
 122
 123 (b) The FSF's Back-Cover Text is:
 124
 125      You have freedom to copy and modify this GNU Manual, like GNU
 126      software.  Copies published by the Free Software Foundation raise
 127      funds for GNU development.
 128 @end titlepage
 129 @summarycontents
 130 @contents
 131 @page
 132
 133 @node Top, Contributing,, (DIR)
 134 @top Introduction
 135 @cindex introduction
 136
 137 This manual documents the internals of the GNU compilers, including
 138 how to port them to new targets and some information about how to
 139 write front ends for new languages.  It corresponds to GCC version
 140 @value{version-GCC}.  The use of the GNU compilers is documented in a
 141 separate manual.  @xref{Top,, Introduction, gcc, Using the GNU
 142 Compiler Collection (GCC)}.
 143
 144 @menu
 145 * Contributing::    How to contribute to testing and developing GCC.
 146 * Makefile::        Additional Makefile and configure information.
 147 * Portability::     Goals of GCC's portability features.
 148 * Interface::       Function-call interface of GCC output.
 149 * Passes::          Order of passes, what they do, and what each file is for.
 150 * Trees::           The source representation used by the C and C++ front ends.
 151 * RTL::             The intermediate representation that most passes work on.
 152 * Machine Desc::    How to write machine description instruction patterns.
 153 * Target Macros::   How to write the machine description C macros and functions.
 154 * Config::          Writing the @file{xm-@var{machine}.h} file.
 155 * Fragments::       Writing the @file{t-@var{target}} and @file{x-@var{host}} files.
 156 * Configuration Files::  Files created by running @code{configure}.
 157 * Collect2::        How @code{collect2} works; how it finds @code{ld}.
 158 * Header Dirs::     Understanding the standard header file directories.
 159
 160 * Funding::         How to help assure funding for free software.
 161 * GNU Project::     The GNU Project and GNU/Linux.
 162
 163 * Copying::         GNU General Public License says
 164                      how you can copy and share GCC.
 165 * GNU Free Documentation License:: How you can copy and share this manual.
 166 * Contributors::    People who have contributed to GCC.
 167
 168 * Option Index::    Index to command line options.
 169 * Index::           Index of concepts and symbol names.
 170 @end menu
 171
 172 @include contribute.texi
 173 @include makefile.texi
 174 @include configterms.texi
 175 @include portability.texi
 176 @include interface.texi
 177 @include passes.texi
 178 @include c-tree.texi
 179 @include rtl.texi
 180 @include md.texi
 181 @include tm.texi
 182 @include hostconfig.texi
 183 @include fragments.texi
 184 @include configfiles.texi
 185 @include collect2.texi
 186 @include headerdirs.texi
 187
 188 @include funding.texi
 189 @include gnu.texi
 190 @include gpl.texi
 191
 192 @c ---------------------------------------------------------------------
 193 @c GFDL
 194 @c ---------------------------------------------------------------------
 195
 196 @include fdl.texi
 197
 198 @include contrib.texi
 199
 200 @c ---------------------------------------------------------------------
 201 @c Indexes
 202 @c ---------------------------------------------------------------------
 203
 204 @node Option Index
 205 @unnumbered Option Index
 206
 207 GCC's command line options are indexed here without any initial @samp{-}
 208 or @samp{--}.  Where an option has both positive and negative forms
 209 (such as @option{-f@var{option}} and @option{-fno-@var{option}}),
 210 relevant entries in the manual are indexed under the most appropriate
 211 form; it may sometimes be useful to look up both forms.
 212
 213 @printindex op
 214
 215 @node Index
 216 @unnumbered Index
 217
 218 @printindex cp
 219
 220 @c ---------------------------------------------------------------------
 221 @c Epilogue
 222 @c ---------------------------------------------------------------------
 223
 224 @bye