gcc.texi revision 132718 
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@paragraphindent 1
39
40@c %**end of header
41
42@copying
43Copyright @copyright{} 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
441999, 2000, 2001, 2002, 2003, 2004 Free Software Foundation, Inc.
45
46Permission is granted to copy, distribute and/or modify this document
47under the terms of the GNU Free Documentation License, Version 1.2 or
48any later version published by the Free Software Foundation; with the
49Invariant Sections being ``GNU General Public License'' and ``Funding
50Free Software'', the Front-Cover texts being (a) (see below), and with
51the Back-Cover Texts being (b) (see below).  A copy of the license is
52included in the section entitled ``GNU Free Documentation License''.
53
54(a) The FSF's Front-Cover Text is:
55
56     A GNU Manual
57
58(b) The FSF's Back-Cover Text is:
59
60     You have freedom to copy and modify this GNU Manual, like GNU
61     software.  Copies published by the Free Software Foundation raise
62     funds for GNU development.
63@end copying
64@ifnottex
65@dircategory Programming
66@direntry
67* gcc: (gcc).                  The GNU Compiler Collection.
68@end direntry
69This file documents the use of the GNU compilers.
70@sp 1
71@insertcopying
72@sp 1
73@end ifnottex
74
75@setchapternewpage odd
76@shorttitlepage Using the GNU Compiler Collection (GCC)
77@titlepage
78@center @titlefont{Using the GNU Compiler Collection}
79@sp 2
80@center by Richard M. Stallman and the GCC Developer Community
81@sp 3
82@center Last updated 23 May 2004
83@sp 1
84
85@center for GCC @value{version-GCC}
86@page
87@vskip 0pt plus 1filll
88For GCC Version @value{version-GCC}@*
89@sp 1
90Published by:
91@multitable @columnfractions 0.5 0.5
92@item GNU Press
93@tab Website: www.gnupress.org
94@item a division of the
95@tab General: @tex press@@gnu.org @end tex
96@item Free Software Foundation
97@tab Orders:  @tex sales@@gnu.org @end tex
98@item 59 Temple Place Suite 330
99@tab Tel 617-542-5942
100@item Boston, MA 02111-1307 USA
101@tab Fax 617-542-2652
102@end multitable
103@sp 2
104@ifset FSFPRINT
105@c Update this ISBN when printing a new edition.
106@acronym{ISBN} 1-882114-39-6
107
108Cover art by Gary M. Torrisi.  Cover design by Jonathan Richard.
109@end ifset
110@ifclear FSFPRINT
111Last printed October 2003 for GCC 3.3.1.@*
112Printed copies are available for $45 each.
113@end ifclear
114@sp 1
115@insertcopying
116@end titlepage
117@summarycontents
118@contents
119@page
120
121@node Top, G++ and GCC,, (DIR)
122@top Introduction
123@cindex introduction
124
125This manual documents how to use the GNU compilers,
126as well as their features and incompatibilities, and how to report
127bugs.  It corresponds to GCC version @value{version-GCC}.
128The internals of the GNU compilers, including how to port them to new
129targets and some information about how to write front ends for new
130languages, are documented in a separate manual.  @xref{Top,,
131Introduction, gccint, GNU Compiler Collection (GCC) Internals}.
132
133@menu
134* G++ and GCC::     You can compile C or C++ programs.
135* Standards::       Language standards supported by GCC.
136* Invoking GCC::    Command options supported by @samp{gcc}.
137* C Implementation:: How GCC implements the ISO C specification.
138* C Extensions::    GNU extensions to the C language family.
139* C++ Extensions::  GNU extensions to the C++ language.
140* Objective-C::     GNU Objective-C runtime features.
141* Compatibility::   Binary Compatibility
142* Gcov::            @command{gcov}---a test coverage program.
143* Trouble::         If you have trouble using GCC.
144* Bugs::            How, why and where to report bugs.
145* Service::         How to find suppliers of support for GCC.
146* Contributing::    How to contribute to testing and developing GCC.
147
148* Funding::         How to help assure funding for free software.
149* GNU Project::     The GNU Project and GNU/Linux.
150
151* Copying::         GNU General Public License says
152                     how you can copy and share GCC.
153* GNU Free Documentation License:: How you can copy and share this manual.
154* Contributors::    People who have contributed to GCC.
155
156* Option Index::    Index to command line options.
157* Keyword Index::    Index of concepts and symbol names.
158@end menu
159
160@include frontends.texi
161@include standards.texi
162@include invoke.texi
163@include extend.texi
164@include objc.texi
165@include compat.texi
166@include gcov.texi
167@include trouble.texi
168@include bugreport.texi
169@include service.texi
170@include contribute.texi
171
172@include funding.texi
173@include gnu.texi
174@include gpl.texi
175
176@c ---------------------------------------------------------------------
177@c GFDL
178@c ---------------------------------------------------------------------
179
180@include fdl.texi
181
182@include contrib.texi
183
184@c ---------------------------------------------------------------------
185@c Indexes
186@c ---------------------------------------------------------------------
187
188@node Option Index
189@unnumbered Option Index
190
191GCC's command line options are indexed here without any initial @samp{-}
192or @samp{--}.  Where an option has both positive and negative forms
193(such as @option{-f@var{option}} and @option{-fno-@var{option}}),
194relevant entries in the manual are indexed under the most appropriate
195form; it may sometimes be useful to look up both forms.
196
197@printindex op
198
199@node Keyword Index
200@unnumbered Keyword Index
201
202@printindex cp
203
204@c ---------------------------------------------------------------------
205@c Epilogue
206@c ---------------------------------------------------------------------
207
208@bye
209