NAME

       builder-cc - gcc wrapper to facilitate pentium-optimizations

SYNOPSIS

       export DEBIAN_BUILDARCH=architecture
       export DEBIAN_BUILDGCCVER=gcc-version
       gcc ...

DESCRIPTION

       The  builder-cc  wrapper  is  normally  used  by  calling  gcc  as  usual.  If  the  environment variable
       DEBIAN_BUILDARCH is not set, builder-cc does nothing, and the real gcc  is  invoked  with  the  specified
       arguments.

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

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

ENVIRONMENT

       DEBIAN_BUILDARCH
              If set, the architecture to compile for. Useful values are pentium or pentiumpro.

       DEBIAN_BUILDGCCVER
              If set, the version of gcc to be invoked. Useful values are 3.0 or 2.95.

NOTES

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

SEE ALSO

       gcc(1)

Debian Project                                     2002-03-02                                      BUILDER-CC(1)