


                         Win48 2.20 - Shareware



	****************
	* INSTALLATION *
	****************

Because an INSTALL program would have made this package about 4 times larger,
it has been omitted for faster download.

* You will need a ROM dump to run Win48 :

- If you have already used another emulator, you can convert that ROM with the
  Convert utility, which is NOT a MS-Dos utility but a console Win32 utility.
  This means that it will only run under Windows 95 and Windows NT IN A DOS BOX.
  This utility is available on my homepage :
	http://www.geocities.com/CapeCanaveral/5948/index.html

          ##########################################################
          #                                                        #
          # Win48 WILL NOT RUN IF YOU USE YOUR OLD-STYLE ROM DUMP. #
          #                                                        #
          ##########################################################

  Let's say your old GX dump is called ROM.48G in C:\EMU48, and that you
  have installed Win48 in C:\Win48. To convert your old dump, type at the
  prompt in a DOS box :
	CD C:\Win48
	CONVERT C:\EMU48\ROM.48G C:\Win48\ROM.48G
  A dump of a HP48SX's ROM must be called ROM.48S.
  A dump of a HP48GX's ROM must be called ROM.48G.
  One or both dumps must be in the directory in which you installed Win48.


  
- If you have never used an emulator, and don't have a ROM dump, you can
  either use the old ROMDump utility and then Convert your dump, or you can
  use my ROMDump Wizard, which will almost automatically get the ROM from your
  HP48. However, this Wizard was written without a documentation on the
  transfer protocol used by the HP48 (Kermit), and I cannot guarantee that it
  will work. It worked on my computer, maybe it will work on yours. Try it !

  WARNING: If you use ROMDump or the ROMDump Wizard, DO NOT INTERRUPT THE
           PROCESS ! Your HP48 would lock, and the only way to reset it is
           through the Reset hole.

  IMPORTANT: To save a lot of space, two DLLs needed by the Romdump Wizard
             have not been included in the Romdump Wizard's distribution.
             They are called MSVCRT40.DLL and MFC40.DLL, and are available
             on the Web at the Win48 Official Homepage :
                 http://www.geocities.com/CapeCanaveral/5948
             These two files are freely distributable, and would be included
             in this archive if they weren't so large (about 1.4Mb for both)
             Note that they are NOT needed by Win48 : only the Romdump Wizard
             requires them.

* Once you have your ROM dump(s), SAVE THEM TO A FLOPPY DISK !
  It will save you a lot of troubles if you were to lose them, and you will
  use them if you register the complete version of Win48.

* - If you have used an older version of Win48, delete C:\Windows\Win48.ini
  - Start Win48. You'll see a "Choose Your KML Script" box.
    KML Scripts in fact define the visual aspect of Win48, the behaviour of the
    buttons, of the keyboard... It is a GREAT way to customize your copy of
    Win48.
  - Check the "Win48 Directory" text area. Modify it if the directory in which
  you installed Win48 is not the directory display. Click Refrech after
  modifying it.
  - Choose a KML script in the list box. If you have put a G/GX ROM dump in
    Win48's directory, choose a script for G/GX. If you have put a S/SX ROM 
    dump in Win84's directory, choose a script for S/SX.
    Three scripts have been included in the distribution :
    * Win48's Default Faceplate for HP48G/GX
    * Win48's Default Faceplate for HP48S/SX
	These two are simple scripts, and they use the bitmap from Win48 2.05.
    * Casey's Gx with Toolbar and Touch Screen
	This script uses many advanced features, and is a good demonstration of
	the power of Win48's scripting language, KML. Try it, it is really great !
    If you want other great scripts, visit Casey's Win48 homepage :
	http://www.gulftel.com/~pattersc/win48/
    And if you are interested in writting new scripts, you'll want the KML 2.0
    documentation, available on Casey's page and on my page :
	http://www.geocities.com/CapeCanaveral/5948/kml20.htm

