gcc-8-source 8-20180414-1ubuntu2 / usr / src / gcc-8 / debian / README.Debian.amd64

               The Debian GNU Compiler Collection setup
               ========================================

Please see the README.Debian in /usr/share/doc/gcc, contained in the
gcc package for a description of the setup of the different compiler
versions.

For general discussion about the Debian toolchain (GCC, glibc, binutils)
please use the mailing list debian-toolchain@lists.debian.org; for GCC
specific things, please use debian-gcc@lists.debian.org.  When in doubt
use the debian-toolchain ML.


Maintainers of these packages
-----------------------------

Matthias Klose <doko@debian.org>
Ludovic Brenta <ludovic@ludovic-brenta.org>	(gnat)
Iain Buclaw <ibuclaw@ubuntu.com>		(gdc)
Aurelien Jarno <aurel32@debian.org>		(mips*-linux)
Aurelien Jarno <aurel32@debian.org>		(s390X*-linux)

The following ports lack maintenance in Debian: powerpc, ppc64,
sparc, sparc64 (unmentioned ports are usually handled by the Debian
porters).

Former and/or inactive maintainers of these packages
----------------------------------------------------

Falk Hueffner <falk@debian.org>			(alpha-linux)
Ray Dassen <jdassen@debian.org>
Jeff Bailey <jbailey@nisa.net>			(hurd-i386)
Joel Baker <fenton@debian.org>			(netbsd-i386)
Randolph Chung <tausq@debian.org>		(ia64-linux)
Philip Blundell <pb@debian.org>			(arm-linux)
Ben Collins <bcollins@debian.org>		(sparc-linux)
Dan Jacobowitz <dan@debian.org>			(powerpc-linux)
Thiemo Seufer <ths@networkno.de>		(mips*-linux)
Matt Taggart <taggart@carmen.fc.hp.com>		(hppa-linux)
Gerhard Tonn <GerhardTonn@swol.de>		(s390-linux)
Roman Zippel <zippel@linux-m68k.org>		(m68k-linux)
Arthur Loiret <arthur.loiret@gmail.com>		(gdc)

===============================================================================


rename-info-files:
  Allow transformations on info file names. Reference the
  transformed info file names in the texinfo files.

gcc-fuse-ld-lld-doc:
  Allow to use lld with -fuse-ld=ld.lld (documentation)

gcc-gfdl-build:
  Build a dummy s-tm-texi without access to the texinfo sources

gcc-textdomain:
  Set gettext's domain and textdomain to the versioned package name.

gcc-driver-extra-langs:
  Add options and specs for languages that are not built from a source
  (but built from separate sources).

gcc-hash-style-gnu:
  Link using --hash-style=gnu (aarch64, alpha, amd64, armel, armhf, ia64,
  i386, powerpc, ppc64, riscv64, s390, sparc)

libstdc++-pic:
  Build and install libstdc++_pic.a library.

libstdc++-doclink:
  adjust hrefs to point to the local documentation

libstdc++-man-3cxx:
  Install libstdc++ man pages with suffix .3cxx instead of .3

libstdc++-test-installed:
  Add support to run the libstdc++-v3 testsuite using the
  installed shared libraries.

alpha-no-ev4-directive:
  never emit .ev4 directive.

note-gnu-stack:
  Add .note.GNU-stack sections for gcc's crt files, libffi and boehm-gc
  Taken from FC.

libgomp-omp_h-multilib:
  Fix up omp.h for multilibs.

pr47818:

libgo-testsuite:
  Only run the libgo testsuite for flags configured in RUNTESTFLAGS

libgo-cleanfiles:

gcc-target-include-asm:
  Search $(builddir)/sys-include for the asm header files

libgo-revert-timeout-exp:

libgo-setcontext-config:
  libgo: Overwrite the setcontext_clobbers_tls check on mips*

gcc-auto-build:
  Fix cross building a native compiler.

kfreebsd-unwind:
  DWARF2 EH unwinding support for AMD x86-64 and x86 KFreeBSD.

libitm-no-fortify-source:
  Build libitm with -U_FORTIFY_SOURCE on x86 and x86_64.

sparc64-biarch-long-double-128:
  Fix --with-long-double-128 for sparc32 when defaulting to 64-bit.

pr66368:
  PR go/66368, build libgo with -fno-stack-protector

pr67590:
  Fix PR67590, setting objdump macro.

libjit-ldflags:

libffi-pax:

libffi-race-condition:

gcc-foffload-default:
  Allow setting offload targets by OFFLOAD_TARGET_DEFAULT

gcc-fuse-ld-lld:
  Allow to use lld with -fuse-ld=ld.lld

cuda-float128:

libffi-mipsen-r6:
  libffi: mips/n32.S: disable .set mips4 on mips r6

t-libunwind-elf-Wl-z-defs:
  strip -z,defs from linker options for internal libunwind.

gcc-alpha-bs-ignore:
  Ignore bootstrap comparison failures in gcc/d on alpha

libffi-riscv:
  Backport RISC-V support, taken from libffi commit 3840d49aaa

