OSDN Git Service

a682ee338221e56b9f0a4e9690306892f6bd4c97
[pf3gnuchains/gcc-fork.git] / gcc / doc / gcc.texi
1 \input texinfo  @c -*-texinfo-*-
2 @c %**start of header
3 @setfilename gcc.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 @clear INTERNALS
8
9 @c NOTE: checks/things to do:
10 @c
11 @c -have bob do a search in all seven files for "mew" (ideally --mew,
12 @c  but i may have forgotten the occasional "--"..).
13 @c     Just checked... all have `--'!  Bob 22Jul96
14 @c     Use this to search:   grep -n '\-\-mew' *.texi
15 @c -item/itemx, text after all (sub/sub)section titles, etc..
16 @c -consider putting the lists of options on pp 17--> etc in columns or
17 @c  some such.
18 @c -overfulls.  do a search for "mew" in the files, and you will see
19 @c   overfulls that i noted but could not deal with.
20 @c -have to add text:  beginning of chapter 8
21
22 @c
23 @c anything else?                       --mew 10feb93
24
25 @include gcc-common.texi
26
27 @settitle Using the GNU Compiler Collection (GCC)
28
29 @c Create a separate index for command line options.
30 @defcodeindex op
31 @c Merge the standard indexes into a single one.
32 @syncodeindex fn cp
33 @syncodeindex vr cp
34 @syncodeindex ky cp
35 @syncodeindex pg cp
36 @syncodeindex tp cp
37
38 @c %**end of header
39
40 @c Use with @@smallbook.
41
42 @c Cause even numbered pages to be printed on the left hand side of
43 @c the page and odd numbered pages to be printed on the right hand
44 @c side of the page.  Using this, you can print on both sides of a
45 @c sheet of paper and have the text on the same part of the sheet.
46
47 @c The text on right hand pages is pushed towards the right hand
48 @c margin and the text on left hand pages is pushed toward the left
49 @c hand margin.
50 @c (To provide the reverse effect, set bindingoffset to -0.75in.)
51
52 @c @tex
53 @c \global\bindingoffset=0.75in
54 @c \global\normaloffset =0.75in
55 @c @end tex
56
57 @copying
58 Copyright @copyright{} 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
59 1999, 2000, 2001, 2002, 2003, 2004 Free Software Foundation, Inc.
60
61 Permission is granted to copy, distribute and/or modify this document
62 under the terms of the GNU Free Documentation License, Version 1.2 or
63 any later version published by the Free Software Foundation; with the
64 Invariant Sections being ``GNU General Public License'' and ``Funding
65 Free Software'', the Front-Cover texts being (a) (see below), and with
66 the Back-Cover Texts being (b) (see below).  A copy of the license is
67 included in the section entitled ``GNU Free Documentation License''.
68
69 (a) The FSF's Front-Cover Text is:
70
71      A GNU Manual
72
73 (b) The FSF's Back-Cover Text is:
74
75      You have freedom to copy and modify this GNU Manual, like GNU
76      software.  Copies published by the Free Software Foundation raise
77      funds for GNU development.
78 @end copying
79 @ifnottex
80 @dircategory Programming
81 @direntry
82 * gcc: (gcc).                  The GNU Compiler Collection.
83 @end direntry
84 This file documents the use of the GNU compilers.
85 @sp 1
86 Published by the Free Software Foundation@*
87 59 Temple Place - Suite 330@*
88 Boston, MA 02111-1307 USA
89 @sp 1
90 @insertcopying
91 @sp 1
92 @end ifnottex
93
94 @setchapternewpage odd
95 @titlepage
96 @center @titlefont{Using the GNU Compiler Collection}
97 @sp 2
98 @center Richard M. Stallman
99 @sp 3
100 @center Last updated 2 January 2004
101 @sp 1
102
103 @center for GCC @value{version-GCC}
104 @page
105 @vskip 0pt plus 1filll
106 For GCC Version @value{version-GCC}@*
107 @sp 1
108 Published by the Free Software Foundation @*
109 59 Temple Place---Suite 330@*
110 Boston, MA 02111-1307, USA@*
111 Last printed April, 1998.@*
112 Printed copies are available for $50 each.@*
113 @c Update this ISBN when printing a new edition.
114 @ifset FSFPRINT
115 ISBN 1-882114-37-X
116 @end ifset
117 @sp 1
118 @insertcopying
119 @end titlepage
120 @summarycontents
121 @contents
122 @page
123
124 @node Top, G++ and GCC,, (DIR)
125 @top Introduction
126 @cindex introduction
127
128 This manual documents how to use the GNU compilers,
129 as well as their features and incompatibilities, and how to report
130 bugs.  It corresponds to GCC version @value{version-GCC}.
131 The internals of the GNU compilers, including how to port them to new
132 targets and some information about how to write front ends for new
133 languages, are documented in a separate manual.  @xref{Top,,
134 Introduction, gccint, GNU Compiler Collection (GCC) Internals}.
135
136 @menu
137 * G++ and GCC::     You can compile C or C++ programs.
138 * Standards::       Language standards supported by GCC.
139 * Invoking GCC::    Command options supported by @samp{gcc}.
140 * C Implementation:: How GCC implements the ISO C specification.
141 * C Extensions::    GNU extensions to the C language family.
142 * C++ Extensions::  GNU extensions to the C++ language.
143 * Objective-C::     GNU Objective-C runtime features.
144 * Compatibility::   Binary Compatibility
145 * Gcov::            @command{gcov}---a test coverage program.
146 * Trouble::         If you have trouble using GCC.
147 * Bugs::            How, why and where to report bugs.
148 * Service::         How to find suppliers of support for GCC.
149 * Contributing::    How to contribute to testing and developing GCC.
150
151 * Funding::         How to help assure funding for free software.
152 * GNU Project::     The GNU Project and GNU/Linux.
153
154 * Copying::         GNU General Public License says
155                      how you can copy and share GCC.
156 * GNU Free Documentation License:: How you can copy and share this manual.
157 * Contributors::    People who have contributed to GCC.
158
159 * Option Index::    Index to command line options.
160 * Keyword Index::    Index of concepts and symbol names.
161 @end menu
162
163 @include frontends.texi
164 @include standards.texi
165 @include invoke.texi
166 @include extend.texi
167 @include objc.texi
168 @include compat.texi
169 @include gcov.texi
170 @include trouble.texi
171 @include bugreport.texi
172 @include service.texi
173 @include contribute.texi
174
175 @include funding.texi
176 @include gnu.texi
177 @include gpl.texi
178
179 @c ---------------------------------------------------------------------
180 @c GFDL
181 @c ---------------------------------------------------------------------
182
183 @include fdl.texi
184
185 @include contrib.texi
186
187 @c ---------------------------------------------------------------------
188 @c Indexes
189 @c ---------------------------------------------------------------------
190
191 @node Option Index
192 @unnumbered Option Index
193
194 GCC's command line options are indexed here without any initial @samp{-}
195 or @samp{--}.  Where an option has both positive and negative forms
196 (such as @option{-f@var{option}} and @option{-fno-@var{option}}),
197 relevant entries in the manual are indexed under the most appropriate
198 form; it may sometimes be useful to look up both forms.
199
200 @printindex op
201
202 @node Keyword Index
203 @unnumbered Keyword Index
204
205 @printindex cp
206
207 @c ---------------------------------------------------------------------
208 @c Epilogue
209 @c ---------------------------------------------------------------------
210
211 @bye