1 \input texinfo @c -*-texinfo-*-
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 NOTE: checks/things to do:
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
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
23 @c anything else? --mew 10feb93
25 @include gcc-common.texi
27 @settitle Using the GNU Compiler Collection (GCC)
29 @c Create a separate index for command line options.
31 @c Merge the standard indexes into a single one.
43 Copyright @copyright{} 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997,
44 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009,
45 2010, 2012 Free Software Foundation, Inc.
47 Permission is granted to copy, distribute and/or modify this document
48 under the terms of the GNU Free Documentation License, Version 1.3 or
49 any later version published by the Free Software Foundation; with the
50 Invariant Sections being ``Funding Free Software'', the Front-Cover
51 Texts being (a) (see below), and with the Back-Cover Texts being (b)
52 (see below). A copy of the license is included in the section entitled
53 ``GNU Free Documentation License''.
55 (a) The FSF's Front-Cover Text is:
59 (b) The FSF's Back-Cover Text is:
61 You have freedom to copy and modify this GNU Manual, like GNU
62 software. Copies published by the Free Software Foundation raise
63 funds for GNU development.
66 @dircategory Software development
68 * gcc: (gcc). The GNU Compiler Collection.
69 * g++: (gcc). The GNU C++ compiler.
70 * gcov: (gcc) Gcov. @command{gcov}---a test coverage program.
72 This file documents the use of the GNU compilers.
78 @setchapternewpage odd
80 @title Using the GNU Compiler Collection
82 @author Richard M. Stallman and the @sc{GCC} Developer Community
84 @vskip 0pt plus 1filll
86 @multitable @columnfractions 0.5 0.5
88 @tab Website: www.gnupress.org
89 @item a division of the
90 @tab General: @tex press@@gnu.org @end tex
91 @item Free Software Foundation
92 @tab Orders: @tex sales@@gnu.org @end tex
93 @item 51 Franklin Street, Fifth Floor
95 @item Boston, MA 02110-1301 USA
100 @c Update this ISBN when printing a new edition.
101 @acronym{ISBN} 1-882114-39-6
103 Cover art by Gary M. Torrisi. Cover design by Jonathan Richard.
106 Last printed October 2003 for GCC 3.3.1.@*
107 Printed copies are available for $45 each.
116 @node Top, G++ and GCC,, (DIR)
120 This manual documents how to use the GNU compilers,
121 as well as their features and incompatibilities, and how to report
122 bugs. It corresponds to the compilers
123 @ifset VERSION_PACKAGE
124 @value{VERSION_PACKAGE}
126 version @value{version-GCC}.
127 The internals of the GNU compilers, including how to port them to new
128 targets and some information about how to write front ends for new
129 languages, are documented in a separate manual. @xref{Top,,
130 Introduction, gccint, GNU Compiler Collection (GCC) Internals}.
133 * G++ and GCC:: You can compile C or C++ programs.
134 * Standards:: Language standards supported by GCC.
135 * Invoking GCC:: Command options supported by @samp{gcc}.
136 * C Implementation:: How GCC implements the ISO C specification.
137 * C Extensions:: GNU extensions to the C language family.
138 * C++ Implementation:: How GCC implements the ISO C++ specification.
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.
148 * Funding:: How to help assure funding for free software.
149 * GNU Project:: The GNU Project and GNU/Linux.
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.
156 * Option Index:: Index to command line options.
157 * Keyword Index:: Index of concepts and symbol names.
160 @include frontends.texi
161 @include standards.texi
163 @include implement-c.texi
164 @include implement-cxx.texi
169 @include trouble.texi
170 @include bugreport.texi
171 @include service.texi
172 @include contribute.texi
174 @include funding.texi
178 @c ---------------------------------------------------------------------
180 @c ---------------------------------------------------------------------
184 @include contrib.texi
186 @c ---------------------------------------------------------------------
188 @c ---------------------------------------------------------------------
191 @unnumbered Option Index
193 GCC's command line options are indexed here without any initial @samp{-}
194 or @samp{--}. Where an option has both positive and negative forms
195 (such as @option{-f@var{option}} and @option{-fno-@var{option}}),
196 relevant entries in the manual are indexed under the most appropriate
197 form; it may sometimes be useful to look up both forms.
202 @unnumbered Keyword Index
206 @c ---------------------------------------------------------------------
208 @c ---------------------------------------------------------------------