
                        H E W L E T T  P A C K A R D 15C

                          A Simulator written in Tcl/Tk

                           (c) 1997-2006 Torsten Manz


                                   ReadMe File
                                 ===============

Requirements
============

The Simulator is written in the Tcl/Tk script language. It should run on all
operating systems supported by Tcl/Tk. It has been tested on several UNIX/Linux
flavours as well as Windows NT4/2000/XP.
It has not been tested on Windows 95/98/ME or any version of Mac OS. I would
be pleased to share your experience with the Simulator on these systems.

This distribution contains both the executables for the Windows and the Linux
platform, as well as the Tcl/Tk source file. To run one of the executables, no
further software is required. To run the Simulator source file, you will need to
install Tcl/Tk version 8.4.0 or higher. As of January 2006, the latest version
is 8.4.12. See the links page in the online help, where to download Tcl/Tk.


Installation
============

IMPORTANT NOTICE:
  If you have already installed a simulator prior to version 1.2.03 you MUST
  delete all old memory files "HP-15C.mem". See the Simulator online help where
  the file is placed on your operating system or search your hard drive(s).


1. Create a new directory, e.g. HP-15C, and extract all files. The directory
   tree must be preserved when extracting the files.
   If you have already installed a previous version of the Simulator you can
   just copy the new version over the previous one.

2. From the new directory, install the font "HP-15C_Simulator_Font.ttf".
   Follow the instructions of your operating system. You must copy the font
   file to the font directory!

3. Read the documentation "<new-directory>/doc/index.htm".

4. Start the platform specific executable (see below), or run the Simulator
   source file "HP-15C.tcl" with the Tcl/Tk wish-application.


Files and directories
=====================

  base directory
  --------------

    HP-15C.exe                  Windows executable
    HP-15C.bin                  Linux executable
    HP-15C.tcl                  Tcl/Tk source file
    HP-15C_Simulator_Font.ttf   Simulator font
    ReadMe                      This file
    ReleaseNotes                Release history of the Simulator

  icons directory
  ---------------
    HP-15C.ico                  MS-Windows icons with 16x16, 32x32 and 48x48
                                pixels in 16 and 256 colours mode
    HP-15C_16x16.png            KDE icon file, 16x16 pixel
    HP-15C_22x22.png            KDE icon file, 22x22 pixel
    HP-15C_32x32.png            KDE icon file, 32x32 pixel
    HP-15C_48x48.png            KDE icon file, 48x48 pixel

  doc directory
  -------------

    index.html                  Entry point for the Simulator online help

  progs directory
  ---------------

    Big_Factorial.15c           Factorials of Large Numbers
    Display_Control.15c         Display control demo program
    GCD_LCM.15c                 Greatest Common Divisor, Least Common Multiple
    Little_Gauss.15c            'Little Gauss' algorithm
    Little_Gauss.htm            Help file for the above program
    Moonlanding.15c             Moonlanding game
    Quadratic_Equation.15c      Solving quadratic equation (real and complex!)

'Little_Gauss.15C' and 'Little_Gauss.htm' are published under the terms of the
GNU GPL. 'Display_Control.15C' is taken from the German HP-15C user guide.
For the copyright of the other example programs see http://www.hpmuseum.org.
