BIN2REM Version 1.0  (Mar 27, 2006)

Freeware by Paolo Ferraris (pieffe8_at_libero.it)

The program comes with no guarantees of any kind.


INTRODUCTION

bin2rem is a utility that, given a machine-code program, generates
a BASIC program that includes that program and automatically executes it.
The BASIC program is then inserted into a TAP file.

Normally machine code is inserted into a REM statement, for instance in
the following way:

0 RANDOMIZE USR xxxxx: REM machine-code <CR>

Since this utility has been developed to be used for the minigame compo,
it has been optimized to save as much space as possible. Consequently,
the xxxxx looks like 0, and the REM keyword and carriage return (<CR>)
are omitted.


SYNTAX

> bin2rem inputfile outputfile filename

inputfile is the file that contains the machine-code program to be inserted
into the BASIC program.

outputfile is the name of the TAP file. The TAP extension is not added
automatically.

filename is the file name of the BASIC program (max 10 characters, no spaces).


REQUIREMENTS

The machine-code program is put at address 23769 and launched at that
address. The program may need recompiling or the addition of some relocating
routine.

The utility has been compiled under DJGPP. It works under Windows, and it has
not been tested under real DOS. The source code is available and easily
compilable under any C++ compiler, expecially G++. It can also easily adapted
to work with plain C compilers.


Comments and suggestions are welcome.
