[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#654931: gcc-4.6: missing manpage

Package: gcc-4.6
Version: 4.6.2-11
Severity: wishlist
Tags: patch

gcc-4.6 and company are missing manpages.  I am aware that this is a
result of the upstream manpages being non-free.  Since policy requires a
manpage for each binary, I am including a skeletal manpage that covers
some of the most commonly used options.  I will update it further in the

-- System Information:
Debian Release: wheezy/sid
  APT prefers unstable
  APT policy: (500, 'unstable'), (1, 'experimental')
Architecture: amd64 (x86_64)

Kernel: Linux 3.1.0-1-amd64 (SMP w/4 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages gcc-4.6 depends on:
ii  binutils      2.22-3
ii  cpp-4.6       4.6.2-11
ii  gcc-4.6-base  4.6.2-11
ii  libc6         2.13-24
ii  libgcc1       1:4.6.2-11
ii  libgmp10      2:5.0.2+dfsg-2
ii  libgomp1      4.6.2-11
ii  libmpc2       0.9-4
ii  libmpfr4      3.1.0-3
ii  libquadmath0  4.6.2-11
ii  zlib1g        1:

Versions of packages gcc-4.6 recommends:
ii  libc6-dev  2.13-24

Versions of packages gcc-4.6 suggests:
pn  binutils-gold        <none>
pn  gcc-4.6-doc          <none>
pn  gcc-4.6-locales      <none>
pn  gcc-4.6-multilib     4.6.2-11
pn  libgcc1-dbg          <none>
pn  libgomp1-dbg         <none>
pn  libmudflap0-4.6-dev  <none>
pn  libmudflap0-dbg      <none>
pn  libquadmath0-dbg     <none>

-- no debconf information

brian m. carlson / brian with sandals: Houston, Texas, US
+1 832 623 2791 | http://www.crustytoothpaste.net/~bmc | My opinion only
OpenPGP: RSA v4 4096b: 88AC E9B2 9196 305B A994 7552 F1BA 225C 0223 B187
.\" Copyright © 2012 brian m. carlson
.\" This documentation is free software; you can redistribute it and/or modify
.\" it under the terms of your choice of:
.\" * version 2 of the GNU General Public License as published by the Free
.\"   Software Foundation;
.\" * version 2.0 of the Apache License as published by the Apache Software
.\"   Foundation; or
.\" * version 3.0 of the Creative Commons Attribution-ShareAlike License as
.\"   published by Creative Commons.
.\" This documentation is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" relevant licenses for more details.
.\" The only reference used here was the output of gcc itself.  No reference was
.\" made to other documentation during the writing of this manual page.
.TH GCC 1 2012-01-01 GNU Debian
gcc \- the GNU C Compiler
.B gcc
.IR options "] " FILE ...
.B gcc
is the GNU C compiler.  It is used to compile programs written in C or similar
languages into programs and libraries for execution.
While the
.B gcc
frontentd can also be used to compile other languages (see the
.B \-x
option), using the appropriate frontend is often better as it often includes
important libraries and options needed for successful compilation.  These
frontends are
.B g++
for C++,
.B gfortran
for Fortran,
.B gobjc
for Objective-C,
.B gobjc++
for Objective-C++, and
.B gccgo
for Go.
.B cpp
may be used if only the C preprocessor is needed; alternately, the
.B \-E
option to an appropriate frontend may be used.
.B gcc
supports a large number of options.  Most of these options can be used with any
frontend, but some are specific to a particular language or platform (processor
architecture or operating system).
.SS "General Options"
.B \-c
Invoke only the preprocessor (if appropriate), the compiler, and the assembler.
The result is an object file for the target platform.
.B \-E
Invoke only the preprocessor.  The result is preprocessed source.
.BI "\-o " FILE
Places the output of the compilation processes into
.B \-pipe
Use pipes instead of temporary files to pass data between compilation stages.
.B \-S
Invoke only the preprocessor (if appropriate) and the compiler.  The result is
assembly for the target platform.
.B \-\-save\-temps
Save the temporary files created during the compilation process.  This is useful
when filing a bug report.
.B \-v
Prints information about the version and configuration of the compiler, and if
any compilation or preprocessing step occurs, also prints information about the
compilation process used in those steps.
Pass OPTION to the assembler.
Pass OPTION to the linker.
Pass OPTION to the preprocessor.
The following files are to be interpreted as being in LANGUAGE.
This continues until another
.B \-x
option is given.
.BR none ,
revert to autodetection based on the file's extension.
Valid values include
.BR c ,
.BR c++ ,
.BR assembler ,
.BR none .
.SS "Options for C-like Languages"
.B \-ansi
Equivalent to
.B \-std=c89
for C and
.B \-std=c++98
for C++.
.BR \-std =\fISTANDARD\fP
Specify that the input conforms and the compiler should conform to STANDARD.
For C, this can be
.BR c89 ,
.BR c90 ,
.BR iso9899:1990
(for the ISO 1990 C standard);
.BR iso9899:199409
(for the ISO 1990 C standard as amended in 1994);
.BR c99 ,
.BR c9x ,
.BR iso9899:1999 ,
.BR iso9899:199x
(for the ISO 1999 C standard);
.B c1x
.B c11
(for the ISO 2011 C standard);
or one of
.BR gnu89 ,
.BR gnu90 ,
.BR gnu99 ,
.BR gnu9x ,
.BR gnu1x ,
.B gnu11
for the corresponding standard with GNU extensions.
For C++, this can be
.BR c++98 ,
.BR c++03
(for the ISO 1998 C++ standard as amended in 2003);
.BR c++0x
(for the ISO 2011 C++ standard);
or one of
.BR gnu++98
.BR gnu++0x
for the corresponding standard with GNU extensions.
.SS "Warning Options"
All the options beginning with
.B \-W
can take a negative form by using
.B \-Wno\-
instead.  If multiple arguments modify the same warning, the last modification
.B \-pedantic
Warn whenever the appropriate standard requires a diagnostic.
.B \-pedantic\-errors
Signal an error whenever the appropriate standard requires a diagnostic.
.B \-Wall
Enable most warnings.
.B \-Werror
Treat all warnings as errors.
.SS "Options to Control Code Generation and Optimization"
.BR \-ffunction\-sections
Place each function in its own section.  This may be needed on certain
architectures that have branch instructions that have a limited distance.
.BR \-flto
When compiling, generate an intermediate representation as well as normal code.
When linking, use this intermediate representation to optimize across files.
In order to work, this option must be given both when compiling and linking.
.BR \-fomit\-frame\-pointer
Omit the frame pointer.  On some architectures, the register normally used for
the frame pointer can be pressed into use, which may allow the compiler to
generate code.  On other architectures, the frame pointer is part of the
standard calling sequence and omitting it is not useful.  Using this option may
impede debugging on some architectures.
.BR \-fPIC
Generate position-independent code.  This is generally required for shared
libraries to function correctly.  On some platforms, all code is
position-independent and this option has no effect.  Using it anyway will
produce a warning.
.BR \-fPIE
Generate position-independent code suitable only for executables.  The resulting
code cannot be linked into a shared library, but is still useful to generate
binaries that will work with ASLR (address space layout randomization).  On some
platforms, all code is position-independent and this option has no effect.
Using it anyway will produce a warning.
.BR \-fstack\-protector
Generate code to check for stack overflows in most functions.
.BR \-fstack\-protector\-all
Generate code to check for stack overflows in all functions, no matter how
.BR \-fwhole\-program
This option tells the compiler to try to optimize the program as a whole.  This
only works when all the source files are passed on the command line.
.BR \-fwrapv
Signed overflow is undefined.  This option makes the compiler assume that signed
overflow wraps around.  The use of this option may enable certain optimizations
and disable others as a result of this assumption.
.BR \-g
Generate debugging information in the default format for this platform.
Enabling optimization may cause the debugging information to appear strange.
If NUMBER is 0, do not optimize the code at all.  Otherwise, if NUMBER is
positive, optimize the code.  NUMBER may be as large as 3, each value taking
progressively more time and memory to optimize.
.B \-Ofast
Optimize the code aggressively without regard for standards compliance.
.B \-Os
Optimize the code for size, not speed.
.B \-shared
Generate a shared library.  Generally this will be used with
.BR \-fPIC .
.SS "Options to Control Code Syntax"
.B \-fpermissive
Be more lenient in accepting invalid code.  Since
.B gcc
tends to become stricter over time, especially with regard to C++ conformance,
this option can be used to allow older code to compile temporarily.
.B \-fsigned\-char
.B \-funsigned\-char
.B char
type, while distinct from
.B "signed char"
.BR "unsigned char" ,
has the range of values of either the former or the latter.  Which one
specifically is dependent on the architecture and platform, and is usually
specified in the appropriate ABI.  This option allows the default to be changed
for a given file or files.
Exits 0 on success, or nonzero on error.
.B gcc
attempts conforms to the relevant standards when an appropriate
.B -std
option is specified with
.BR -pedantic .
If it does not, please file a bug.
When reporting bugs, please follow the directions listed in
.IR /usr/share/doc/gcc/README.Bugs .
Without providing sufficient information, your bug will not be able to be
reproduced or investigated and therefore will not be able to be fixed.
This manual page was written because the manual pages provided with
.B gcc
are not Free Software according to the Debian Free Software Guidelines.  As
such, you should not bother the Free Software Foundation with it.  Please report
bugs in this manual page to brian m. carlson <sandals@crustytoothpaste.net>.
.\" vim: set ft=groff:

Attachment: signature.asc
Description: Digital signature

Reply to: