
				README file for EULER


INTRODUCTION
------------

The information in this file is valid only for the Atari ST (or TT)
GEM version of EULER. It consist (at least) of the files
	
	EULER.PRG
	EULER_TT.PRG
	EULER.RSC
	EULER.CFG
	E.PRG
    ENGLISH.DOC\*
	PROGS\*


DISCLAIMER
----------

EULER is a Public Domain program. If you distribute it, you must
distribute it completely and unchanged. You must include this file
unchanged. Any charges made may only cover copying and distribution
costs. You may not uncompile or disassemble the program. The author is
not responsible for the proper working of EULER, nor for any demage
the program does to the computer, files or any other demage connected
with this program.

The addres of the author is

	Dr. R. Grothmann
	Grafenwerderstr. 14
	8059 Wrth, Germany

    EMail : GROTHMANN@KU-EICHSTAETT.DBP.DE

Write to the author for suggestions concerning the program. 
You are encouraged to send your applications to me. I will make them
available to other users with the updates.


INSTALLATION
------------

Simply copy all files into a directory. You may want to create a
subdirectory for EULER programs. In this case, insert a line like
	cd("progs");
into the EULER.CFG file (if it is not already there). Also you should
determine the amount of memrory you wish to reserve, and adjust
shrink(...) accordingly in that file (see below for details). The next
thing is to name the editor you will use with
	editor="editor.prg"
This enables you to call the editor with a simple
	exec edit.
or with the menu. You may wish to set a default file with
	file="test.e"
You can then load this file with
	load file
or with the corresponding menu entry.

In the GEM-Version, you should resize both windows to your needs. Call
the menu entry "Save configuration" to make these settings the default
ones.


MEMORY MANAGEMENT
-----------------

EULER reserves all the available memory space (besides 16K) at program
start. One should use the function
   >shrink(number)
to shrink the used memory by a number of bytes. This should be done in
the EULER.CFG file and enables one to call an external editor from
within EULER. The total number of used memory bytes is obtained with
the function
   >free()
For most editors it should be enough to shrink the memory by 250000
Bytes. If you have only 1 MByte of memory, however, you should use
an editor which does not need so much memory, like the MP-editor
in the Public Domain or the Mortimer(R) tool (ATARI Version only).


DIRECTORIES
-----------

The active directory can be displayed with
   >dir();
or simply
   >dir
Searching for files matching a certain pattern can be done with
   >dir("pattern")
e.g., dir("*.") displays all files with no extension at all. dir
is a function from UTIL which uses
   >searchfile("pattern")
This function returns the file name matching the pattern. Then
   >searchfile()
returns further files matching the same pattern.


DEVELOPMENT
-----------

To start an editor from EULER, use the command
   >exec "e.prg filename"
Of course, "e.prg" must be the name of an editor in the active
directory (the one from which EULER was started). This editor should
accept command line parameters and thus load the file FILENAME. EULER
is then paused and the editor started. Do not omit the .prg ending!
EULER recognizes GEM-programs by that ending, and may otherwise start
the program as a TOS-program. After editing the file, exit the editor
and return to EULER. Then one can load the file with
   >load "filename"
If there is an error in the file, simply edit it again.

You can also use the function keys to simplify the edit/run cylce. A
way to do this is demonstrated in the EULER.CFG file. The name of the
edited file should be stored in the string variable file, the name of
the editor (incuding path) in the variable edit. Then F2 and F3 can
be used instead of the above commands.


TT-VERSION (with coprocessor support)
-------------------------------------

The file EULER_TT.PRG contains a 68020/68882 Version of the Euler 
program, and therefore should run on any TT. The program is not tested
with accelleration boards for the Atari ST.
