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 @c %**end of header
  39
  40 @c Use with @@smallbook.
  41
  42 @c Cause even numbered pages to be printed on the left hand side of
  43 @c the page and odd numbered pages to be printed on the right hand
  44 @c side of the page.  Using this, you can print on both sides of a
  45 @c sheet of paper and have the text on the same part of the sheet.
  46
  47 @c The text on right hand pages is pushed towards the right hand
  48 @c margin and the text on left hand pages is pushed toward the left
  49 @c hand margin.
  50 @c (To provide the reverse effect, set bindingoffset to -0.75in.)
  51
  52 @c @tex
  53 @c \global\bindingoffset=0.75in
  54 @c \global\normaloffset =0.75in
  55 @c @end tex
  56
  57 @c Change the font used for @def... commands, since the default
  58 @c proportional one used is bad for names starting __.
  59 @tex
  60 \global\setfont\defbf\ttbshape{10}{\magstep1}
  61 @end tex
  62
  63 @macro copyrightnotice
  64 Copyright @copyright{} 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
  65 1999, 2000, 2001, 2002 Free Software Foundation, Inc.
  66 @end macro
  67 @ifnottex
  68 @dircategory Programming
  69 @direntry
  70 * gcc: (gcc).                  The GNU Compiler Collection.
  71 @end direntry
  72 This file documents the use of the GNU compilers.
  73 @sp 1
  74 Published by the Free Software Foundation@*
  75 59 Temple Place - Suite 330@*
  76 Boston, MA 02111-1307 USA
  77 @sp 1
  78 @copyrightnotice{}
  79 @sp 1
  80 Permission is granted to copy, distribute and/or modify this document
  81 under the terms of the GNU Free Documentation License, Version 1.1 or
  82 any later version published by the Free Software Foundation; with the
  83 Invariant Sections being ``GNU General Public License'' and ``Funding
  84 Free Software'', the Front-Cover texts being (a) (see below), and with
  85 the Back-Cover Texts being (b) (see below).  A copy of the license is
  86 included in the section entitled ``GNU Free Documentation License''.
  87
  88 (a) The FSF's Front-Cover Text is:
  89
  90      A GNU Manual
  91
  92 (b) The FSF's Back-Cover Text is:
  93
  94      You have freedom to copy and modify this GNU Manual, like GNU
  95      software.  Copies published by the Free Software Foundation raise
  96      funds for GNU development.
  97 @end ifnottex
  98
  99 @setchapternewpage odd
 100 @titlepage
 101 @center @titlefont{Using the GNU Compiler Collection}
 102 @sp 2
 103 @center Richard M. Stallman
 104 @sp 3
 105 @center Last updated 20 April 2002
 106 @sp 1
 107
 108 @center for GCC @value{version-GCC}
 109 @page
 110 @vskip 0pt plus 1filll
 111 @copyrightnotice{}
 112 @sp 2
 113 For GCC Version @value{version-GCC}@*
 114 @sp 1
 115 Published by the Free Software Foundation @*
 116 59 Temple Place---Suite 330@*
 117 Boston, MA 02111-1307, USA@*
 118 Last printed April, 1998.@*
 119 Printed copies are available for $50 each.@*
 120 @c Update this ISBN when printing a new edition.
 121 @ifset FSFPRINT
 122 ISBN 1-882114-37-X
 123 @end ifset
 124 @sp 1
 125 Permission is granted to copy, distribute and/or modify this document
 126 under the terms of the GNU Free Documentation License, Version 1.1 or
 127 any later version published by the Free Software Foundation; with the
 128 Invariant Sections being ``GNU General Public License'', the Front-Cover
 129 texts being (a) (see below), and with the Back-Cover Texts being (b)
 130 (see below).  A copy of the license is included in the section entitled
 131 ``GNU Free Documentation License''.
 132
 133 (a) The FSF's Front-Cover Text is:
 134
 135      A GNU Manual
 136
 137 (b) The FSF's Back-Cover Text is:
 138
 139      You have freedom to copy and modify this GNU Manual, like GNU
 140      software.  Copies published by the Free Software Foundation raise
 141      funds for GNU development.
 142 @end titlepage
 143 @summarycontents
 144 @contents
 145 @page
 146
 147 @node Top, G++ and GCC,, (DIR)
 148 @top Introduction
 149 @cindex introduction
 150
 151 This manual documents how to use the GNU compilers,
 152 as well as their features and incompatibilities, and how to report
 153 bugs.  It corresponds to GCC version @value{version-GCC}.
 154 The internals of the GNU compilers, including how to port them to new
 155 targets and some information about how to write front ends for new
 156 languages, are documented in a separate manual.  @xref{Top,,
 157 Introduction, gccint, GNU Compiler Collection (GCC) Internals}.
 158
 159 @menu
 160 * G++ and GCC::     You can compile C or C++ programs.
 161 * Standards::       Language standards supported by GCC.
 162 * Invoking GCC::    Command options supported by @samp{gcc}.
 163 * C Implementation:: How GCC implements the ISO C specification.
 164 * C Extensions::    GNU extensions to the C language family.
 165 * C++ Extensions::  GNU extensions to the C++ language.
 166 * Objective-C::     GNU Objective-C runtime features.
 167 * Compatibility::   Binary Compatibility
 168 * Gcov::            gcov: a GCC test coverage program.
 169 * Trouble::         If you have trouble using GCC.
 170 * Bugs::            How, why and where to report bugs.
 171 * Service::         How to find suppliers of support for GCC.
 172 * Contributing::    How to contribute to testing and developing GCC.
 173 * VMS::             Using GCC on VMS.
 174
 175 * Funding::         How to help assure funding for free software.
 176 * GNU Project::     The GNU Project and GNU/Linux.
 177
 178 * Copying::         GNU General Public License says
 179                      how you can copy and share GCC.
 180 * GNU Free Documentation License:: How you can copy and share this manual.
 181 * Contributors::    People who have contributed to GCC.
 182
 183 * Option Index::    Index to command line options.
 184 * Keyword Index::    Index of concepts and symbol names.
 185 @end menu
 186
 187 @include frontends.texi
 188 @include standards.texi
 189 @include invoke.texi
 190 @include extend.texi
 191 @include objc.texi
 192 @include compat.texi
 193 @include gcov.texi
 194 @include trouble.texi
 195 @include bugreport.texi
 196 @include service.texi
 197 @include contribute.texi
 198 @include vms.texi
 199
 200 @include funding.texi
 201 @include gnu.texi
 202 @include gpl.texi
 203
 204 @c ---------------------------------------------------------------------
 205 @c GFDL
 206 @c ---------------------------------------------------------------------
 207
 208 @include fdl.texi
 209
 210 @include contrib.texi
 211
 212 @c ---------------------------------------------------------------------
 213 @c Indexes
 214 @c ---------------------------------------------------------------------
 215
 216 @node Option Index
 217 @unnumbered Option Index
 218
 219 GCC's command line options are indexed here without any initial @samp{-}
 220 or @samp{--}.  Where an option has both positive and negative forms
 221 (such as @option{-f@var{option}} and @option{-fno-@var{option}}),
 222 relevant entries in the manual are indexed under the most appropriate
 223 form; it may sometimes be useful to look up both forms.
 224
 225 @printindex op
 226
 227 @node Keyword Index
 228 @unnumbered Keyword Index
 229
 230 @printindex cp
 231
 232 @c ---------------------------------------------------------------------
 233 @c Epilogue
 234 @c ---------------------------------------------------------------------
 235
 236 @bye