Merge branch 'master' of ssh://crater.dragonflybsd.org/repository/git/dragonfly
[dragonfly.git] / contrib / gcc-3.4 / 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 @paragraphindent 1
39
40 @c %**end of header
41
42 @copying
43 Copyright @copyright{} 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
44 1999, 2000, 2001, 2002, 2003, 2004 Free Software Foundation, Inc.
45
46 Permission is granted to copy, distribute and/or modify this document
47 under the terms of the GNU Free Documentation License, Version 1.2 or
48 any later version published by the Free Software Foundation; with the
49 Invariant Sections being ``GNU General Public License'' and ``Funding
50 Free Software'', the Front-Cover texts being (a) (see below), and with
51 the Back-Cover Texts being (b) (see below).  A copy of the license is
52 included 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
69 This 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
88 For GCC Version @value{version-GCC}@*
89 @sp 1
90 Published 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
108 Cover art by Gary M. Torrisi.  Cover design by Jonathan Richard.
109 @end ifset
110 @ifclear FSFPRINT
111 Last printed October 2003 for GCC 3.3.1.@*
112 Printed 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
125 This manual documents how to use the GNU compilers,
126 as well as their features and incompatibilities, and how to report
127 bugs.  It corresponds to GCC version @value{version-GCC}.
128 The internals of the GNU compilers, including how to port them to new
129 targets and some information about how to write front ends for new
130 languages, are documented in a separate manual.  @xref{Top,,
131 Introduction, 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
191 GCC's command line options are indexed here without any initial @samp{-}
192 or @samp{--}.  Where an option has both positive and negative forms
193 (such as @option{-f@var{option}} and @option{-fno-@var{option}}),
194 relevant entries in the manual are indexed under the most appropriate
195 form; 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