@@ -1,59 +1,59 @@ - How to build Reduce using CSL - ============================= - - -These instructions are only necessary if you are going to re-build both CSL -and REDUCE from scratch, possibly using a quite different C compiler -from the one that Codemist used to prepare this distribution. - -Make sure that you know where the "cslbase" directory is (it does not -have to be within the REDUCE source tree, but in this distribution -that is where it will start off). - -The REDUCE source should have directories within it called src, cslsrc, -xmpl and xlog (and probably some others). At the same level create a new -empty directory. A suitable (long) name for this directory would indicate -what machine, operating system and C compiler you are using, eg - csl_hp9000_unix_c89 - or csl_80x86_win95_watcom -but as a matter of practicality you will probably choose a shorter name. -Select that directory as current. - -Copy into it the files "makemake.c" from the "cslbase" and "makebase" from -the "cslsrc" directory. Use your C compiler to compile makemake.c so you have -an executable called makemake. E.g., on some Unix systems the command would be - gcc makemake.c -o makemake -but sometimes you will need to specify other command line options to the -C compiler.where the C compiler. The program "makemake.c" attempts to be -as portable and system independent as it can be and ought to compile -unaltered on any system you are liable to come across. - -Now go - makemake -and you should see a list of options (extracted from the file "makebase"). -Inspect them, and choose the ones you want, then go (for instance) - makemake -o Makefile sparc gcc -or makemake -o makefile win95 microsoft - -When asked to, enter the location of the "cslbase" directory. Even when using -DOS or Windows you should give the directory path with "/" characters as -separators not "\". The command should create a file called "Makefile" for -you. If the makebase prototype does not provide options that match your -system precisely, or if changes to your operating system or C compiler render -its contents out of date you should specify the closest set of options to -your needs and then inspect and as necessary edit Makefile for yourself. This -should not usually be necessary. - -Now try - make csl [for Unix] - or make csl.exe [for DOS/Windows] -followed by - make slowr36.img - make ccode - make r36.img - - -The system comes with the final files from all this pre-built using Watcom -C version 10.5, and the files are in a directory r36\cslwin95. - + How to build Reduce using CSL + ============================= + + +These instructions are only necessary if you are going to re-build both CSL +and REDUCE from scratch, possibly using a quite different C compiler +from the one that Codemist used to prepare this distribution. + +Make sure that you know where the "cslbase" directory is (it does not +have to be within the REDUCE source tree, but in this distribution +that is where it will start off). + +The REDUCE source should have directories within it called src, cslsrc, +xmpl and xlog (and probably some others). At the same level create a new +empty directory. A suitable (long) name for this directory would indicate +what machine, operating system and C compiler you are using, eg + csl_hp9000_unix_c89 + or csl_80x86_win95_watcom +but as a matter of practicality you will probably choose a shorter name. +Select that directory as current. + +Copy into it the files "makemake.c" from the "cslbase" and "makebase" from +the "cslsrc" directory. Use your C compiler to compile makemake.c so you have +an executable called makemake. E.g., on some Unix systems the command would be + gcc makemake.c -o makemake +but sometimes you will need to specify other command line options to the +C compiler.where the C compiler. The program "makemake.c" attempts to be +as portable and system independent as it can be and ought to compile +unaltered on any system you are liable to come across. + +Now go + makemake +and you should see a list of options (extracted from the file "makebase"). +Inspect them, and choose the ones you want, then go (for instance) + makemake -o Makefile sparc gcc +or makemake -o makefile win95 microsoft + +When asked to, enter the location of the "cslbase" directory. Even when using +DOS or Windows you should give the directory path with "/" characters as +separators not "\". The command should create a file called "Makefile" for +you. If the makebase prototype does not provide options that match your +system precisely, or if changes to your operating system or C compiler render +its contents out of date you should specify the closest set of options to +your needs and then inspect and as necessary edit Makefile for yourself. This +should not usually be necessary. + +Now try + make csl [for Unix] + or make csl.exe [for DOS/Windows] +followed by + make slowr36.img + make ccode + make r36.img + + +The system comes with the final files from all this pre-built using Watcom +C version 10.5, and the files are in a directory r36\cslwin95. +