The makefile fragments in this "new build" directory are of three kinds:

  *  Platform fragments for OS-specific settings. (e.g.
     <code>linux-fragment.mk</code>);
  *  Compiler fragments for compiler-specific settings (e.g.
     <code>clang-fragment.mk</code>);
  *  Sample <code>pre-config.mk</code> fragments to use as a baseline for
     site-specific customization of the build process (e.g.
     <code>linuxgcc-pre-config.mk</code>.

Platform and compiler fragments should not be edited at site except to correct
errors in implementation or to add desirable new features so that clashes with
the <cite>Fossil</cite> repository don't interfere with operations. Where
possible all site customization should be done in pre- and post-config makefile
fragments. (Where this is not possible is probably indicative of modifications
required to the new build process.

To use the sample pre-config fragments, simply copy them into the
<cite>Fossil</cite> distribution's root directory as <code>pre-config.mk</code>
and edit to taste.

Note: new platform and compiler files are always welcome additions to the
community. In particular MacOSX and BSD builds would be nice to have.

#### Compiler-specific configuration for users of the CLANG compiler suite.
#

#### C Compiler and options for use in building executables that
#    will run on the platform that is doing the build.  This is used
#    to compile code-generator programs as part of the build process.
#    See TCC below for the C compiler for building the finished binary.
#
BCC = clang -g -O2

#### OS-specific configuration for building Fossil on FreeBSD systems.
#
# UNTESTED

#### The suffix to add to executable files.  ".exe" for windows.
#    Nothing for unix.
#
E =

#### The directory into which object code files should be written.
#
OBJDIR = ./obj

#### The following variable definitions decide which features are turned on or
#    of when building Fossil.  Comment out the features which are not needed by
#    this platform.
#
#ENABLE_STATIC = 1	# we want a static build
ENABLE_SSL = 1		# we are using SSL
#ENABLE_SOCKET = 1	# we are using libsocket (OpenSolaris and Solaris)
#ENABLE_NSL = 1		# we are using libnsl library (Solaris)
ENABLE_I18N = 1		# we are using i18n settings

#### Sample pre-config.mk file for FreeBSD with GCC.
#    Copy this file as pre-config.mk in the Fossil root directory to use.
#
# UNTESTED
PLATFORM=freebsd
COMPILER=gcc

#### Compiler-specific configuration for users of the GCC compiler suite.
#

#### C Compiler and options for use in building executables that
#    will run on the platform that is doing the build.  This is used
#    to compile code-generator programs as part of the build process.
#    See TCC below for the C compiler for building the finished binary.
#
BCC = gcc -g -O2

#### OS-specific configuration for building Fossil on Linux systems.
#

#### The suffix to add to executable files.  ".exe" for windows.
#    Nothing for unix.
#
E =

#### The directory into which object code files should be written.
#

#### Sample pre-config.mk file for Linux with CLANG.
#    Copy this file as pre-config.mk in the Fossil root directory to use.
#
PLATFORM=linux
COMPILER=clang

#### Sample pre-config.mk file for Linux with GCC.
#    Copy this file as pre-config.mk in the Fossil root directory to use.
#
PLATFORM=linux
COMPILER=gcc

#### OS-specific configuration for building Fossil on MingGW32 systems.
#

#### The suffix to add to executable files.
#
E = .exe

#### The directory into which object code files should be written.
#
OBJDIR = ./wobj

#### Sample pre-config.mk file for MinGW32.
#    Copy this file as pre-config.mk in the Fossil root directory to use.
#
PLATFORM=mingw32
COMPILER=gcc

#### OS-specific configuration for building Fossil on OpenSolaris systems.
#
# UNTESTED

#### The suffix to add to executable files.  ".exe" for windows.
#    Nothing for unix.
#
E =

#### The directory into which object code files should be written.
#
OBJDIR = ./obj

#### The following variable definitions decide which features are turned on or
#    of when building Fossil.  Comment out the features which are not needed by
#    this platform.
#
#ENABLE_STATIC = 1	# we want a static build
ENABLE_SSL = 1		# we are using SSL
ENABLE_SOCKET = 1	# we are using libsocket (OpenSolaris and Solaris)
#ENABLE_NSL = 1		# we are using libnsl library (Solaris)
ENABLE_I18N = 1		# we are using i18n settings

#### Sample pre-config.mk file for OpenSolaris with GCC.
#    Copy this file as pre-config.mk in the Fossil root directory to use.
#
# UNTESTED
PLATFORM=opensolaris
COMPILER=gcc

#### OS-specific configuration for building Fossil on Solaris (but not
#    OpenSolaris) systems.
#
# UNTESTED

#### The suffix to add to executable files.  ".exe" for windows.
#    Nothing for unix.
#
E =

#### The directory into which object code files should be written.
#
OBJDIR = ./obj

#### The following variable definitions decide which features are turned on or
#    of when building Fossil.  Comment out the features which are not needed by
#    this platform.
#
#ENABLE_STATIC = 1	# we want a static build
ENABLE_SSL = 1		# we are using SSL
ENABLE_SOCKET = 1	# we are using libsocket (OpenSolaris and Solaris)
ENABLE_NSL = 1		# we are using libnsl library (Solaris)
ENABLE_I18N = 1		# we are using i18n settings

#### Sample pre-config.mk file for Solaris with GCC.
#    Copy this file as pre-config.mk in the Fossil root directory to use.
#
# UNTESTED
PLATFORM=solaris
COMPILER=gcc