		      Loki Text Editor Overview
Version 2.4	  Copyright 1994 by Craig A. Finseth	1994-06-06

	This program is dedicated to my wife, Ann, daughter Kari,
	and son Kyle.

Sections:

	What It Is
	Credits
	Status
	Cost
	Version History
	How To Obtain a Copy
	How To Obtain Support
	Supported Environments
	Installation
	File Needs From Freyja
	File-by-File

-----------------------------------------------------------------
What It Is

Lokie is a basic, four-function RPN calculator built upon Freyja
technology.

The calculator has been enhanced to...

- Take advantage of the larger screen available on the HP95/100LX.
The entire stack is shown at once, as are some of the modes.  Input is
on a separate line.

- Supports binary math including:

	* binary, octal, decimal, and hexadecimal input modes
	* all the above and zero-padded output modes
	* simultaneous display of multiple output modes
	* unsigned, 1's, and 2's complement display
	* word size from 1 to 32 bits
	* and, or, not, xor, and shift operations

- Supports fraction math including:

	* input of arbitrary fractions using a.b.c format
	* multiple display modes including:

		-- fixed denominator
		-- factors of denominators
		-- most precise

	* denominators from 2 to 10,000

- Supports basic unit operations and math, including:

	* no units
	* binary numbers
	* distance units (m, ft, in, ft-in)
	* area units (m^2, ft^2, in^2)
	* volume units (l, m^3, ft^3, in^3)
	* mass units (kg, lb, oz)
	* angle units (deg, rad, grad, R.A.)
	* time
	* date
	* temperature units (deg C, deg F)

- Multiple unit forms may be displayed at once.

- Function key and menu access to all commands.


-----------------------------------------------------------------
Credits:

While most of the work is original to myself, I would like to cite the
following articles:

Hodges, David.  "Decimal to Fractions" DATAFILE V4 N1/2 P43, Spring
1985.

Hodges, David.  "Decimal to Fraction Conversion" DATAFILE V8 N8 P13,
December 1990.

de Vries, Frans P.  "Decimal to Fraction in MCODE" DATAFILE V9 N7 P8,
Oct/Nov 1991.

-----------------------------------------------------------------
Status:

The entire release is freeware distributed under the same terms as GNU
CopyLeft.


-----------------------------------------------------------------
Cost:

Loki is provided free to anyone (see the later "How to Obtain a Copy"
section).  However, I would _deeply_ appreciate hearing (at all) from
you: please send a postcard and, if you like, suggest new features!  I
would also like to know how you learned about the program and how you
obtained a copy....


-----------------------------------------------------------------
Version History:

Loki:

2.4	 1994-06-06	first release[*]


[*] Yes, I know this program just came out.  No, I'm not trying to
slip a fast one by anyone. This version number is one past the latest
Freyja release.  The program shares much technology with Freyja, and
use of the same version number scheme makes life more simple for
everyone.  For example, the thorres.exe file included with this
release is 2.4: it will compile Freyja resource files just fine, but
the 2.3 one won't do Loki resource files (I upped the number of
tables).


-----------------------------------------------------------------
How To Obtain a Copy:

Diskette: Send the author blank diskettes:

	- one, 3 1/2" (1.44 MB), or
	- one, 3 1/2" (720 KB), or

and a SASE or enough stamps to cover return postage plus a dollar or
so (so that I can buy a diskette mailer).  Or you can just send me
about US$5.00 in check, stamp, whatever and I will furnish the
diskette(s) and mailer.  Non-US people can send me four 1.44 MB 3 1/2"
diskettes in lieu of money.  (More money is always nice, but please
don't feel obligated in any way.)

Anonymous FTP:
	mail.unet.umn.edu in
		import/fin/loki24.exe	(MS/DOS self-extracting archive)
		import/fin/loki24.tar	(UNIX tar file)
		import/fin/loki24.tar.gz (gzip'ed UNIX tar file)

	eddie.mit.edu
		distrib/hp95lx/editors/loki24.exe
		distrib/hp95lx/editors/loki24.tar
		distrib/hp95lx/editors/loki24.tar.gz

I would _deeply_ appreciate hearing (at all) from you: please send a
postcard and, if you like, suggest new features!

If you just want to run Loki on an IBM PC or HP95/100LX computer, the
loki release is all you need.  If you want to change the programs or
run on Unix, you will also need a Freyja2.3 release.


-----------------------------------------------------------------
How To Obtain Support:

	Craig Finseth
	1343 Lafond
	St Paul MN 55104
	USA

	+1 612 644 4027
	+1 612 626 1002 fax (please try to not use this)

	fin@unet.umn.edu
	Craig.Finseth@mr.net


-----------------------------------------------------------------
Supported Environments:

	Tested on SunOs 4.0.3.
	Should run under most Berkeley Unix environments.

	Tested on MS/DOS V3.x and should run on any MS/DOS version 2.0
	or later system.  Requires Borland Turbo C Version 2.0 or
	later to compile (it should compile and run under Microsoft C
	with only minor changes).

	Tested on HP95LX and HP100LX.


-----------------------------------------------------------------
Installation:

see:
	inibmpc.doc	installation for IBM PCs and compatibles
	indos95.doc	installation for MS/DOS version on HP95LX
	insys95.doc	installation for system manager version on HP95LX
	indos100.doc	installation for MS/DOS version on HP100LX
	insys100.doc	installation for system manager version on HP100LX
	inunix.doc	installation for Unix systems


-----------------------------------------------------------------
File-Needs-From-Freyja:

If you are interested in making changes to the program or running it
on Unix, you need to start with a Freyja release.  Get one and unpack
it.  Then, get the Loki release and unpack it into a different
directory.  Copy the following files from the Freyja release:

	anatomy.txt
	ascii.txt
	c0s.asm
	lib.c
	lib.doc
	libparse.c
	libparse.doc
	libreade.c
	libres.c
	makeexm.doc
	sysmgr.h
	thorres.c
	turboc.cfg
	xprintf.doc

The following three files are included with the Loki release.  They
_replace_ files from the Freyja 2.3 release.

	lib.h		change version number, copyright, and RESTABLES
	libasm.asm	new routines
	makeexm.c	bug fix
	makeexm.exe
	resource.doc	no change (needed by Loki users)
	thorres.doc	no change (needed by Loki users)
	thorres.exe	newly-compiled version
	xprintf.c	bug fixes (may make a new Freyja too big)

Don't copy these files either, but you may want to look at them to
compile a new thorres or makeexm:

	makefile.msd
	makefile.unx


-----------------------------------------------------------------
File-by-File:

see:
	filelist.doc

