OSDN Git Service

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