The Caesar Machine Freeware Version 2.0
A hypertext reader for the Latin text of Caesar's Gallic War, Book I.
Copyright (C) 1999 by Michael Cummings
(written in Visual Basic for Windows operating systems only: 95/98/NT)

This README.TXT document covers the following topics:

Description 
Philosophy 
System Requirements 
Installation 
Outcome of Installation 
De-installing 
Running 
How to Use 
Terms 
Disclaimer

Description

This program lets the user scroll through the Latin text of Caesar's Gallic War, Book I (about
8000 wds.).  When the user comes to an unrecognized  vocabulary word, clicking on the word
with the mouse will open or refresh at the bottom of the screen a small window with the
dictionary entry for that word (in English).  Or at any time the user may want to search the
dictionary entries by clicking on "DictEntry" in the "Search" pulldown menu and then typing in
a search string.  The body of the dictionary or the body of the text may be searched with similar
procedures.

Philosophy

This software is designed for the student of Latin who knows some grammar, but who lacks
vocabulary.  Looking up all the unfamiliar words in the glossary at the back of the book is
extremely time-consuming.  The Caesar Machine permits the user to access this information
without leaving the place in the text where the information is needed.  The user can proceed
through the text many times more quickly than is possible when stopping to flip pages and
search through an alphabetical listing.  This efficiency greatly facilitates the comprehension of
the text, and with it, the acquisition of vocabulary.  Many users will find that vocabulary learned
in association with a text which is being rapidly acquired is much more likely to be retained than
vocabulary learned by drills and flashcards.

System Requirements

To use The Caesar Machine Freeware Version 2.0 your machine must be running a Windows
operating system 95, 98, or NT.  It has not been tested with any later version.  It does not appear 
to work under Windows 3.1.  It has not been tested with less than 16MB RAM.  The caesar2.zip
download file is about 1.8MB.  The unzipped caesar2 installation files total about 1.9MB.  
The installed caesar2 files total about 268KB.

Installation

If you have downloaded the program from the website, you should have downloaded a
compressed file called "caesar2.zip"into a subdirectory of your choice (e.g., 
c:\MyDownloadFiles\).  Decompress this file with WinZip (which can be initiated by clicking on
the caesar2.zip icon).  Decompress into the subdirectory of your choice (e.g., c:\temporary\). 
The decompressed files should have the following names:

caesar2.cab
setup.exe
setup.lst

Before starting the installation, shut down any other applications which are running.  Start the
installation by running the setup.exe file: either 1) by clicking on the Run procedure in the
Windows "Start" pullup menu and typing in the path and name (e.g. c:\temporary\setup.exe) and
clicking on OK -- or 2) just by clicking on the setup.exe icon.

During the installation procedure, make the decisions and click on the buttons as prompted in
each next window.  By default, the installer will create a subdirectory c:\Program Files\caesar2\ 
in which to install files unless you direct otherwise when prompted.  You may be prompted for a
decision if the installer finds on your system a system file more recently dated than the one it is
about to install.  Presumably you will instruct the installer to keep your existing more recent file.

Outcome of installation

At the successful conclusion of the installation procedure you should have in the default
c:\Program Files\caesar2\ subdirectory or other subdirectory of your choice the following files:

caesar2.exe              program file copyright (C) 1999 Michael Cummings
cm2.hlp                    help file copyright (C) 1999 Michael Cummings
dbg1glsa.asc             glossary file copyright (C) 1999 Michael Cummings
dbg1glsb.asc                                              "
dbg1dict.ae               dictionary file copyright (C) 1999 Michael Cummings
dbg1dict.fo                                                 "
dbg1dict.pr                                                 "
dbg1dict.sz                                                 "
dbg1a.txt                   text file in the public domain
dbg1b.txt                                   "
dbg1c.txt                                   "
dbg1d.txt                                   "
readme.txt                  this document
St6unst.log                 de-installing template

All these files must be kept together in the same subdirectory.  All these files must retain their
original names. (You may of course want to delete the original caesar2.zip download file, and
the unzipped caesar2 installation files: caesar2.cab, setup.exe, setup.lst.)

De-installing

With the exception of the just mentioned caesar2.cab, setup.exe, setup.lst files, do not ever
delete any of the above files by simple deletion.  To de-install the Caesar Machine Version 2.0
from your system, run the ADD/REMOVE PROGRAMS application supplied with Windows
(click on in Control Panel subdirectory).  This de-installation procedure requires the file
St6unst.log (above) to run properly.

Running

To run The Caesar Machine, use the "run" command in the "Start"  pull-up window, specifying
the full path to the program file (e.g., ' "C:\Program Files\Caesar2\caesar2.exe" ').   Or the user 
may click on the program name in the programs menu of the "Start" pull-up window.  Or the 
user may simply enter the subdirectory menu and click on the program icon.  The user may by
right-clicking on the program icon create a short-cut icon to the program file which can be moved
to the desktop or any other subdirectory.

How to use The Caesar Machine Freeware Version 2.0

     Topics:
     
     1. Clicking on Text
     2. File
         -Close
         -Exit
         - Open
     3. FontSize
     4.  Help
         -About Caesar Machine 2.0
         -Help File
     5. Search
         -Dictionary Entry
         -Dictionary Text
         -End Search
         -TEXT
     
1. Clicking on Text
     After opening a text file (cf. 2. -Open below), click on a text word in the text window.  The
dictionary entry for that word will appear in the dictionary window below the text window.  If
the entry is larger than the dictionary window, clicking on the same word again in the text
window will cause the dictionary window to scroll.  When the dictionary entry scrolls to the last
line, another click will start the dictionary entry again.  Scrolling may also be done with scroll
bars in the dictionary window.      If the internal glossary suggests more than one dictionary entry
for the form clicked on, the glossary entry will appear on the bar between the text window and
the dictionary window.  The dictionary window will show all appropriate entries.  Scrolling may
be required.  Occasionally a form does not appear in either the internal glossary or the dictionary
(e.g., a number): a message to this effect will appear on the bar between text window and the 
dictionary window.

2. File
    -Close
     Clicking on 'Close' in the 'File' pulldown menu will erase the text file from the text window. 
This must be done before opening another (cf. -Open below).

    -Exit
     Clicking on 'Exit' in the 'File' pulldown menu will cause an exit from The Caesar Machine.

    - Open
     Clicking on 'Open' in the 'File' pulldown menu will show a menu of files in the same directory
as The Caesar Machine which have the extension ' .txt'.  The four sections of De Bello Gallico,
Book I are supplied with this freeware as DBG1a.txt . . . DBG1d.txt and should have been  made
available in the same directory as the Caesar Machine.  Click on the file of your choice and click
on the OPEN button to show the contents in the text window.

3.  FontSize
     Clicking on the 'FontSize' pulldown menu will offer a choice of  three font sizes, 10, 12, and
14.  The default font size at time of  running is 14.  The choice affects the font size in the Text
Window  and the Dictionary Window only.

4.  Help
    -About Caesar Machine 2.0
     The Caesar Machine Freeware Version 2.0 is Copyright 1999 by  Michael Cummings. 
Accompanying dictionary and glossary files  are Copyright 1999 by Michael Cummings.
Centurion icon is  Copyright 1999 by Michael Cummings.  See below for terms of use and
disclaimers.

    -Help File
     The Help File is accessed by clicking on 'HelpFile' in the 'Help' pulldown menu and closed by
clicking on 'HelpFile' again.

5. Search
    -Dictionary Entry
     Unless a searchstring is already in place (cf.  'End Search' below), clicking on 'DictEntry' in
