Path: utzoo!attcan!uunet!husc6!purdue!i.cc.purdue.edu!j.cc.purdue.edu!ain
From: ain@j.cc.purdue.edu (Patrick White)
Newsgroups: comp.binaries.amiga
Subject: hp11 (docs)
Keywords: hp11, calculator, emulator
Message-ID: <7205@j.cc.purdue.edu>
Date: 6 Jun 88 16:09:18 GMT
Organization: PUCC Land, USA
Lines: 126
Approved: ain@j.cc.purdue.edu	(Patrick White)

Submitted by:	gay@clsepf51.bitnet
Summary:	An hp11 calculator emulator.
Poster Boy:	Patrick White	(ain@j.cc.purdue.edu)
Archive Name:	binaries/amiga/volume6/hp11.d.sh.Z
tested.
 
NOTES:
   I redid the shars to extract the docs.
 
 
-- Pat White   (co-moderator comp.sources/binaries.amiga)
ARPA/UUCP: j.cc.purdue.edu!ain  BITNET: PATWHITE@PURCCVM  PHONE: (317) 743-8421
U.S.  Mail:  320 Brown St. apt. 406,    West Lafayette, IN 47906
[How do you get to heaven?   Go to Pluto and hang a left.]
 
========================================
 
#	This is a shell archive.
#	Remove everything above and including the cut line.
#	Then run the rest of the file through sh.
#----cut here-----cut here-----cut here-----cut here----#
#!/bin/sh
# shar:	Shell Archiver
#	Run the following text with /bin/sh to create:
#	hp11.doc
# This archive created: Fri Jun  3 11:31:14 1988
# By:	Patrick White (PUCC Land, USA)
echo shar: extracting hp11.doc '(4021 characters)'
cat << \SHAR_EOF > hp11.doc
                          HP11C Calculator
                          ================

This program emulates an HP11C calculator. Everything is there, including
the program mode (with the instructions displayed as usual, as numbers
..). By default, it's even as slow. It is callable from Workbench or CLI.

Usage
-----
You can pass as argument a program to be loaded (not run): from CLI, type
hp11  (you must be in the directory containing the program, cf
miscellaneous), from the Workbench click on the program's icon, press &
hold shift and double click on the hp11's icon.

Basically, the program opens a window containing an image of an HP11C (it
will only look right if you use the standard workbench colours), it looks
best on an interlaced screen but will work in non-interlaced mode (however,
the image will be rather elongated). You select keys with the mouse or the
keyboard, the following keys are supported: 0..9,.,+,-,*,/,return (for
enter), esc (for ON).

The ON key is treated specially: when you select it, the HP11C becomes an
icon that you can move around with the mouse. To turn the calculator back
on, double-click on the icon.

The following menu options are avalaible:

   Project
      New               Clear HP11 memory (equivalent to ON -)
      Open        AO    Load an HP11 program
      Save              Save program under current name
      Save As     AS    Save program under a name
      Print             Print program -- unimplemented
      Quit              End program

   Edit
      Copy        AC    Copy number in display to clipboard
      Paste       AP    Enter clipboard as a number into X

   Options
      Radix
         Point    A.    Select UK/USA format for numbers
         Comma    A,    Select European format for numbers
      Speed
         Slow           Program's execute at HP11C speed
         Fast           Program's execute faster ...
      Icons             Save an icon with a program ? Default = Off when
                        called from CLI, on from Workbench

For more details (especially concerning HP11C programming), refer to HP's
manual. (I didn't want to get sore fingers ...)


Miscellaneous
-------------
Please send all bug reports, suggestions for enhancements ... to me.

The format for Copy & Paste is not the same (alas ? if you disagree
strongly, please send me a note): Copy essentially places an image of what
is on the display in the clipboard, thus 200*10^23 becomes 200.0000   23.
Paste reads a number in the format +/-x.xE+/-x.

To run the program, the file HP11.PIC must be in the current directory.
Thus from CLI, you must be in the correct directory (this is obviously not
a problem from workbench). To copy the program, you must remember to copy
both files (and preferably this (rather terse) documentation). The reason
for this is to reduce memory consumption, most of the time the image is on
screen (and not in the code).

Source code for this program will be forthcoming (when I've uploaded it,
it's rather long, 150K). It compiles under Lattice C V4.0. I have tried to
design the program so that it is easily ported (all the Amiga specific
routines are separate, and there are fairly few routines which need to be
written: read a key, write to the display ... You are left free to decide
how the program is presented to the user. You could use a simple text
window if you wanted too).

This program is placed in the public domain, but I would prefer if it was
not used for commercial purposes.


/-----------------------------------------------------------------------\
| David Gay                       |        GAY @ CLSEPF51.bitnet        |
| 19 chemin de la Source          |                                     |
| 1296 Coppet                     |    I disclaim all responsability    |
| Vaud                            |        for the absence of a         |
| Switezerland                    |             disclaimer              |
\-----------------------------------------------------------------------/


SHAR_EOF
if test 4021 -ne "`wc -c hp11.doc`"
then
echo shar: error transmitting hp11.doc '(should have been 4021 characters)'
fi
#	End of shell archive
exit 0