* Once you have selected a script, press Ok to start the emulator.
  While it is running, you can use the View/Change Kml Script to change the visual
  aspect of Win48.


	***************************************************************
	* The following applies to the DEMONSTRATION version of Win48 *
	***************************************************************

Is has been crippled in 3 ways :

* It will not load or save RAM images.
* It will not save HP48 objects.
* It will only give you 32kb of Ram, whereas the complete version currently
  allows the use of more than 4Mb !


	************************************************************
	* The following applies to the REGISTERED version of Win48 *
	************************************************************

The registered version allows to use up to 4Mb of memory.
Each file (i.e. calculator state) has 256kb of memory for the G/GX, and 160kb for
the S/SX.
You can add a SHARED (I'll explain later) ram card of up to 4Mb. By default, no such
card will be created when you start Win48. The MkShared.exe utility, included in the
registered version, will allow you to create it.
The syntax is :
	MkShared <filename> <size_in_kilobytes>
For example, you can create a 4Mb RAM card name SHARED.BIN (in Win48's directory) with
the following command :
	MkShared SHARED.BIN 4096
Valid sizes are 128, 256, 512, 1024, 2048 and 4096 kb.

When you have created this file, run Win48, and use the Close menu item to close the
calculator state. Now select View/Settings. In the "Port 2" text area, type the name
of the file you created (if you don't include a path, it will be searched for in Win48's
directory).

You can also tick the check box "Port 2 Is Shared".
When the box is cleared, only the first instance of Win48 will allow you to use the RAM
card in Port 2.
When this box is ticked, the first instance of Win48 will give you both read and write
access to this RAM card. If then you start Win48 again, the RAM card in Port 2 will be
write-protected. You can thus transfer files very easily between two calculators. This
RAM card is used by both S/SX and G/GX types.

Note that you have to close Win48 and restart it if you modify these settings.



	***************************************************
	* The following applies to BOTH versions of Win48 *
	***************************************************

Win48 will refuse to load the same calculator state in different instances because this
would be inconsistent.

Win48 includes a backup feature (in the View menu). It save the complete state of the
calculator in the computer's memory. You might want to use it before doing something
risky, and if you don't want to save to the disk. It provides some kind of Undo feature.
It is also used by Win48 when you want to save or load a new document, to restore its
old state if you cancel the operation or of something goes wrong.



	****************
	* REGISTRATION *
	****************

If you are using the shareware version of Win48, you are encouraged to register it
to get the complete version :

* If you have access to the Internet, send me an envelope containing your
  e-mail address and a check or an Money Order for the equivalent of 60
  French Francs in the currency of your country. (that's about $12 US)
  You'll be emailed your personal registration code when I receive your check.

* If you don't have access to the Internet, send me an envelope containing
  your address and a check or an Money Order for the equivalent of 80
  French Francs in the currency of your country. (that's about $16 US)
  You'll be mailed your personal registration code when I receive your check.

Your mail/email address must be easily readable, otherwise I won't be able
to send you the registered code. The best way to make sure I get it right
is to print it.

Of course, your registration code is your own and identifies your copy of Win48.
You should not give it to anyone under any circumstances.



	***********
	* SUPPORT *
	***********

Any information about Win48 will be on the Win48 Official Homepage on the Web :

	http://www.geocities.com/CapeCanaveral/5948

Other graphics and scripts are available at Casey's Win48 Graphics Page :
	http://www.gulftel.com/~pattersc/win48/



	**************
	* The Author *
	**************


        Sebastien Carlier       <sebc@anet.fr>
	10 Allee des bergeronnettes
	35340 LIFFRE
	FRANCE


Thanks for trying Win48. Feel free to distribute the shareware version to all
the HP48 owners you know. I hope you'll enjoy using it as much as I enjoyed
writing it :)
I know this file is quite a mess, I am very bad at writing help files. I hope
you'll get Win48 to run.
