1 \input texinfo @c -*-texinfo-*-
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.
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.
17 @c Merge the standard indexes into a single one.
29 Copyright @copyright{} 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
30 1999, 2000, 2001, 2002, 2003, 2004, 2005 Free Software Foundation, Inc.
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''.
40 (a) The FSF's Front-Cover Text is:
44 (b) The FSF's Back-Cover Text is:
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.
51 @dircategory Software development
53 * gccint: (gccint). Internals of the GNU Compiler Collection.
55 This file documents the internals of the GNU compilers.
61 @setchapternewpage odd
62 @shorttitlepage GNU Compiler Collection Internals (GCC)
64 @center @titlefont{GNU Compiler Collection Internals}
66 @center by Richard M. Stallman and the GCC Developer Community
68 @vskip 0pt plus 1filll
69 For GCC Version @value{version-GCC}@*
77 @node Top, Contributing,, (DIR)
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)}.
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
98 Additional tutorial information is linked to from
99 @uref{http://gcc.gnu.org/readings.html}.
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 Analysis and 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.
123 * Funding:: How to help assure funding for free software.
124 * GNU Project:: The GNU Project and GNU/Linux.
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.
131 * Option Index:: Index to command line options.
132 * Concept Index:: Index of concepts and symbol names.
135 @include contribute.texi
136 @include portability.texi
137 @include interface.texi
139 @include languages.texi
140 @include sourcebuild.texi
141 @include options.texi
144 @include tree-ssa.texi
150 @include hostconfig.texi
151 @include fragments.texi
152 @include collect2.texi
153 @include headerdirs.texi
156 @include funding.texi
160 @c ---------------------------------------------------------------------
162 @c ---------------------------------------------------------------------
166 @include contrib.texi
168 @c ---------------------------------------------------------------------
170 @c ---------------------------------------------------------------------
173 @unnumbered Option Index
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.
184 @unnumbered Concept Index
188 @c ---------------------------------------------------------------------
190 @c ---------------------------------------------------------------------