gcc/doc/gcc.texi - gcc - Git at Google

 \input texinfo  @c -*-texinfo-*-
 @c %**start of header
 @setfilename gcc.info
 @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 dealing with constraints, in the user manual.
 @clear INTERNALS

 @c NOTE: checks/things to do:
 @c
 @c -have bob do a search in all seven files for "mew" (ideally --mew,
 @c  but i may have forgotten the occasional "--"..).
 @c     Just checked... all have `--'!  Bob 22Jul96
 @c     Use this to search:   grep -n '\-\-mew' *.texi
 @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  some such.
 @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 -have to add text:  beginning of chapter 8

 @c
 @c anything else?                       --mew 10feb93

 @include gcc-common.texi

 @settitle Using the GNU Compiler Collection (GCC)

 @c Create a separate index for command line options.
 @defcodeindex op
 @c Merge the standard indexes into a single one.
 @syncodeindex fn cp
 @syncodeindex vr cp
 @syncodeindex ky cp
 @syncodeindex pg cp
 @syncodeindex tp cp

 @c %**end of header

 @c Use with @@smallbook.

 @c Cause even numbered pages to be printed on the left hand side of
 @c the page and odd numbered pages to be printed on the right hand
 @c side of the page.  Using this, you can print on both sides of a
 @c sheet of paper and have the text on the same part of the sheet.

 @c The text on right hand pages is pushed towards the right hand
 @c margin and the text on left hand pages is pushed toward the left
 @c hand margin.
 @c (To provide the reverse effect, set bindingoffset to -0.75in.)

 @c @tex
 @c \global\bindingoffset=0.75in
 @c \global\normaloffset =0.75in
 @c @end tex

 @c Change the font used for @def... commands, since the default
 @c proportional one used is bad for names starting __.
 @tex
 \global\setfont\defbf\ttbshape{10}{\magstep1}
 @end tex

 @macro copyrightnotice
 Copyright @copyright{} 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
 1999, 2000, 2001, 2002 Free Software Foundation, Inc.
 @end macro
 @ifnottex
 @dircategory Programming
 @direntry
 * gcc: (gcc).                  The GNU Compiler Collection.
 @end direntry
 This file documents the use of the GNU compilers.
 @sp 1
 Published by the Free Software Foundation@*
 59 Temple Place - Suite 330@*
 Boston, MA 02111-1307 USA
 @sp 1
 @copyrightnotice{}
 @sp 1
 Permission is granted to copy, distribute and/or modify this document
 under the terms of the GNU Free Documentation License, Version 1.1 or
 any later version published by the Free Software Foundation; with the
 Invariant Sections being ``GNU General Public License'' and ``Funding
 Free Software'', the Front-Cover 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 ``GNU Free Documentation License''.

 (a) The FSF's Front-Cover Text is:

      A GNU Manual

 (b) The FSF's Back-Cover Text is:

      You have freedom to copy and modify this GNU Manual, like GNU
      software.  Copies published by the Free Software Foundation raise
      funds for GNU development.
 @end ifnottex

 @setchapternewpage odd
 @titlepage
 @center @titlefont{Using the GNU Compiler Collection}
 @sp 2
 @center Richard M. Stallman
 @sp 3
 @center Last updated 7 January 2002
 @sp 1

 @center for GCC @value{version-GCC}
 @page
 @vskip 0pt plus 1filll
 @copyrightnotice{}
 @sp 2
 For GCC Version @value{version-GCC}@*
 @sp 1
 Published by the Free Software Foundation @*
 59 Temple Place---Suite 330@*
 Boston, MA 02111-1307, USA@*
 Last printed April, 1998.@*
 Printed copies are available for $50 each.@*
 @c Update this ISBN when printing a new edition.
 @ifset FSFPRINT
 ISBN 1-882114-37-X
 @end ifset
 @sp 1
 Permission is granted to copy, distribute and/or modify this document
 under the terms of the GNU Free Documentation License, Version 1.1 or
 any later version published by the Free Software Foundation; with the
 Invariant Sections being ``GNU General Public License'', the Front-Cover
 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
 ``GNU Free Documentation License''.

 (a) The FSF's Front-Cover Text is:

      A GNU Manual

 (b) The FSF's Back-Cover Text is:

      You have freedom to copy and modify this GNU Manual, like GNU
      software.  Copies published by the Free Software Foundation raise
      funds for GNU development.
 @end titlepage
 @summarycontents
 @contents
 @page

 @node Top, G++ and GCC,, (DIR)
 @top Introduction
 @cindex introduction

 This manual documents how to use the GNU compilers,
 as well as their features and incompatibilities, and how to report
 bugs.  It corresponds to GCC version @value{version-GCC}.
 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
 languages, are documented in a separate manual.  @xref{Top,,
 Introduction, gccint, GNU Compiler Collection (GCC) Internals}.

 @menu
 * G++ and GCC::     You can compile C or C++ programs.
 * Standards::       Language standards supported by GCC.
 * Invoking GCC::    Command options supported by @samp{gcc}.
 * 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.
 * Objective-C::     GNU Objective-C runtime features.
 * Gcov::	    gcov: a GCC test coverage program.
 * Trouble::         If you have trouble using GCC.
 * Bugs::            How, why and where to report bugs.
 * Service::         How to find suppliers of support for GCC.
 * Contributing::    How to contribute to testing and developing GCC.
 * VMS::             Using GCC on VMS.

 * Funding::         How to help assure funding for free software.
 * GNU Project::     The GNU Project and GNU/Linux.

 * Copying::         GNU General Public License says
                      how you can copy and share GCC.
 * GNU Free Documentation License:: How you can copy and share this manual.
 * Contributors::    People who have contributed to GCC.

 * Option Index::    Index to command line options.
 * Index::	    Index of concepts and symbol names.
 @end menu

 @include frontends.texi
 @include standards.texi
 @include invoke.texi
 @include extend.texi
 @include objc.texi
 @include gcov.texi
 @include trouble.texi
 @include bugreport.texi
 @include service.texi
 @include contribute.texi
 @include vms.texi

 @include funding.texi
 @include gnu.texi
 @include gpl.texi

 @c ---------------------------------------------------------------------
 @c GFDL
 @c ---------------------------------------------------------------------

 @include fdl.texi

 @include contrib.texi

 @c ---------------------------------------------------------------------
 @c Indexes
 @c ---------------------------------------------------------------------

 @node Option Index
 @unnumbered Option Index

 GCC's command line options are indexed here without any initial @samp{-}
 or @samp{--}.  Where an option has both positive and negative forms
 (such as @option{-f@var{option}} and @option{-fno-@var{option}}),
 relevant entries in the manual are indexed under the most appropriate
 form; it may sometimes be useful to look up both forms.

 @printindex op

 @node Index
 @unnumbered Index

 @printindex cp

 @c ---------------------------------------------------------------------
 @c Epilogue
 @c ---------------------------------------------------------------------

 @bye
	\input texinfo @c --texinfo--
	@c %**start of header
	@setfilename gcc.info
	@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 dealing with constraints, in the user manual.
	@clear INTERNALS

	@c NOTE: checks/things to do:
	@c
	@c -have bob do a search in all seven files for "mew" (ideally --mew,
	@c but i may have forgotten the occasional "--"..).
	@c Just checked... all have `--'! Bob 22Jul96
	@c Use this to search: grep -n '\-\-mew' *.texi
	@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 some such.
	@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 -have to add text: beginning of chapter 8

	@c
	@c anything else? --mew 10feb93

	@include gcc-common.texi

	@settitle Using the GNU Compiler Collection (GCC)

	@c Create a separate index for command line options.
	@defcodeindex op
	@c Merge the standard indexes into a single one.
	@syncodeindex fn cp
	@syncodeindex vr cp
	@syncodeindex ky cp
	@syncodeindex pg cp
	@syncodeindex tp cp

	@c %**end of header

	@c Use with @@smallbook.

	@c Cause even numbered pages to be printed on the left hand side of
	@c the page and odd numbered pages to be printed on the right hand
	@c side of the page. Using this, you can print on both sides of a
	@c sheet of paper and have the text on the same part of the sheet.

	@c The text on right hand pages is pushed towards the right hand
	@c margin and the text on left hand pages is pushed toward the left
	@c hand margin.
	@c (To provide the reverse effect, set bindingoffset to -0.75in.)

	@c @tex
	@c \global\bindingoffset=0.75in
	@c \global\normaloffset =0.75in
	@c @end tex

	@c Change the font used for @def... commands, since the default
	@c proportional one used is bad for names starting __.
	@tex
	\global\setfont\defbf\ttbshape{10}{\magstep1}
	@end tex

	@macro copyrightnotice
	Copyright @copyright{} 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
	1999, 2000, 2001, 2002 Free Software Foundation, Inc.
	@end macro
	@ifnottex
	@dircategory Programming
	@direntry
	* gcc: (gcc). The GNU Compiler Collection.
	@end direntry
	This file documents the use of the GNU compilers.
	@sp 1
	Published by the Free Software Foundation@*
	59 Temple Place - Suite 330@*
	Boston, MA 02111-1307 USA
	@sp 1
	@copyrightnotice{}
	@sp 1
	Permission is granted to copy, distribute and/or modify this document
	under the terms of the GNU Free Documentation License, Version 1.1 or
	any later version published by the Free Software Foundation; with the
	Invariant Sections being ``GNU General Public License'' and ``Funding
	Free Software'', the Front-Cover 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 ``GNU Free Documentation License''.

	(a) The FSF's Front-Cover Text is:

	A GNU Manual

	(b) The FSF's Back-Cover Text is:

	You have freedom to copy and modify this GNU Manual, like GNU
	software. Copies published by the Free Software Foundation raise
	funds for GNU development.
	@end ifnottex

	@setchapternewpage odd
	@titlepage
	@center @titlefont{Using the GNU Compiler Collection}
	@sp 2
	@center Richard M. Stallman
	@sp 3
	@center Last updated 7 January 2002
	@sp 1

	@center for GCC @value{version-GCC}
	@page
	@vskip 0pt plus 1filll
	@copyrightnotice{}
	@sp 2
	For GCC Version @value{version-GCC}@*
	@sp 1
	Published by the Free Software Foundation @*
	59 Temple Place---Suite 330@*
	Boston, MA 02111-1307, USA@*
	Last printed April, 1998.@*
	Printed copies are available for $50 each.@*
	@c Update this ISBN when printing a new edition.
	@ifset FSFPRINT
	ISBN 1-882114-37-X
	@end ifset
	@sp 1
	Permission is granted to copy, distribute and/or modify this document
	under the terms of the GNU Free Documentation License, Version 1.1 or
	any later version published by the Free Software Foundation; with the
	Invariant Sections being ``GNU General Public License'', the Front-Cover
	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
	``GNU Free Documentation License''.

	(a) The FSF's Front-Cover Text is:

	A GNU Manual

	(b) The FSF's Back-Cover Text is:

	You have freedom to copy and modify this GNU Manual, like GNU
	software. Copies published by the Free Software Foundation raise
	funds for GNU development.
	@end titlepage
	@summarycontents
	@contents
	@page

	@node Top, G++ and GCC,, (DIR)
	@top Introduction
	@cindex introduction

	This manual documents how to use the GNU compilers,
	as well as their features and incompatibilities, and how to report
	bugs. It corresponds to GCC version @value{version-GCC}.
	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
	languages, are documented in a separate manual. @xref{Top,,
	Introduction, gccint, GNU Compiler Collection (GCC) Internals}.

	@menu
	* G++ and GCC:: You can compile C or C++ programs.
	* Standards:: Language standards supported by GCC.
	* Invoking GCC:: Command options supported by @samp{gcc}.
	* 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.
	* Objective-C:: GNU Objective-C runtime features.
	* Gcov:: gcov: a GCC test coverage program.
	* Trouble:: If you have trouble using GCC.
	* Bugs:: How, why and where to report bugs.
	* Service:: How to find suppliers of support for GCC.
	* Contributing:: How to contribute to testing and developing GCC.
	* VMS:: Using GCC on VMS.

	* Funding:: How to help assure funding for free software.
	* GNU Project:: The GNU Project and GNU/Linux.

	* Copying:: GNU General Public License says
	how you can copy and share GCC.
	* GNU Free Documentation License:: How you can copy and share this manual.
	* Contributors:: People who have contributed to GCC.

	* Option Index:: Index to command line options.
	* Index:: Index of concepts and symbol names.
	@end menu

	@include frontends.texi
	@include standards.texi
	@include invoke.texi
	@include extend.texi
	@include objc.texi
	@include gcov.texi
	@include trouble.texi
	@include bugreport.texi
	@include service.texi
	@include contribute.texi
	@include vms.texi

	@include funding.texi
	@include gnu.texi
	@include gpl.texi

	@c ---------------------------------------------------------------------
	@c GFDL
	@c ---------------------------------------------------------------------

	@include fdl.texi

	@include contrib.texi

	@c ---------------------------------------------------------------------
	@c Indexes
	@c ---------------------------------------------------------------------

	@node Option Index
	@unnumbered Option Index

	GCC's command line options are indexed here without any initial @samp{-}
	or @samp{--}. Where an option has both positive and negative forms
	(such as @option{-f@var{option}} and @option{-fno-@var{option}}),
	relevant entries in the manual are indexed under the most appropriate
	form; it may sometimes be useful to look up both forms.

	@printindex op

	@node Index
	@unnumbered Index

	@printindex cp

	@c ---------------------------------------------------------------------
	@c Epilogue
	@c ---------------------------------------------------------------------

	@bye