190075Sobrien\input texinfo @c -*-texinfo-*- 290075Sobrien@c %**start of header 390075Sobrien@setfilename gcc.info 490075Sobrien@c INTERNALS is used by md.texi to determine whether to include the 590075Sobrien@c whole of that file, in the internals manual, or only the part 690075Sobrien@c dealing with constraints, in the user manual. 790075Sobrien@clear INTERNALS 890075Sobrien 990075Sobrien@c NOTE: checks/things to do: 1090075Sobrien@c 1190075Sobrien@c -have bob do a search in all seven files for "mew" (ideally --mew, 1290075Sobrien@c but i may have forgotten the occasional "--"..). 1390075Sobrien@c Just checked... all have `--'! Bob 22Jul96 1490075Sobrien@c Use this to search: grep -n '\-\-mew' *.texi 1590075Sobrien@c -item/itemx, text after all (sub/sub)section titles, etc.. 1690075Sobrien@c -consider putting the lists of options on pp 17--> etc in columns or 1790075Sobrien@c some such. 1890075Sobrien@c -overfulls. do a search for "mew" in the files, and you will see 1990075Sobrien@c overfulls that i noted but could not deal with. 2090075Sobrien@c -have to add text: beginning of chapter 8 2190075Sobrien 2290075Sobrien@c 2390075Sobrien@c anything else? --mew 10feb93 2490075Sobrien 2590075Sobrien@include gcc-common.texi 2690075Sobrien 2790075Sobrien@settitle Using the GNU Compiler Collection (GCC) 2890075Sobrien 2990075Sobrien@c Create a separate index for command line options. 3090075Sobrien@defcodeindex op 3190075Sobrien@c Merge the standard indexes into a single one. 3290075Sobrien@syncodeindex fn cp 3390075Sobrien@syncodeindex vr cp 3490075Sobrien@syncodeindex ky cp 3590075Sobrien@syncodeindex pg cp 3690075Sobrien@syncodeindex tp cp 3790075Sobrien 38132718Skan@paragraphindent 1 39132718Skan 4090075Sobrien@c %**end of header 4190075Sobrien 42117395Skan@copying 4390075SobrienCopyright @copyright{} 1988, 1989, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 44169689Skan1999, 2000, 2001, 2002, 2003, 2004, 2005 Free Software Foundation, Inc. 45117395Skan 4690075SobrienPermission is granted to copy, distribute and/or modify this document 47117395Skanunder the terms of the GNU Free Documentation License, Version 1.2 or 4890075Sobrienany later version published by the Free Software Foundation; with the 4990075SobrienInvariant Sections being ``GNU General Public License'' and ``Funding 5090075SobrienFree Software'', the Front-Cover texts being (a) (see below), and with 5190075Sobrienthe Back-Cover Texts being (b) (see below). A copy of the license is 5290075Sobrienincluded in the section entitled ``GNU Free Documentation License''. 5390075Sobrien 5490075Sobrien(a) The FSF's Front-Cover Text is: 5590075Sobrien 5690075Sobrien A GNU Manual 5790075Sobrien 5890075Sobrien(b) The FSF's Back-Cover Text is: 5990075Sobrien 6090075Sobrien You have freedom to copy and modify this GNU Manual, like GNU 6190075Sobrien software. Copies published by the Free Software Foundation raise 6290075Sobrien funds for GNU development. 63117395Skan@end copying 64117395Skan@ifnottex 65169689Skan@dircategory Software development 66117395Skan@direntry 67117395Skan* gcc: (gcc). The GNU Compiler Collection. 68117395Skan@end direntry 69117395SkanThis file documents the use of the GNU compilers. 70117395Skan@sp 1 71117395Skan@insertcopying 72117395Skan@sp 1 7390075Sobrien@end ifnottex 7490075Sobrien 7590075Sobrien@setchapternewpage odd 7690075Sobrien@titlepage 77169689Skan@title Using the GNU Compiler Collection 78169689Skan@versionsubtitle 79169689Skan@author Richard M. Stallman and the @sc{GCC} Developer Community 8090075Sobrien@page 8190075Sobrien@vskip 0pt plus 1filll 82132718SkanPublished by: 83132718Skan@multitable @columnfractions 0.5 0.5 84132718Skan@item GNU Press 85132718Skan@tab Website: www.gnupress.org 86132718Skan@item a division of the 87132718Skan@tab General: @tex press@@gnu.org @end tex 88132718Skan@item Free Software Foundation 89132718Skan@tab Orders: @tex sales@@gnu.org @end tex 90169689Skan@item 51 Franklin Street, Fifth Floor 91132718Skan@tab Tel 617-542-5942 92169689Skan@item Boston, MA 02110-1301 USA 93132718Skan@tab Fax 617-542-2652 94132718Skan@end multitable 95132718Skan@sp 2 96132718Skan@ifset FSFPRINT 9790075Sobrien@c Update this ISBN when printing a new edition. 98132718Skan@acronym{ISBN} 1-882114-39-6 99132718Skan 100132718SkanCover art by Gary M. Torrisi. Cover design by Jonathan Richard. 10190075Sobrien@end ifset 102132718Skan@ifclear FSFPRINT 103132718SkanLast printed October 2003 for GCC 3.3.1.@* 104132718SkanPrinted copies are available for $45 each. 105132718Skan@end ifclear 10690075Sobrien@sp 1 107117395Skan@insertcopying 10890075Sobrien@end titlepage 10990075Sobrien@summarycontents 11090075Sobrien@contents 11190075Sobrien@page 11290075Sobrien 11390075Sobrien@node Top, G++ and GCC,, (DIR) 11490075Sobrien@top Introduction 11590075Sobrien@cindex introduction 11690075Sobrien 11790075SobrienThis manual documents how to use the GNU compilers, 11890075Sobrienas well as their features and incompatibilities, and how to report 11990075Sobrienbugs. It corresponds to GCC version @value{version-GCC}. 12090075SobrienThe internals of the GNU compilers, including how to port them to new 12190075Sobrientargets and some information about how to write front ends for new 12290075Sobrienlanguages, are documented in a separate manual. @xref{Top,, 12390075SobrienIntroduction, gccint, GNU Compiler Collection (GCC) Internals}. 12490075Sobrien 12590075Sobrien@menu 12690075Sobrien* G++ and GCC:: You can compile C or C++ programs. 12790075Sobrien* Standards:: Language standards supported by GCC. 12890075Sobrien* Invoking GCC:: Command options supported by @samp{gcc}. 12990075Sobrien* C Implementation:: How GCC implements the ISO C specification. 13090075Sobrien* C Extensions:: GNU extensions to the C language family. 13190075Sobrien* C++ Extensions:: GNU extensions to the C++ language. 132103445Skan* Compatibility:: Binary Compatibility 133110611Skan* Gcov:: @command{gcov}---a test coverage program. 13490075Sobrien* Trouble:: If you have trouble using GCC. 13590075Sobrien* Bugs:: How, why and where to report bugs. 13690075Sobrien* Service:: How to find suppliers of support for GCC. 13790075Sobrien* Contributing:: How to contribute to testing and developing GCC. 13890075Sobrien 13990075Sobrien* Funding:: How to help assure funding for free software. 14090075Sobrien* GNU Project:: The GNU Project and GNU/Linux. 14190075Sobrien 14290075Sobrien* Copying:: GNU General Public License says 14390075Sobrien how you can copy and share GCC. 14490075Sobrien* GNU Free Documentation License:: How you can copy and share this manual. 14590075Sobrien* Contributors:: People who have contributed to GCC. 14690075Sobrien 14790075Sobrien* Option Index:: Index to command line options. 148117395Skan* Keyword Index:: Index of concepts and symbol names. 14990075Sobrien@end menu 15090075Sobrien 15190075Sobrien@include frontends.texi 15290075Sobrien@include standards.texi 15390075Sobrien@include invoke.texi 154169689Skan@include implement-c.texi 15590075Sobrien@include extend.texi 156103445Skan@include compat.texi 15790075Sobrien@include gcov.texi 15890075Sobrien@include trouble.texi 15990075Sobrien@include bugreport.texi 16090075Sobrien@include service.texi 16190075Sobrien@include contribute.texi 16290075Sobrien 16390075Sobrien@include funding.texi 16490075Sobrien@include gnu.texi 16590075Sobrien@include gpl.texi 16690075Sobrien 16790075Sobrien@c --------------------------------------------------------------------- 16890075Sobrien@c GFDL 16990075Sobrien@c --------------------------------------------------------------------- 17090075Sobrien 17190075Sobrien@include fdl.texi 17290075Sobrien 17390075Sobrien@include contrib.texi 17490075Sobrien 17590075Sobrien@c --------------------------------------------------------------------- 17690075Sobrien@c Indexes 17790075Sobrien@c --------------------------------------------------------------------- 17890075Sobrien 17990075Sobrien@node Option Index 18090075Sobrien@unnumbered Option Index 18190075Sobrien 18290075SobrienGCC's command line options are indexed here without any initial @samp{-} 18390075Sobrienor @samp{--}. Where an option has both positive and negative forms 18490075Sobrien(such as @option{-f@var{option}} and @option{-fno-@var{option}}), 18590075Sobrienrelevant entries in the manual are indexed under the most appropriate 18690075Sobrienform; it may sometimes be useful to look up both forms. 18790075Sobrien 18890075Sobrien@printindex op 18990075Sobrien 190117395Skan@node Keyword Index 191117395Skan@unnumbered Keyword Index 19290075Sobrien 19390075Sobrien@printindex cp 19490075Sobrien 19590075Sobrien@c --------------------------------------------------------------------- 19690075Sobrien@c Epilogue 19790075Sobrien@c --------------------------------------------------------------------- 19890075Sobrien 19990075Sobrien@bye 200