# This is a configuration file for global configuration values which will
# define where various system resources are located as well as certain other
# build behaviours.  Everything here is highly optional.  You can also get a
# quick list of the variables by doing a grep "^##" on this file.

## Global Configuration Controls
##
## DLG_SOURCEREPOS - This variable is a space separated list of places on the
##   local filesystem to search for source tarballs.  Patches should still be
##   kept in DLG_ROOT/SOURCES/packagename.  DLG_ROOT/SOURCES/packagename will
##   be the first place the build system will look for tarballs.  Should the
##   system need to _download_ a tarball, the _last_ entry in this list is
##   where it will be stored.  However, patches will be stored in
##   DLG_ROOT/SOURCES/packagename anyway.
##
#DLG_SOURCEREPOS="/usr/src/pc/SOURCES /space/tarballs"

## DLG_ORDERLYSOURCES - If you prefer that source tarballs will be downloaded
##   into the DLG_ROOT/SOURCES/PKG_NAME directory, define this variable to
##   something non-null and when they're downloaded they'll be stored in
##   the private individual directories instead of the one big one at the end
##   of DLG_SOURCEREPOS.  Thank Diffie for requesting this.
#DLG_ORDERLYSOURCES=""

## DLG_COREREPOS - Okay.  The name for this variable sucks, but as soon as
##   I can think of a name more functionally descriptive I will change it.
##   What it is is a formal description of DLG_ROOT/SOURCES so that we can
##   tack the name of packages onto the end of it and make it relocatable.
##
#DLG_COREREPOS=$DLG_ROOT/SOURCES

## DLG_KEEPLOGS - This variable controls whether or not to make logs of the
##   output of commands like configure and make and make install when you are
##   building your packages.  The default is to keep them.  ***NYI***
##
#DLG_KEEPLOGS=1

## DLG_VERBOSITY - Controls the verbosity of the build output.  ***NYC***
##   Levels 4-5 are really only useful if you're interested in debugging the
##   build engine itself.  They are quite spammy otherwise.  Output is color
##   coded if your terminal supports it.  For people who are already pretty
##   sure their package will build correctly, 2 (or 1) is best.
##   0 - Quiet, exits silently unless you remember to check $?.
##   1 - "Executive Overview" about which package it is building, no details
##   2 - Informs you about what package is cooking, and what stage it's in.
##   3 - Shows you compiler instructions and output in realtime
##   4 - Gives details about which routines are being called, etc.
##   5 - Verbal Avalanche Warning (automagic variable settings, etc)
DLG_VERBOSITY=5

## DLG_PKGER - This appends a short string to the end of the revision number
##   for a package.  Release packages use "dl".  Devel packages, "builder"
##   Note that if you have the environment variable DLG_ALPHATESTER set to
##   enable building of potentially unstable alpha packages, this will get
##   "alpha" appended to it!
##
DLG_PKGER="dl"

## DLG_ZPREF - This sets the order that the build system will prefer
##   the tarballs to be kept in.  New package downloads will be attempted
##   based on the extentions you specify here so long as you do _not_ attempt
##   to specify them in the PKG_SOURCE variable (i.e, just leave the
##   the compression extention off the filename in the URL.)  This will also
##   dictate what compression methods are used on the build logs.  ***NYI***
##
#DLG_ZPREF="bz2 gz"

## DLG_WGET - This sets the location of the wget binary, just in case you
##   want to use some other "wget-alike" program to download files with.
##
#DLG_WGET=`which wget`

## DLG_WGETARGS - This sets the optional arguments you can add to wget to
##   have a little more control over the download process.  If your network
##   requires an explicity proxy setting, you want to throttle wget's download
##   speed, or you need to specify passive FTP modes explicitly, this is the
##   place to do it.
#DLG_WGETARGS="--tries=3 --random-wait"

## DLG_BUILDROOT - This sets the place where the tarballs will be uncompressed
##   for building.
##
#DLG_BUILDROOT=/tmp/DLG/BUILD 

## * Compile configuration options
##

## DLG_OPTLEVEL - This sets the optimization level of the binaries which is
##   passed to gcc as -O2, -O3, or whatever.  It's recommended you leave it
##   at -O2, as -Os and -O3 have both been known to produce flawed code.
#DLG_OPTLEVEL="-O2"

## DLG_ARCH - This sets the architecture target for the compiler which is
##   passed to gcc as -march=$DLG_ARCH.  Consider this the least powerful
##   CPU that the resulting binary will run on.  This setting will generally
##   imply to gcc that the same thing should be done for -mcpu, so you only
##   need to set the arch setting *and* the cpu setting if you want them to
##   be different for some reason.
##DLG_ARCH="i486"    # Slackware-compatible setting.
##DLG_ARCH="x86-64"  # Slamd64, or Athlon64's in general
DLG_ARCH="i686"

## DLG_CPU - This sets the target CPU that the compiler will tune the binary
##   for, and is passed to gcc as -mcpu=$DLG_CPU.  Mostly this does nothing
##   so we leave it blank.  Tuning for one type of CPU means de-tuning for
##   others so you probably shouldn't use this on binaries you intend to give
##   to other people anyway.
##DLG_CPU="i686"  # Slackware-compatible setting.

