Check in tree-dce enh to trunk
[official-gcc.git] / gcc / doc / gccint.texi
blob47e02214f09871e3c29ec5c2d84a94adfb31eb2c
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
9 @c See miscellaneous notes in gcc.texi on checks/things to do.
11 @include gcc-common.texi
13 @settitle GNU Compiler Collection (GCC) Internals
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
24 @paragraphindent 1
26 @c %**end of header
28 @copying
29 Copyright @copyright{} 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
30 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
31 2007 Free Software Foundation, Inc.
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 ``GNU General Public License'' and ``Funding
37 Free Software'', the Front-Cover texts being (a) (see below), and with
38 the Back-Cover Texts being (b) (see below).  A copy of the license is
39 included in the section entitled ``GNU Free Documentation License''.
41 (a) The FSF's Front-Cover Text is:
43      A GNU Manual
45 (b) The FSF's Back-Cover Text is:
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
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
75 @node Top, Contributing,, (DIR)
76 @top Introduction
77 @cindex introduction
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)}.
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@.
99 Additional tutorial information is linked to from
100 @uref{http://gcc.gnu.org/readings.html}.
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 * RTL::             The intermediate representation that most passes work on.
113 * Control Flow::    Maintaining and manipulating the control flow graph.
114 * Tree SSA::        Analysis and optimization of the tree representation.
115 * Loop Analysis and Representation:: Analysis and representation of loops
116 * Machine Desc::    How to write machine description instruction patterns.
117 * Target Macros::   How to write the machine description C macros and functions.
118 * Host Config::     Writing the @file{xm-@var{machine}.h} file.
119 * Fragments::       Writing the @file{t-@var{target}} and @file{x-@var{host}} files.
120 * Collect2::        How @code{collect2} works; how it finds @code{ld}.
121 * Header Dirs::     Understanding the standard header file directories.
122 * Type Information:: GCC's memory management; generating type information.
124 * Funding::         How to help assure funding for free software.
125 * GNU Project::     The GNU Project and GNU/Linux.
127 * Copying::         GNU General Public License says
128                      how you can copy and share GCC.
129 * GNU Free Documentation License:: How you can copy and share this manual.
130 * Contributors::    People who have contributed to GCC.
132 * Option Index::    Index to command line options.
133 * Concept Index::   Index of concepts and symbol names.
134 @end menu
136 @include contribute.texi
137 @include portability.texi
138 @include interface.texi
139 @include libgcc.texi
140 @include languages.texi
141 @include sourcebuild.texi
142 @include options.texi
143 @include passes.texi
144 @include c-tree.texi
145 @include tree-ssa.texi
146 @include loop.texi
147 @include rtl.texi
148 @include cfg.texi
149 @include md.texi
150 @include tm.texi
151 @include hostconfig.texi
152 @include fragments.texi
153 @include collect2.texi
154 @include headerdirs.texi
155 @include gty.texi
157 @include funding.texi
158 @include gnu.texi
159 @include gpl_v3.texi
161 @c ---------------------------------------------------------------------
162 @c GFDL
163 @c ---------------------------------------------------------------------
165 @include fdl.texi
167 @include contrib.texi
169 @c ---------------------------------------------------------------------
170 @c Indexes
171 @c ---------------------------------------------------------------------
173 @node Option Index
174 @unnumbered Option Index
176 GCC's command line options are indexed here without any initial @samp{-}
177 or @samp{--}.  Where an option has both positive and negative forms
178 (such as @option{-f@var{option}} and @option{-fno-@var{option}}),
179 relevant entries in the manual are indexed under the most appropriate
180 form; it may sometimes be useful to look up both forms.
182 @printindex op
184 @node Concept Index
185 @unnumbered Concept Index
187 @printindex cp
189 @c ---------------------------------------------------------------------
190 @c Epilogue
191 @c ---------------------------------------------------------------------
193 @bye