gcc-force-cross-layout:
  Add FORCE_CROSS_LAYOUT env var to force a cross directory layout.

gcc-as-needed-push-pop:

ada-arm:

ada-gcc-name:

ada-link-lib:

ada-libgnatvsn:
  - Introduce a new shared library named libgnatvsn, containing
  common components of GNAT under the GNAT-Modified GPL, for
  use in GNAT tools, ASIS, GLADE and GPS.   Link the gnat tools
  against this new library.

ada-gnattools-cross:
  - When building a cross gnat, link against the libgnatvsnBV-dev
  package.
  This link will be done by /usr/bin/$(host_alias)-gnat*, thus
  the native gnat with the same major version will be required.

ada-tools-move-ldflags:

ada-acats:
  - When running the ACATS, look for the gnat tools in their new
  directory (build/gnattools), and for the shared libraries in
  build/gcc/ada/rts and build/libgnatvsn.

ada-sjlj:

ada-lib-info-source-date-epoch:

ada-armel-libatomic:

gdc-8:
  This implements D language support in the GCC back end, and adds
  relevant documentation about the GDC front end (code part).

gdc-targetdm:

gdc-updates:
  gdc updates up to 20160115.

libphobos-zlib:
  Build zlib in any case to have a fall back for missing libz multilibs

gdc-frontend-posix:
  Fix build of the D frontend on the Hurd and KFreeBSD.

gdc-profiledbuild:
  Don't build gdc build tools idgen and impcnvgen with profiling flags

gdc-sparc-fix:
  Fix gdc build on sparc.

gdc-shared-by-default:
  Link with the shared libphobos library by default.

gdc-8-doc:
  This implements D language support in the GCC back end, and adds
  relevant documentation about the GDC front end (documentation part).

gdc-targetdm-doc:

gdc-libphobos-build:
  This implements building of libphobos library in GCC.

sys-auxv-header:
  Check for the sys/auxv.h header file.

arm-multilib-soft:
  ARM hard/soft float multilib support

arm-multilib-defaults:
  Set MULTILIB_DEFAULTS for ARM multilib builds

gcc-ice-dump:
  For ICEs, dump the preprocessed source file to stderr
  when in a distro build environment.

gcc-ice-apport:
  Report an ICE to apport (if apport is available
  and the environment variable GCC_NOAPPORT is not set)

skip-bootstrap-multilib:
  Skip non-default multilib and libstdc++-v3 debug builds in bootstrap builds

libffi-ro-eh_frame_sect:
  PR libffi/47248, force a read only eh frame section.

libffi-mips:
  Backport Mips go closure support, taken from libffi issue #197.

ada-kfreebsd:

ada-drop-termio-h:

gcc-multiarch:
  - Remaining multiarch patches, not yet submitted upstream.
  - Add MULTIARCH_DIRNAME definitions for multilib configurations,
  which are used for the non-multilib builds.

config-ml:
  - Disable some biarch libraries for biarch builds.
  - Fix multilib builds on kernels which don't support all multilibs.

g++-multiarch-incdir:
  Use /usr/include/<multiarch>/c++/4.x as the include directory
  for host dependent c++ header files.

canonical-cpppath:
  Don't use any relative path names for the standard include paths.

gcc-multilib-multiarch:
  Don't auto-detect multilib osdirnames.

gcc-as-needed:
  On linux targets pass --as-needed by default to the linker, but always
  link the sanitizer libraries with --no-as-needed.

gcc-as-needed-gold:
  Use --push-state/--pop-state for gold as well when linking libtsan.

libgomp-kfreebsd-testsuite:
  Disable lock-2.c test on kfreebsd-*

go-testsuite:
  Skip Go testcase on AArch64 which hangs on the buildds.

ada-749574:

ada-changes-in-autogen-output:

gcc-default-ssp:
  Turn on -fstack-protector by default for C, C++, ObjC, ObjC++.
  Build libgcc using -fno-stack-protector.

gcc-default-format-security:
  Turn on -Wformat -Wformat-security by  default for C, C++, ObjC, ObjC++.

gcc-default-ssp-strong:
  Default to -fstack-protector-strong starting with Ubuntu 14.10.

gcc-default-fortify-source:
  Turn on -D_FORTIFY_SOURCE=2 by default for C, C++, ObjC, ObjC++,
  if the optimization level is > 0

gcc-default-relro:
  Turn on -Wl,-z,relro by default.

testsuite-hardening-format:
  Description: use -Wno-format on tests that cannot be adjusted other ways.
  Author: Kees Cook <kees@ubuntu.com>
  Ubuntu: https://bugs.launchpad.net/bugs/344502

testsuite-hardening-printf-types:
  Description: adjust/standardize printf types to avoid -Wformat warnings.
  Author: Kees Cook <kees@ubuntu.com>
  Ubuntu: https://bugs.launchpad.net/bugs/344502

testsuite-hardening-updates:
  Fix some gcc and g++ testcases to pass with hardening defaults

testsuite-glibc-warnings:
  fix testcases that triggered -Wunused-result with glibc
  Author: Steve Beattie <steve.beattie@canonical.com>

bind_now_when_pie: