\input texinfo @c -*-texinfo-*-
|
\input texinfo @c -*-texinfo-*-
|
@c %**start of header
|
@c %**start of header
|
@setfilename gcc.info
|
@setfilename gcc.info
|
@c INTERNALS is used by md.texi to determine whether to include the
|
@c INTERNALS is used by md.texi to determine whether to include the
|
@c whole of that file, in the internals manual, or only the part
|
@c whole of that file, in the internals manual, or only the part
|
@c dealing with constraints, in the user manual.
|
@c dealing with constraints, in the user manual.
|
@clear INTERNALS
|
@clear INTERNALS
|
|
|
@c NOTE: checks/things to do:
|
@c NOTE: checks/things to do:
|
@c
|
@c
|
@c -have bob do a search in all seven files for "mew" (ideally --mew,
|
@c -have bob do a search in all seven files for "mew" (ideally --mew,
|
@c but i may have forgotten the occasional "--"..).
|
@c but i may have forgotten the occasional "--"..).
|
@c Just checked... all have `--'! Bob 22Jul96
|
@c Just checked... all have `--'! Bob 22Jul96
|
@c Use this to search: grep -n '\-\-mew' *.texi
|
@c Use this to search: grep -n '\-\-mew' *.texi
|
@c -item/itemx, text after all (sub/sub)section titles, etc..
|
@c -item/itemx, text after all (sub/sub)section titles, etc..
|
@c -consider putting the lists of options on pp 17--> etc in columns or
|
@c -consider putting the lists of options on pp 17--> etc in columns or
|
@c some such.
|
@c some such.
|
@c -overfulls. do a search for "mew" in the files, and you will see
|
@c -overfulls. do a search for "mew" in the files, and you will see
|
@c overfulls that i noted but could not deal with.
|
@c overfulls that i noted but could not deal with.
|
@c -have to add text: beginning of chapter 8
|
@c -have to add text: beginning of chapter 8
|
|
|
@c
|
@c
|
@c anything else? --mew 10feb93
|
@c anything else? --mew 10feb93
|
|
|
@include gcc-common.texi
|
@include gcc-common.texi
|
|
|
@settitle Using the GNU Compiler Collection (GCC)
|
@settitle Using the GNU Compiler Collection (GCC)
|
|
|
@c Create a separate index for command line options.
|
@c Create a separate index for command line options.
|
@defcodeindex op
|
@defcodeindex op
|
@c Merge the standard indexes into a single one.
|
@c Merge the standard indexes into a single one.
|
@syncodeindex fn cp
|
@syncodeindex fn cp
|
@syncodeindex vr cp
|
@syncodeindex vr cp
|
@syncodeindex ky cp
|
@syncodeindex ky cp
|
@syncodeindex pg cp
|
@syncodeindex pg cp
|
@syncodeindex tp cp
|
@syncodeindex tp cp
|
|
|
@paragraphindent 1
|
@paragraphindent 1
|
|
|
@c %**end of header
|
@c %**end of header
|
|
|
@copying
|
@copying
|
Copyright @copyright{} 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
|
Copyright @copyright{} 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
|
1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007,
|
1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007,
|
2008 Free Software Foundation, Inc.
|
2008 Free Software Foundation, Inc.
|
|
|
Permission is granted to copy, distribute and/or modify this document
|
Permission is granted to copy, distribute and/or modify this document
|
under the terms of the GNU Free Documentation License, Version 1.2 or
|
under the terms of the GNU Free Documentation License, Version 1.2 or
|
any later version published by the Free Software Foundation; with the
|
any later version published by the Free Software Foundation; with the
|
Invariant Sections being ``Funding Free Software'', the Front-Cover
|
Invariant Sections being ``Funding Free Software'', the Front-Cover
|
Texts being (a) (see below), and with the Back-Cover Texts being (b)
|
Texts being (a) (see below), and with the Back-Cover Texts being (b)
|
(see below). A copy of the license is included in the section entitled
|
(see below). A copy of the license is included in the section entitled
|
``GNU Free Documentation License''.
|
``GNU Free Documentation License''.
|
|
|
(a) The FSF's Front-Cover Text is:
|
(a) The FSF's Front-Cover Text is:
|
|
|
A GNU Manual
|
A GNU Manual
|
|
|
(b) The FSF's Back-Cover Text is:
|
(b) The FSF's Back-Cover Text is:
|
|
|
You have freedom to copy and modify this GNU Manual, like GNU
|
You have freedom to copy and modify this GNU Manual, like GNU
|
software. Copies published by the Free Software Foundation raise
|
software. Copies published by the Free Software Foundation raise
|
funds for GNU development.
|
funds for GNU development.
|
@end copying
|
@end copying
|
@ifnottex
|
@ifnottex
|
@dircategory Software development
|
@dircategory Software development
|
@direntry
|
@direntry
|
* gcc: (gcc). The GNU Compiler Collection.
|
* gcc: (gcc). The GNU Compiler Collection.
|
* g++: (gcc). The GNU C++ compiler.
|
* g++: (gcc). The GNU C++ compiler.
|
@end direntry
|
@end direntry
|
This file documents the use of the GNU compilers.
|
This file documents the use of the GNU compilers.
|
@sp 1
|
@sp 1
|
@insertcopying
|
@insertcopying
|
@sp 1
|
@sp 1
|
@end ifnottex
|
@end ifnottex
|
|
|
@setchapternewpage odd
|
@setchapternewpage odd
|
@titlepage
|
@titlepage
|
@title Using the GNU Compiler Collection
|
@title Using the GNU Compiler Collection
|
@versionsubtitle
|
@versionsubtitle
|
@author Richard M. Stallman and the @sc{GCC} Developer Community
|
@author Richard M. Stallman and the @sc{GCC} Developer Community
|
@page
|
@page
|
@vskip 0pt plus 1filll
|
@vskip 0pt plus 1filll
|
Published by:
|
Published by:
|
@multitable @columnfractions 0.5 0.5
|
@multitable @columnfractions 0.5 0.5
|
@item GNU Press
|
@item GNU Press
|
@tab Website: www.gnupress.org
|
@tab Website: www.gnupress.org
|
@item a division of the
|
@item a division of the
|
@tab General: @tex press@@gnu.org @end tex
|
@tab General: @tex press@@gnu.org @end tex
|
@item Free Software Foundation
|
@item Free Software Foundation
|
@tab Orders: @tex sales@@gnu.org @end tex
|
@tab Orders: @tex sales@@gnu.org @end tex
|
@item 51 Franklin Street, Fifth Floor
|
@item 51 Franklin Street, Fifth Floor
|
@tab Tel 617-542-5942
|
@tab Tel 617-542-5942
|
@item Boston, MA 02110-1301 USA
|
@item Boston, MA 02110-1301 USA
|
@tab Fax 617-542-2652
|
@tab Fax 617-542-2652
|
@end multitable
|
@end multitable
|
@sp 2
|
@sp 2
|
@ifset FSFPRINT
|
@ifset FSFPRINT
|
@c Update this ISBN when printing a new edition.
|
@c Update this ISBN when printing a new edition.
|
@acronym{ISBN} 1-882114-39-6
|
@acronym{ISBN} 1-882114-39-6
|
|
|
Cover art by Gary M. Torrisi. Cover design by Jonathan Richard.
|
Cover art by Gary M. Torrisi. Cover design by Jonathan Richard.
|
@end ifset
|
@end ifset
|
@ifclear FSFPRINT
|
@ifclear FSFPRINT
|
Last printed October 2003 for GCC 3.3.1.@*
|
Last printed October 2003 for GCC 3.3.1.@*
|
Printed copies are available for $45 each.
|
Printed copies are available for $45 each.
|
@end ifclear
|
@end ifclear
|
@sp 1
|
@sp 1
|
@insertcopying
|
@insertcopying
|
@end titlepage
|
@end titlepage
|
@summarycontents
|
@summarycontents
|
@contents
|
@contents
|
@page
|
@page
|
|
|
@node Top, G++ and GCC,, (DIR)
|
@node Top, G++ and GCC,, (DIR)
|
@top Introduction
|
@top Introduction
|
@cindex introduction
|
@cindex introduction
|
|
|
This manual documents how to use the GNU compilers,
|
This manual documents how to use the GNU compilers,
|
as well as their features and incompatibilities, and how to report
|
as well as their features and incompatibilities, and how to report
|
bugs. It corresponds to the compilers
|
bugs. It corresponds to the compilers
|
@ifset VERSION_PACKAGE
|
@ifset VERSION_PACKAGE
|
@value{VERSION_PACKAGE}
|
@value{VERSION_PACKAGE}
|
@end ifset
|
@end ifset
|
version @value{version-GCC}.
|
version @value{version-GCC}.
|
The internals of the GNU compilers, including how to port them to new
|
The internals of the GNU compilers, including how to port them to new
|
targets and some information about how to write front ends for new
|
targets and some information about how to write front ends for new
|
languages, are documented in a separate manual. @xref{Top,,
|
languages, are documented in a separate manual. @xref{Top,,
|
Introduction, gccint, GNU Compiler Collection (GCC) Internals}.
|
Introduction, gccint, GNU Compiler Collection (GCC) Internals}.
|
|
|
@menu
|
@menu
|
* G++ and GCC:: You can compile C or C++ programs.
|
* G++ and GCC:: You can compile C or C++ programs.
|
* Standards:: Language standards supported by GCC.
|
* Standards:: Language standards supported by GCC.
|
* Invoking GCC:: Command options supported by @samp{gcc}.
|
* Invoking GCC:: Command options supported by @samp{gcc}.
|
* C Implementation:: How GCC implements the ISO C specification.
|
* C Implementation:: How GCC implements the ISO C specification.
|
* C Extensions:: GNU extensions to the C language family.
|
* C Extensions:: GNU extensions to the C language family.
|
* C++ Implementation:: How GCC implements the ISO C++ specification.
|
* C++ Implementation:: How GCC implements the ISO C++ specification.
|
* C++ Extensions:: GNU extensions to the C++ language.
|
* C++ Extensions:: GNU extensions to the C++ language.
|
* Objective-C:: GNU Objective-C runtime features.
|
* Objective-C:: GNU Objective-C runtime features.
|
* Compatibility:: Binary Compatibility
|
* Compatibility:: Binary Compatibility
|
* Gcov:: @command{gcov}---a test coverage program.
|
* Gcov:: @command{gcov}---a test coverage program.
|
* Trouble:: If you have trouble using GCC.
|
* Trouble:: If you have trouble using GCC.
|
* Bugs:: How, why and where to report bugs.
|
* Bugs:: How, why and where to report bugs.
|
* Service:: How to find suppliers of support for GCC.
|
* Service:: How to find suppliers of support for GCC.
|
* Contributing:: How to contribute to testing and developing GCC.
|
* Contributing:: How to contribute to testing and developing GCC.
|
|
|
* Funding:: How to help assure funding for free software.
|
* Funding:: How to help assure funding for free software.
|
* GNU Project:: The GNU Project and GNU/Linux.
|
* GNU Project:: The GNU Project and GNU/Linux.
|
|
|
* Copying:: GNU General Public License says
|
* Copying:: GNU General Public License says
|
how you can copy and share GCC.
|
how you can copy and share GCC.
|
* GNU Free Documentation License:: How you can copy and share this manual.
|
* GNU Free Documentation License:: How you can copy and share this manual.
|
* Contributors:: People who have contributed to GCC.
|
* Contributors:: People who have contributed to GCC.
|
|
|
* Option Index:: Index to command line options.
|
* Option Index:: Index to command line options.
|
* Keyword Index:: Index of concepts and symbol names.
|
* Keyword Index:: Index of concepts and symbol names.
|
@end menu
|
@end menu
|
|
|
@include frontends.texi
|
@include frontends.texi
|
@include standards.texi
|
@include standards.texi
|
@include invoke.texi
|
@include invoke.texi
|
@include implement-c.texi
|
@include implement-c.texi
|
@include implement-cxx.texi
|
@include implement-cxx.texi
|
@include extend.texi
|
@include extend.texi
|
@include objc.texi
|
@include objc.texi
|
@include compat.texi
|
@include compat.texi
|
@include gcov.texi
|
@include gcov.texi
|
@include trouble.texi
|
@include trouble.texi
|
@include bugreport.texi
|
@include bugreport.texi
|
@include service.texi
|
@include service.texi
|
@include contribute.texi
|
@include contribute.texi
|
|
|
@include funding.texi
|
@include funding.texi
|
@include gnu.texi
|
@include gnu.texi
|
@include gpl_v3.texi
|
@include gpl_v3.texi
|
|
|
@c ---------------------------------------------------------------------
|
@c ---------------------------------------------------------------------
|
@c GFDL
|
@c GFDL
|
@c ---------------------------------------------------------------------
|
@c ---------------------------------------------------------------------
|
|
|
@include fdl.texi
|
@include fdl.texi
|
|
|
@include contrib.texi
|
@include contrib.texi
|
|
|
@c ---------------------------------------------------------------------
|
@c ---------------------------------------------------------------------
|
@c Indexes
|
@c Indexes
|
@c ---------------------------------------------------------------------
|
@c ---------------------------------------------------------------------
|
|
|
@node Option Index
|
@node Option Index
|
@unnumbered Option Index
|
@unnumbered Option Index
|
|
|
GCC's command line options are indexed here without any initial @samp{-}
|
GCC's command line options are indexed here without any initial @samp{-}
|
or @samp{--}. Where an option has both positive and negative forms
|
or @samp{--}. Where an option has both positive and negative forms
|
(such as @option{-f@var{option}} and @option{-fno-@var{option}}),
|
(such as @option{-f@var{option}} and @option{-fno-@var{option}}),
|
relevant entries in the manual are indexed under the most appropriate
|
relevant entries in the manual are indexed under the most appropriate
|
form; it may sometimes be useful to look up both forms.
|
form; it may sometimes be useful to look up both forms.
|
|
|
@printindex op
|
@printindex op
|
|
|
@node Keyword Index
|
@node Keyword Index
|
@unnumbered Keyword Index
|
@unnumbered Keyword Index
|
|
|
@printindex cp
|
@printindex cp
|
|
|
@c ---------------------------------------------------------------------
|
@c ---------------------------------------------------------------------
|
@c Epilogue
|
@c Epilogue
|
@c ---------------------------------------------------------------------
|
@c ---------------------------------------------------------------------
|
|
|
@bye
|
@bye
|
|
|
