2.2 Compile under DOS

IMYplay, in various versions, has been successfully compiled on the following systems:

• FreeDOS (DJGPP + NASM)
• DOSBox (DJGPP + NASM)

Requirements for automatic compiling the DOS version:

• a working GCC compiler (preferably DJGPP).
• development package for the C library (comes with DJGPP)
• the make program (comes with DJGPP)
• if you want sound, not just MIDI conversion, a development package for one of the supported libraries (except PC-speaker, which requires only the C library). If you don’t have any of these installed or available, then go to
  http://alleg.sf.net/ - for the Allegro library
• MIDI output requires the following functions from the standard C library: ‘malloc()’, ‘realloc()’, ‘memset()’, ‘memcpy()’, ‘fopen()’, ‘fwrite()’, ‘fseek()’, ‘fclose()’ and ‘qsort()’.
• the sed utility (comes with DJGPP)
• the zip utility (comes with DJGPP)
• NASM assembler version >= 2.0 (https://www.nasm.us)
• the upx utility (http://upx.sf.net) is optional. The program is compiled correctly without it.

To compile under DOS using DJGPP, either enable LFN support or find your GCC’s limits.h file (NOT the standard one) and change the line

#include "syslimits.h"

to

#include "syslimit.h"

Then, run ‘make -f Makefile.dos’. If you don’t have a make utility, you can run the dosdist.bat file.

If you want to override the default C compiler, run ‘make -f Makefile.dos CC=your-compiler’.

If you want to override the default C compiler flags, run ‘make -f Makefile.dos CC_OPTS=your-compiler-flags’.

If you prefer the flex-based parser, install the flex utility (from https://github.com/westes/flex) and run ‘make -f Makefile.dos FLEX=1’.

If you prefer to compile manually (like when you don’t have all of the required utilities, then go to the src directory. Change VERSION with the at- and quotation marks to the current version number in the imyp_cfg.hin file, so the line reads:

# define PACKAGE_VERSION "2.0"

and rename the file to imyp_cfg.h. Then compile all the files you wish to (the dosfiles.txt file is a good starting point), for example:

‘gcc -o imyplay.exe *.c -lalleg’

The resulting imyplay.exe is the program to use.