1.4 Installation on DOS
On DOS-based systems, it’s possible to install
C-INTERCAL via compiling it using DJGPP, a free DOS
development system. (You can obtain DJGPP via its homepage, at http://www.delorie.com/djgpp/.) The
process for installing it works like this:
- To start with, you will need to install DJGPP and various utilities
(especially many of the GNU utilities) that come with it. To do this,
see the instructions on DJGPP’s website, and download and unpack
any additional packages on this list that you did not install as part
of those instructions (a filename by which the package can be found on
DJGPP mirrors is given, and a version number with which
C-INTERCAL was tested is given as part of the filename,
but other versions are likely to work as well):
- Unzip32 (‘unzip32.exe’) — to
unpack the other packages
- DJGPP development kit
(‘v2/djdev203.zip’) — needed for all
DJGPP compiles
- CS’s DPMI Provider
(‘v2misc/csdpmi7b.zip’) — you need
some DPMI provider to run C-INTERCAL on a plain DOS
system, although this is not needed on systems such as Microsoft
Windows’ emulation of DOS which already include a DPMI
provider
- GNU Binutils (‘v2gnu/bnu219b.zip’)
— needed to produce executables
- gcc (‘v2gnu/gcc444b.zip’) — used
to compile C code
- GNU make (‘v2gnu/mak3791b.zip’)
— used to resolve dependencies within the build system
- GNU bash (‘v2gnu/bsh204b.zip’) —
used to interpret build scripts
- GNU Diffutils (‘v2gnu/dif20b.zip’)
— used by the build scripts
- GNU Fileutils (‘v2gnu/fil41b.zip’)
— used by the build scripts
- GNU Findutils (‘v2gnu/find41b.zip’)
— used by the build scripts
- GNU awk (‘v2gnu/gwk318b.zip’) —
used by the build scripts
- GNU sed (‘v2gnu/sed421b.zip’) —
used by the build scripts
- GNU Shellutils (‘v2gnu/shl2011b.zip’)
— used by the build scripts
- GNU Textutils (‘v2gnu/txt20b.zip’)
— used by the build scripts, and sometimes by
C-INTERCAL itself too
You might want to install other packages, particularly GNU Bison
and GNU Flex, in order to be able to rebuild certain parts of the
compiler if you change them. This is not necessary to simply be
able to run C-INTERCAL without changing it, though.
- Test your DJGPP install to ensure it works, and make sure you have
environment variables set up correctly. In addition to the
‘DJGPP’ variable that points to your
‘DJGPP.ENV’ file, and the
‘PATH’ variable that needs to contain
DJGPP’s binaries directory, you also need to set the
‘DJDIR’ environment variable to point to the
main DJGPP installation directory.
- Unpack a copy of C-INTERCAL in its own directory, if
you haven’t already (see Unpacking).
- Load up a
bash
session, change to the
‘buildaux’ subdirectory of your main
C-INTERCAL directory, and run the command
build-dj.sh
. This will run the entire
C-INTERCAL build system, and hopefully end up with
executables you can run in the ‘build’
subdirectory that will be created in your main C-INTERCAL
directory.
- If you wish, you can install C-INTERCAL by using the
command
make install
from the new
‘build’ subdirectory. It will run just fine
in-place without a need to install, though, if you prefer.