## DLG_PREFIX - This is the prefix you want used for all your binaries.
##   It is not recommended you change this.
##
#DLG_PREFIX=/usr

## DLG_SYSCONFDIR - This is where you want the configuration files to go.
##   It's not recommended you change this, either.
##
#DLG_SYSCONFDIR=/etc

## DLG_LOCALSTATEDIR - This is where you want non-executeable runtime files
##   for binaries to go.  The name of the variable is a big hint.  Don't
##   bother changing this one either. 
##
#DLG_LOCALSTATEDIR=/var/lib

## DLG_DOCDIR - This is the place where legal documentation and README-like
##   files are to be put.  It's doubtful you'll need to change this.
##
#DLG_DOCDIR=$DLG_PREFIX/doc

## DLG_DATADIR - This is the place where most program's runtime data lives.
##   It's not often we'll have to pass it to anything, but we WILL need it
##   for the occasional installation script!
##
#DLG_DATADIR=$DLG_PREFIX/share

## DLG_NOCFLAGS - Setting this to 1 will disable _all_ generated CFLAGS
##   settings for every build.  Build scripts will then use what the authors
##   originally chose (no matter how bad they might be) and nothing else.
##   Just don't ever set this unless you want a completely barren build.
##   If you want to disable CFLAGS generation for an individual package, then
##   add PKG_NOCFLAGS to the package's build script.
##
#DLG_NOCFLAGS=0

## DLG_CFLAGS - If you absolutely, positively, have to specify the same
##   CFLAGS for everything, you can do it with this variable, but I would
##   recommend strongly /against/ doing this--the packager will construct
##   a reasonable CFLAGS setting based on DLG_OPTLEVEL, DLG_ARCH, and
##   DLG_CPU as well as any necessary hints from the package builder and 
##   setting this disables that.
##
#DLG_CFLAGS=""

## DLG_DESTDIRVAR - For the vast majority of GNU autoconf-built makefiles
##   the variable DESTDIR can be passed during the `make install` phase in
##   a manner such as `make DESTDIR=/tmp/foo install` to cause the makefile
##   to prefix all the installation paths with "/tmp/foo" so that the files
##   can easily be rounded up into a binary package.  If you need to change
##   this, do so using PKG_DESTDIRVAR in your package definition!  
##
#DLG_DESTDIRVAR=DESTDIR

## DLG_SCRATCHROOT - Building packages can take up a lot of disk space,
##   sometimes up to a Gb.  This variable controls the root for where Dropline
##   opens tarballs and creates binaries.  It should be on a filesystem which
##   has plenty of space, no unusual permissions or ownership restraints, and
##   preferably on a fast disk.  NFS or SMB-mounted shares would be a very bad
##   choice.
##
#DLG_SCRATCHROOT=/tmp/DLG

## DLG_LOGROOT - This variable when set will control where your logfiles will
##   be kept.  If you put this inside DLG_ROOT you'll have a problem with
##   replicating the build environment without bloating things with extra
##   megabytes-worth of log files.  You have been warned.  The default is
##   DLG_SCRATCHROOT/LOGS for good reason.
##
#DLG_LOGROOT=$DLG_SCRATCHROOT/LOGS

## DLG_STAGEROOT - This is the root directory where all the binaries created
##   by the build system.  It would be a bad idea to have any kind of special
##   umasks or automatic file ownership on the filesystem that this points at.
##   A very, very bad idea.
##
#DLG_STAGEROOT=$DLG_SCRATCHROOT/STAGE

## DLG_DOCFILES - This is a list of files that will be by default assumed to be
##   documentation for redistribution which should be copied into PKG_DOCDIR.
##
#DLG_DOCFILES="ABOUT* ANNOUNCEMENT API AUTHORS BUGS ChangeLog* CHANGES Copyright COPYRIGHT COPYING* FAQ HACKING INSTALL* LICEN?E MAINTAINERS NEWS* README* STYLEGUIDE TODO* THANKS USAGE VERSION"

## DLG_TIMESTAMP - If you want to set the same timestamp on every single file
##   for a Dropline release, this is (or will be) the variable to do it with.
##   For now, don't bother setting it here.  It will be set on a per-package
##   basis using PKG_TIMESTAMP, unless, of course, you want to apply phony
##   timestamps to everything.
##
#DLG_TIMESTAMP=`date +%Y%m%d%H%M.%S`

## DLG_PACKAGEROOT - This is the directory where completed binary packages
##   are placed when they're all ready to go.
##
#DLG_PACKAGEROOT=$DLG_SCRATCHROOT/PACKAGES
DLG_PACKAGEROOT=/space/dropline-2.12

## DLG_SFMIRROR - This is the hostname of your favorite sourceforge mirror.
##   It will be used when downloading some source files.  It has a package-
##   specific cousin named PKG_SFMIRROR.
##
#DLG_SFMIRROR="easynews"
