- 1. move to the directory that matches the platform and compiler you
- want to build for and type make. The directories are all located
- underneath the build/platforms directory. If your platform is not
- there, you may need to do a port - see the build/PORTS file for
- more information. For a Sun running SunOS 4.1.4, you might do
- this:
+1. Create a directory for the platform object files.
+
+ % mkdir obj-platform
+
+2. Change your working directory to the platform object directory.
+
+ % cd obj-platform
+
+3. Configure the build system
+
+ % [env settings] ../configure --src-dir=.. [options]
+
+ ( replace ".." with the appropriate path )
+
+4. Continue as above (starting at step 6).
+
+CONFIGURE OPTIONS
+-----------------
+
+Regrettably, this section has not been written (yet). See
+"./configure --help" for current list of options. For general
+information about how to use "configure", please read
+doc/install/configure.
+
+USING ENVIRONMENT VARIABLES
+---------------------------
+
+The configure script will also use your environmental variables for
+determining compiler/linker options. This can be used to manual
+specify features and compilation options.
+
+Warning: Executables built in your environment may not run in your
+users' environments. The portability of executables between
+environments is your responsibility.
+
+Supported Environmental Variables:
+
+ CC C compiler cc
+ CFLAGS C flags -O -g
+ CPPFLAGS cpp flags -I/path/include -Ddef
+ LDFLAGS ld flags -L/usr/local/lib
+ LIBS libraries -llib
+ PATH command path /usr/local/bin:/usr/bin:/bin
+
+o Including alternative compilers
+
+ Use the CC environment variable to tell configure to use a
+ specific compiler. For example, to use GNU C Compiler instead of
+ the default compiler, use: