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