e4thcom-0.9.0  A Terminal for Embedded Forth Systems                  MM-260429

README for the Linux OS  ( OSX is NOT yet supported )

Copyright (C) 2026 manfred.mahlow@forth-ev.de

e4thcom and all related files are released with ABSOLUTELY NO WARRANTY. It is
free software under the terms of the GNU General Public License as published 
by the Free Software Foundation; either version 3 of the License, or any later
version, see http://www.gnu.org/licenses.

e4thcom is based on MINFORTH Plus 1.5, derived from MINFORTH 1.5. It is now
released with all sources, including those for MINFORTH Plus. MINFORTH Plus 
supports transient namespaces and implicit context switching based on VIS 
(VOCs ITEMs and STICKY words).

e4thcom like MINFORTH Plus consists of two files, a binary file named e4thcom
(the FORTH Primitives) and an image file named e4thcom.i (the high level FORTH
words). The binary file loads the image file at program start. 

The binary file and the image file must always have the same name and the image
file must have the .i extension.

e4thcom comes ReadyToRun for X86_64 Linux but may be created for X86_32 or
Raspbian_32. 

To create e4thcom, open a terminal in the e4thcom-x.y.z/src directory and enter
./make-e4thcom. This creates the binary and the image file and moves both to
the e4thcom-x.y.z directory. e4thcom is then ready to run.

make-e4thcom will ask some questions, that should all be answered with Yes, by
pressing the [Enter] key :

  Create MINFORTH Plus 1.5 for < your OS > ?  [Y/n]

  Create the e4thcom executable for < your OS > ?  [Y/n]

  Create the e4thcom image file for < your OS > ?  [Y/n]

  Execute e4thcom -h to show the help text ?  [Y/n]

If you see the e4thcom help text, creating e4thcom for your OS was successful 
and you can delete the src directory, if you are not interested in looking at
the sources.

If you are interested to look at the sources and at the e4thcom dictionary, 
read and use the script inside-e4thcom.

