gcc.texi revision 110611
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 64Copyright @copyright{} 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 651999, 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 72This file documents the use of the GNU compilers. 73@sp 1 74Published by the Free Software Foundation@* 7559 Temple Place - Suite 330@* 76Boston, MA 02111-1307 USA 77@sp 1 78@copyrightnotice{} 79@sp 1 80Permission is granted to copy, distribute and/or modify this document 81under the terms of the GNU Free Documentation License, Version 1.1 or 82any later version published by the Free Software Foundation; with the 83Invariant Sections being ``GNU General Public License'' and ``Funding 84Free Software'', the Front-Cover texts being (a) (see below), and with 85the Back-Cover Texts being (b) (see below). A copy of the license is 86included 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 113For GCC Version @value{version-GCC}@* 114@sp 1 115Published by the Free Software Foundation @* 11659 Temple Place---Suite 330@* 117Boston, MA 02111-1307, USA@* 118Last printed April, 1998.@* 119Printed copies are available for $50 each.@* 120@c Update this ISBN when printing a new edition. 121@ifset FSFPRINT 122ISBN 1-882114-37-X 123@end ifset 124@sp 1 125Permission is granted to copy, distribute and/or modify this document 126under the terms of the GNU Free Documentation License, Version 1.1 or 127any later version published by the Free Software Foundation; with the 128Invariant Sections being ``GNU General Public License'', the Front-Cover 129texts 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 151This manual documents how to use the GNU compilers, 152as well as their features and incompatibilities, and how to report 153bugs. It corresponds to GCC version @value{version-GCC}. 154The internals of the GNU compilers, including how to port them to new 155targets and some information about how to write front ends for new 156languages, are documented in a separate manual. @xref{Top,, 157Introduction, 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:: @command{gcov}---a 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* 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 219GCC's command line options are indexed here without any initial @samp{-} 220or @samp{--}. Where an option has both positive and negative forms 221(such as @option{-f@var{option}} and @option{-fno-@var{option}}), 222relevant entries in the manual are indexed under the most appropriate 223form; it may sometimes be useful to look up both forms. 224 225@printindex op 226 227@node Index 228@unnumbered Index 229 230@printindex cp 231 232@c --------------------------------------------------------------------- 233@c Epilogue 234@c --------------------------------------------------------------------- 235 236@bye 237