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