the 'Search' pulldown menu will produce a prompt box for a searchstring.  Type in a valid
searchstring and click on the OK button.  The first entry in the dictionary whose citation form
starts with that string will appear in the dictionary window.  The scroll bars let you scroll up and
down through the alphabetical section of the dictionary which contains the entry.  A valid
searchstring is one that starts with an alphabetical character.  The search is not case-sensitive for
the first character in the string, but is for all the rest.  The searchstring you typed if valid for
them will persist through other searches of a different type until you click on 'End Search'.  If
there is no instance of the searchstring, a warning box will appear.  If the searchstring you typed
is not valid for this search type, it will not become or continue as the current searchstring, and a
warning box will appear.  In either case, click on the OK button to remove the box.

    -Dictionary Text
     Unless a searchstring is already in place (cf. 'End Search' below), clicking on 'DictText' in the
'Search' pulldown menu will produce a prompt box for a searchstring.  Type in a valid
searchstring and click on the OK button.  The first line in the body of the dictionary which
contains the string, and the next two lines, will appear in the dictionary window.  The string will
be highlighted in the line.  The scroll bars let you scroll up and down through the alphabetical
section of the dictionary which contains these lines.  A prompt box will appear to suggest
continuing (OK button) or cancelling (Cancel button) the search.  A valid searchstring is one that
starts with an alphabetical character or a space.  The search is not case-sensitive for the character
which begins the string, but is for all the rest.  The searchstring you typed if valid for them will
persist through other searches of the same or different types until you click on  'End Search'. 
Even if you have cancelled the search, or move over to a search of a different type, clicking on
'DictText' again while the same searchstring is current will take you to each next occurrence. If
there is no instance of the searchstring (or in the case of subsequent searches no further
instance), a warning box will appear.  If the searchstring you typed is not valid for this search
type, it will not become or continue as the current searchstring, and a warning box will appear. 
In either case, click on the OK button to remove the box.

    -End Search
     Clicking on 'End Search' in the 'Search' pulldown menu is the only way to cancel the current
searchstring (short of moving to a search type for which the current searchstring is invalid, or
exiting the program outright).  Until 'End Search' is used to cancel the current searchstring, all
searches whether 'DictEntry' or 'DictText' or TEXT will attempt to use the current searchstring. 
When there is no current searchstring, clicking on any of the search procedures will produce a
prompt box for a new searchstring.

    -TEXT
     Unless a searchstring is already in place (cf. 'End Search' above), clicking on  'TEXT' in the 
'Search' pulldown menu will produce a prompt box for a searchstring.  Type in a searchstring and
click on the OK button.  The first occurrence in the text of that string will be centered in the text
window and highlighted.  A prompt box will appear to suggest continuing (OK button) or
cancelling (Cancel button) the search.  Any alphanumeric string is valid.  The search is not
case-sensitive for the character which begins the string, but is for all the rest.  The searchstring
you typed if valid for other kinds of search will persist through those searches until you click on
'End Search'.  Even if you have cancelled the search, or move over to a search of a different type,
or have clicked on a word in the text window, clicking on 'TEXT' again while the same
searchstring is current will take you to each next occurrence. If there is no instance of the
searchstring (or in the case of subsequent searches no further instance), a warning box will
appear.  Click on the OK button to remove the box.  Any word which appears in the text window
at any time may be clicked on to show its dictionary entry in the dictionary window without
affecting the current search string.

Terms

The Caesar Machine Freeware Version 2.0 (C) 1999 by Michael Cummings.  The user is free to
copy and distribute this program only when together with its installation files and auxiliary text
files and only in the original unmodified undecompressed form as the caesar2.zip file.  The user is
also free to modify the copyrighted text files and distribute the modified text files on condition
that all references to the author and the author's copyright be removed from the modified files.

Disclaimer

The author makes no claims as to the fitness or correctness of this software for any use
whatsoever, and it is provided "as is".  Any acquisition, retention or use of this software is at the
user's own risk.  Accordingly, the author assumes no responsibility for the acquisition, retention
or use of this software by the recipient.  In no event shall the author be liable for any special,
indirect, or consequential damages or any damages whatsoever arising out of or in connection
with the acquisition, retention, use or performance of this software.  The author disclaims all
warranties with regard to this software, including all implied warranties of merchantibility and
fitness.  Further, the author assumes no obligation to furnish any assistance of any kind
whatsoever, or to furnish any additional information or documentation.
