               HYPERHELPER 3.04 TRIAL KIT README
                       March 1, 1992
              
INTRODUCTION

Enclosed is your HyperHelper Trial Kit. You should have
the following files:

  HCS.EXE     Shareware version of the HyperHelper Compiler
  HH.EXE      The HyperHelper Browser
  HHCFG.EXE   The HyperHelper Configuration Utility
  HP.EXE      The HyperHelper Print Utility
  MAN.HTX     On-line HyperHelper Manual
  ORDER       Order Form
  README      This readme
  SAMPLE.TXT  Sample HyperHelper source file

The browser HH has been pre-configured to load the manual
MAN.HTX. All you need to do to browse the manual is type:

  HH

from the command-line. To see the browser command-line
options, use:

  HH /h

To print out the manual to your printer, use

  HP MAN >prn


*********************************************
*** IMPORTANT: PLEASE READ THE FOLLOWING! ***
*********************************************

IF THE BROWSER LOCKS UP ON YOU, read below for
some possible reasons:

I. Your computer is non-standard in some way in the upper
   memory area (between 640K-1MB), and causes HyperHelper's
   automatic scan of this area to lock up. 

   Solution: Try using the -xh option, which will prevent HyperHelper
   from scanning the upper memory area. If you use this option,
   then you may NOT load HyperHelper into the upper memory area
   using the DOS loadhigh command.

II. If you are using QEMM 6.0 or NetWare, and use the -lim option,
    the browser may lock up. Try using the new -limc option,
    (which moves code but not data, see V3.03a notes), which has
    been known to clear up problems with QEMM and NetWare.

III. Your mouse driver is old, or is not a true Microsoft 
     compatible driver. 

    Solution: Try using the -mo- option which disables the use of 
    the mouse in the browser. (Notice the dash before AND after "mo".)
    If this clears up the problem, then either use this option all the
    time, or try to update to the latest mouse driver you can.

MOUSE DRIVERS:

If you have a Logitech mouse with an old driver (pre-V5.0),
the mouse action will not work properly in HyperHelper.
Update to V5.0 or higher of the driver to correct the problem.

Also, the browser will lock up if you are using a TrueMouse
driver, (purportedly supplied by NorthGate.) Even though this
driver is supposed to be 100% Microsoft compatible, it
apparently isn't! The same symptoms occur with some Mouse System
mouse drivers.

Try to use the latest mouse driver you can, and if at all
possible, use a true Microsoft mouse driver.

  
UPDATE HISTORY: CHANGES TO HH SINCE THE MANUAL WAS PRINTED
===========================================================

V3.04:

   Fixed card export to file function. Fixed the critical
   error handler. Fixed some bugs in hhcfg.exe. Fixed the 
   TSR browser so that it properly resets to "-r" popup
   mode at the end of each popup.

V3.03d:
  
   Fixed the Home/End key action on card pick lists.

V3.03c:

   Fixed a problem with UNDO working incorrectly when a
   file link has been executed, and the current directory
   has changed.

V3.03b:

   Fixed a problem which prevented the context-sensitive
   screen scan to work properly with topics that contain
   extended ASCII characters, such as  and .

V3.03a:

   Added a -limc option to the browsers. This tells HH to
   load in lim (expanded memory) as with the -lim option,
   but to only store code there, not data. (The data stays
   down in lower memory.) The -limc option clears up problems
   when using HH with QEMM 6.0 and/or NetWare, and/or OS/2.

V3.03:

  DESIGN CHANGE: Changed the topic matching algorithm for 
  context-sensitive popups so that the *largest* topic 
  possible is returned, rather than the smallest. For 
  instance, given the two topics "test" and "test result", 
  in the following scenario,"test result" is returned for 
  V3.03, whereas in prior versions, "test" was returned:

  "The test results were turned in on Monday".
          ^cursor here

V3.02a:

  Fixed problems with $FILE and $EXEC link.

V3.02:

  Fixed some problems with the newly added -xh option.

  Fixed a bug that prevented a $FILE link that is preceded
  by a normal card link on the same line from working. The
  same problem occurred and has been fixed for $EXEC links
  as well.

  The TSR code has been made more robust.

V3.01a:

  Fixed #default card link last command to work properly inside 
  cards.

  Fixed a problem where you couldn't use a '!' character in
  a card caption, even if the link marker was changed to some 
  other character.

  Also, added the -xh browser option to alleviate the browser
  locking up immediately on some machines. (See below.)

V3.01:

  Using a hotkey and using a software interrupt to popup the
  browser are now mutually exclusive. When using the -i browser
  option, the hotkey is automatically disabled. Allowing both
  to work at the same time caused incorrect operation.

  Fixed a bug in hhcfg.exe that sometimes prevented you from 
  setting colors via the #attributes command.

V3.0e:
  
  Fixes bug in V3.0d that crept in: print function always said
  "printer not ready".

V3.0d:

  Fixes HH sometimes locking up in screen modes larger than 80x25,
  and fixes HH sometimes locking up when zooming using the mouse.


V3.0c:

  This version fixes further the Tandy computer problem. Specifically,
  hhcfg should now work properly on Tandy's. Also, a bug in the printer
  routine was fixed.

  ONE DESIGN CHANGE: Upon exiting the browser, HyperHelper returns an
  exit code equal to the number of the card at the time of exiting.
  Earlier versions returned a 0. As with earlier versions, you can
  still force an exit code of your own choosing via the $QUIT link.

V3.0b: 

  This version fixes some miscellaneous bugs in the first release. 
  These fixes have to do with getting HH to work properly on Tandy 
  computers, and getting the compiler to gracefully handle missing
  link markers in certain situations and a problem of having menus
  too long.

  Also, the new browsers will now work properly in TSR mode
  in conjunction with MSDOS 5.0 EDIT, and QBASIC.

V3.0: 

  Initial Version 3 release


TO ORDER
===================================================

Print out the file called "order" and fill in blanks. Send your 
order to:

  Azarona Software, P.O. Box 768, Conifer, CO  80433

If you have questions, call (303) 697-1088 (daytime)
