Little Man Computer
By Midnight Blue International
http://linktr.ee/intylab
Date of last modification: February 18, 2022
__________

These are instructions for launching Little Man Computer in jzIntv.  Note this file is formatted for 120 characters.

The archive this readme was bundled with should include the following files:
* readme.txt - What you are reading now
* lmc.bin - Binary image
* lmc.cfg - Memory map and metadata
* lmc.jpg - Overlay image
* Little Man Computer Instruction Manual.pdf - Instruction manual
* Little Man Computer Keyboard Control Layout.pdf - Key bindings when launching from PIDEjL
* Little Man Computer Beginner Exercises.pdf - Beginner Exercises
* Little Man Computer Intermediate Exercises.pdf - Intermediate Exercises
* hackfile.cfg - Keyboard hack file from PIDEjL
* intycolors.cfg - Alternate color scheme from PIDEjL

First, you should have a recent version of jzIntv.  You can get it from: http://spatula-city.org/~im14u2c/intv/

Along with that, you should have a copy of the file exec.bin, which is available on the CD Intellivision Lives! for PC,
but the file wbexec.bin is preferred to make jzIntv fully emulate TutorVision.

It is preferred that you have a copy of the file gromintv.bin, which is the alternate "system font" for TutorVision.  If
not, the standard grom.bin file will work fine.  This program auto-detects at startup which file you are using, so it
draws Down and Right Arrows to match the Up and Left Arrows present in the Graphics ROM.

Because TutorVision is incompatible with ECS, you do not need the ecs.bin file.  The memory map avoids the address range
where "REX" is present, so it should work on an actual TutorVision or a "Tutor Pro" with an LTO Flash cartridge.  (This
program uses JLP for additional memory and saving to Flash, so other cartridges like the Cuttle Cart 3 will not work.)

To run this program, launch jzIntv with the following parameters:
* "-G2" (note that's a capital 'G'; required to enable extra Graphics RAM)
* "--jlp-savegame=lmc.sav" (required to enable JLP Flash and expanded memory)
* "-g gromintv.bin" (if you have the gromintv.bin file; otherwise leave it out)
* "-e wbexec.bin" (if you have the wbexec.bin file; otherwise leave it out)
* "-s0" (this shouldn't be necessary, but it overtly disables ECS for compatibility reasons)
* "--gfx-palette=intycolors.cfg" (not necessary, but provides an alternate color scheme)
* "--kbdhackfile=hackfile.cfg" (not necessary, but enables the bundled keyboard hack file)

I recommend you use PIDEjL, available from my website: http://www.midnightblueinternational.com/pide.php
There are two versions available, one for Windows, and one for my Portable Intellivision Development Environment (PIDE).
The instructions for building a PIDE of your own are available for download on that page as well, if you're interested.

PIDEjL is designed to give you a graphical front-end from which you are presented with a list of games and some controls
to tweak a few settings (only certain ones which I thought were appropriate, not all of them).  You can merely select a
game and click the "Play" button, and PIDEjL creates a script to launch jzIntv with all the parameters set for you.
It's easier than having to remember the above parameters.

To add Little Man Computer to your Games List in PIDEjL, open the config.py file and find the line beginning with
"GameList".  The list is sorted in the order each game appears here, not necessary alphabetically.  Create a new line
with the following text:
"   ('Little Man Computer', 'lmc.bin', 0, 0, 2, '-e wbexec.bin -g gromintv.bin --jlp-savegame=' + rompath + 'lmc.sav'),"
Note the tab at the beginning is necessary so it's aligned the same way as the other lines.
* The first '0' adds the switch "-s0" and clears the "ECS" checkbox by default.
* The second '0' adds the switch "-v0", disabling IntelliVoice by default.
* The '2' adds the switch "-G2" which is required for this program.
* Finally, there's room for any custom parameters, which is where we add JLP Flash and the alternate GROM/EXEC files.

If you launch this program through PIDEjL within PIDE, the overlay image should automatically appear along with the
emulation window, if you had placed the .jpg file in the folder specified by "overlaypath".  Otherwise, open the .jpg
manually and keep it handy for your reference.

From here, open the Instruction Manual .pdf file and follow along.  Enjoy using Little Man Computer.
__________

Revision History

February 2022:
* Fixed a bug concerning that caused the cursor to appear further than the last line in the Input Tape.
* Changed the border and divider color in the Tape Viewer screen from "light blue" to cyan.
* Fixed a bug that caused newly-inserted lines in the Code Editor to appear as "DAT lines" in error.
* Added third Addendum file for Intermediate Exercises.

August 2021:
* Fixed a bug concerning the behavior of the right Clear key when the cursor is in the Reference field in an existing
  code line in the Code Editor.  It now deletes the code line, same as when the cursor is in the Instruction field.
* Bugfixes in the Reset Menu:
  * Fixed a bug that left the Overflow flag raised after clearing the Accumulator.
	* Fixed a cosmetic bug that failed to display the mailbox values before clearing them.
  * Fixed a bug that also reset the Mailboxes and Output Stream when clearing "State".
* Fixed a cosmetic bug that occasionally manifested when displaying an updated mailbox value in an odd-numbered column.
* Added first two Addendum files (more will be released with future updates).

July 2021:
* Additional Tutorvision autodetection at startup.
* Minor cosmetic bugfix: Output tape contents did not appear when clearing only the Output tape from the Reset Menu.
* Project name is also cleared when clearing Everything from the Reset Menu.
* Added metadata to reflect incompatibility with ECS.
* Changes to the documentation to reflect the above changes.
__________

EOF
