.TH BUILDER-CC 1 "2002-03-02" "Debian Project" "Debian GNU/Linux"
.SH NAME
builder-cc \- gcc wrapper to facilitate pentium-optimizations
.SH SYNOPSIS
.BI "export DEBIAN_BUILDARCH=" "architecture"
.br
.BI "export DEBIAN_BUILDGCCVER=" "gcc-version"
.br
.B gcc
.I ...
.SH "DESCRIPTION"
The
.B builder-cc
wrapper is normally used by calling
.B gcc
as usual. If the environment variable
.B DEBIAN_BUILDARCH
is not set,
.B builder-cc
does nothing, and the real
.B gcc
is invoked with the specified arguments.

When the
.B DEBIAN_BUILDARCH
environment variable is set,
.B builder-cc
invokes
.B gcc
with the specified arguments, plus
.IB "-mcpu=" "DEBIAN_BUILDARCH"
.IB "-march=" "DEBIAN_BUILDARCH"
This has the effect of telling
.B gcc
to use architecture-specific optimizations without changing the
command line. This is particularly useful for package builds.

If
.B DEBIAN_BUILDGCCVER
is not set,
.B builder-cc
calls
.BR gcc.real .
If
.B DEBIAN_BUILDGCCVER
is set,
.B builder-cc
calls
.B gcc-DEBIAN_BUILDGCCVER
instead.

.SH ENVIRONMENT
.IP DEBIAN_BUILDARCH
If set, the architecture to compile for. Useful values are
.B pentium
or
.BR pentiumpro .
.IP DEBIAN_BUILDGCCVER
If set, the version of gcc to be invoked. Useful values are
.B 3.0
or 
.BR 2.95 .

.SH NOTES
The real
.B gcc
is renamed
.BR gcc.real , 
and a diversion is
registered with
.BR dpkg-divert (1).
Thus
.BR builder-cc 's
idea of the default
.B gcc
is dictated by whatever package installed
.IR /usr/bin/gcc .

.SH "SEE ALSO"
.BR gcc (1)