Gamemenu - by S.R.Usher, 2018.
------------------------------

This program is designed to be up into C:\AUTO on an Atari machine to give a
list of games held on the hard drive allowing easy selection and running.

In addition to the gamemenu.prg program the system needs two other files,
gamemenu.ini, which has to be in C:\, containing the basc setttings and
games.csv held in the game directory (folder), below which the gaes are held
iin sub-directories.

gamemenu.ini
------------

This file holds the basic information the program needs to run, primarily the
location of the games on the disk.

The file format is simple but you need to make sure that you keep to the
rules. On the options lines the options have to be all upper case and you can't
use any spaces. Also you can't have blank lines. Lines beginning with the '#'
character are comment lines.

The primary option, which is required, is GAMEDIR which gives the location of
the game directory using the MiNT format, e.g.:

GAMEDIR=/dev/g/games

The '/dev/g/games' is equivalent to the TOS path 'G:\GAMES'

The further two options are optional, they are VOLUME, which sets the audio
output volume on the STe and TT computers, and SPEAKER, which turns the
speaker on the TT off.

The VOLUME option takes a numeric value from 0 to 40, which is the same as you
see in the Control Panel. e.g.:

VOLUME=35

The SPEAKER option takes the values 'ON' and 'OFF', which are self
explanitory. e.g.:

SPEAKER=OFF

games.csv
---------

Within the GAMEDIR you must have a simplified CSV (Comma Delimited Values)
file containing three fields:

Human readable game name
Sub-directory (folder) holding the game files
Name of the executable to run

All three fields must exist and you can't have any blank lines. e.g.:

Archipelago,archipel,start.tos
Arkanoid,arkanoid,runme.tos
Battle Zone,battlez,runme.tos
Bloodwich,bloodwyc,runme.tos
Bubble Bobble,bubblebo,runme.tos
Frontier: Elite II (Copy protection),frontier,frontier.prg

Compiling
---------

The code was written under MiNT using GCC 2.5.8p1 and mintlibs pl.46 with Eric
Smith's "curses" library.

You need GNU make and a basic UNIX-like environment.

At this point you should just be able to type 'make' and it will build.

It should be noted that the menu system is modular and could be replaced with
something prettier. An array holding the descriptions from the CSV file along
with the number of entries are passed in and it returns the element in the
arrays corresponding to the game chosen.
