← Back to branch summary

~ubuntu-branches/debian/stretch/gcc-6-doc/stretch

« back to all changes in this revision

Viewing changes to gcc/doc/invoke.texi

  • Committer: Package Import Robot
  • Author(s): Guo Yixuan (郭溢譞)
  • Date: 2016-05-06 21:45:33 UTC
  • Revision ID: package-import@ubuntu.com-20160506214533-1ro717riyxkhd4kn
Tags: 6.1.0-1
http://bugs.debian.org/822667
* New upstream branch. (Closes: #822667)
* Synced patches with gcc-6, 6.1.1-1.
* Use https URIs for Vcs-*.
* Bumped standards version to 3.9.8, no changes needed.
* Update debian/copyright.

Show diffs side-by-side

added added

removed removed

Lines of Context:
gcc/doc/invoke.texi
1313
1313
Ada source code file containing a library unit body (a subprogram or
1314
1314
package body).  Such files are also called @dfn{bodies}.
1315
1315
 
 
1316
@item @var{file}.d
 
1317
D source code file.
 
1318
 
 
1319
@item @var{file}.di
 
1320
D interface code file.
 
1321
 
 
1322
@item @var{file}.dd
 
1323
D documentation code file.
 
1324
 
1316
1325
@c GCC also knows about some suffixes for languages not yet included:
1317
1326
@c Pascal:
1318
1327
@c @var{file}.p
1348
1357
objective-c++ objective-c++-header objective-c++-cpp-output
1349
1358
assembler  assembler-with-cpp
1350
1359
ada
 
1360
d
1351
1361
f77  f77-cpp-input f95  f95-cpp-input
1352
1362
go
1353
1363
java
1618
1628
@item -fdump-ada-spec@r{[}-slim@r{]}
1619
1629
@opindex fdump-ada-spec
1620
1630
For C and C++ source and include files, generate corresponding Ada specs.
1621
 
@xref{Generating Ada Bindings for C and C++ headers,,, gnat_ugn,
 
1631
@xref{Generating Ada Bindings for C and C++ headers,,, @value{fngnatugn},
1622
1632
GNAT User's Guide}, which provides detailed documentation on this feature.
1623
1633
 
1624
1634
@item -fada-spec-parent=@var{unit}
10580
10590
@option{-nodefaultlibs} is @file{libgcc.a}, a library of internal subroutines
10581
10591
which GCC uses to overcome shortcomings of particular machines, or special
10582
10592
needs for some languages.
10583
 
(@xref{Interface,,Interfacing to GCC Output,gccint,GNU Compiler
 
10593
(@xref{Interface,,Interfacing to GCC Output,@value{fngccint},GNU Compiler
10584
10594
Collection (GCC) Internals},
10585
10595
for more discussion of @file{libgcc.a}.)
10586
10596
In most cases, you need @file{libgcc.a} even when you want to avoid
10589
10599
This ensures that you have no unresolved references to internal GCC
10590
10600
library subroutines.
10591
10601
(An example of such an internal subroutine is @code{__main}, used to ensure C++
10592
 
constructors are called; @pxref{Collect2,,@code{collect2}, gccint,
 
10602
constructors are called; @pxref{Collect2,,@code{collect2}, @value{fngccint},
10593
10603
GNU Compiler Collection (GCC) Internals}.)
10594
10604
 
10595
10605
@item -pie
15527
15537
values such as not-a-number and plus/minus infinity.  Other Alpha
15528
15538
compilers call this option @option{-ieee_with_no_inexact}.
15529
15539
 
 
15540
DEBIAN SPECIFIC: This option is on by default for alpha-linux-gnu, unless
 
15541
@option{-ffinite-math-only} (which is part of the @option{-ffast-math}
 
15542
set) is specified, because the software functions in the GNU libc math
 
15543
libraries generate denormalized numbers, NaNs, and infs (all of which
 
15544
will cause a programs to SIGFPE when it attempts to use the results without
 
15545
@option{-mieee}).
 
15546
 
15530
15547
@item -mieee-with-inexact
15531
15548
@opindex mieee-with-inexact
15532
15549
This is like @option{-mieee} except the generated code also maintains
25085
25102
@option{-B}, @option{-I} and @option{-L} (@pxref{Directory Options}).  These
25086
25103
take precedence over places specified using environment variables, which
25087
25104
in turn take precedence over those specified by the configuration of GCC@.
25088
 
@xref{Driver,, Controlling the Compilation Driver @file{gcc}, gccint,
 
25105
@xref{Driver,, Controlling the Compilation Driver @file{gcc}, @value{fngccint},
25089
25106
GNU Compiler Collection (GCC) Internals}.
25090
25107
 
25091
25108
@table @env
25245
25262
 
25246
25263
A precompiled header file is searched for when @code{#include} is
25247
25264
seen in the compilation.  As it searches for the included file
25248
 
(@pxref{Search Path,,Search Path,cpp,The C Preprocessor}) the
 
25265
(@pxref{Search Path,,Search Path,@value{fncpp},The C Preprocessor}) the
25249
25266
compiler looks for a precompiled header in each directory just before it
25250
25267
looks for the include file in that directory.  The name searched for is
25251
25268
the name specified in the @code{#include} with @samp{.gch} appended.  If