mkepr has been written in Forth for Gforth, and needs two modules of the Forth Foundation Library.
Gforth and the Forth Foundation Library must be installed on the system.
Make sure the <mkepr.fs> is executable. Then copy, move or link it to a directory on your path.
Example for single-user installation:
chmod u+x mkepr.fs ln mkepr.fs ~/bin/mkepr
Example for system-wide installation:
chmod ugo+x mkepr.fs ln mkepr.fs /usr/local/bin/mkepr
Usage: mkepr [options] [files]
-?, --help show this help
--version show version info
-f, --flash create an Intel Flash card instead of an EPROM card
-o, --output=FILE set output file; default: output.epr (or output.flash)
-s, --size=KiB set the card size; defaults: 32 KiB (EPROM), 512 KiB
(Flash)
-q, --quiet quiet mode: input files will not be listed
Note: mkepr must receive a literal list of filenames (including
their paths). Sometimes a shell regular expression is enough,
but sometimes find must be used.
Create a default EPROM card containing all text files from the current directory:
mkepr *.txt
Create a 128-KiB EPROM card containing all text files from the current directory and all Forth sources from the forth subdirectory (which will be preserved in the card):
mkepr --size=128 --output=forth.epr *.txt forth/*.fs
Create a 512-KiB Flash card containing all files of the current directory and all subdirectories (the:
mkepr -f -s 512 -o /tmp/eprom.flash $(find -name "*" -type f)
Filenames are checked according to the rules of the OZ file
system, and the program halts if any of their segments (sections
between slashes) is invalid. No attempt is made to adapt invalid
filenames, except removing the "./" prefix when present, right
before the actual checks. This means the input files must be on
the current directory. For example, the following command will
not work: mkepr ../file.txt.