                      Copyright 1996, Hyperion Softword

                    *************************************
                    *  Orpheus 2, beta release 2.00.30  *
                    *************************************

                Comments and queries to:  Hyperion Softword,
                535 Duvernay, Sherbrooke, QC J1L 1Y8, Canada
                    tel/fax - 819-566-6296 (Rod Willmot)
                       email - willmot@interlinx.qc.ca


This file lists changes, fixes, and new features in successive versions
of Orpheus 2.  As in archeology, the most recent stuff is at the top.

Version 2.00.30:
================
 - The Search Menu in OH.EXE has finally been completed, with Search,
   Search/Replace, Set Bookmark, Get Bookmark, and Go to Line.
   When Search is invoked and the found text is hilited, you can continue
   the search or cancel:  <Grey+> searches down, <Grey-> searches up, all
   other keys cancel.  When Replace is invoked and the found text is hilited,
   you can perform the replacement, skip it and continue, or cancel:  <Enter>
   performs the replacement, <Spacebar> skips, and all other keys cancel.

 - Added Define Keyboard to the Setup Orpheus dialog -- we now have fully
   definable keyboard in OH.EXE!  This is a huge improvement (I used it
   already while writing up this feature in Help), and one that allows some
   simplification of the default menus.  To wit:  I've removed certain
   default keypresses that duplicated others, such as Ctl-M for marking
   and Ctl-Q for unmarking.  You'll notice that the menus now display
   keyboard accelerators in hilite, and that any changes you make in the
   Define Keyboard dialog are reflected on the menus.  A further change
   following from this feature is that I've removed the "Accent Key" as
   a built-in keypress; instead, the Edit Menu now has a command to
   "Make accented letter", which does the same thing; the default keypress
   for it is <F12>, but of course you can define it to be anything you
   like (including the old "accent key").

 - Added Unlink to OH.EXE's Link Menu, especially convenient when you want to
   delete the card at the other end.

 - Enabled Undelete on OH.EXE's Block Menu.  The dimmed "Frame Block" command
   has been removed, since Draw Mode is so easy to use.

 - Improved functionality of the Menu system in both OH.EXE and the Reader
   for those times when you open it with <Esc> or by clicking on Esc:Menu.
   At first only the top line appears, letting you select a specific menu
   by typing its hilited letter or by clicking on the menu title.

 - Fixes in OH.EXE:
   - Corrected all known errors in reformat operations.
   - Corrected all known errors in block operations.
   - Corrected an error in cursor-to-next-word (Ctrl-F).

 - Fixes in the Reader:
   - In Text cards with multiple link anchors on the same line, in some
     circumstances the Reader made an error in link storage.  Fixed this
     also in Help and the Simulator.
   - Long Graphic cards are now correctly loaded.
   - The mouse is now reset after any call to run() or runbat().
   - If menus are not disabled, the Reader checks for the presence of an IDX
     (index) file for the document currently loaded, and if not found, greys
     out the Search commands on the Read menu.
   - Unavailable options in dialogs are now correctly ignored.
   - Several improvements to the Reader's Search dialog.
   - Improved response to jump(back) in a Graphic card.  This lets you
     create a temporary effect in a graphic by linking a hotspot to a Graphic
     card ending with a jump(back) command, generally after a waitfor()
     command if the effect is not self-timing.  Formerly jump(back) did not
     work at all in Graphic cards.
   - Giving a print command when the current card has a Report link (which
     is what the author wanted printed) now works as it should.

Version 2.00.29:
================
 - New feature:  Executable HTX turns your finished work into a self-reading
   program, simplifying distibution.  (Licensed use is limited to Orpheus
   Professional users, but everyone is welcome to evaluate it.)

 - Moved Restrict Access out of the Project Options dialog and into the
   new Professional Options dialog.  Here's how to get there:  select "Build
   Project" from the Project Menu, then tab to the Options box and select
   "Pro Options".  This dialog also gives access to Updateable HTX and
   Executable HTX.

 - Add another info screen to the Reader's internal Help system, and made
   it possible for the user to page back and forth through all the screens.

 - Fixes in the Reader:
   - After Event performance the Reader should now update the selection bar
     in all circumstances.
   - For authors testing their work, if your project's PRJ file is in the same
     directory as the HTX the Reader now loads your Resource Path setting
     so you can leave graphics and other resources where most convenient.
   - The Notepad didn't save files correctly, nor did it respond to <Del>
     when used at the beginning of an empty line (to delete the line).  The
     info screen for the Notepad wrongly gave <Alt-Z> as the accelerator to
     Minimize the Notepad; it was changed to <Alt-M> some time ago.

Version 2.00.28:
================
 - Online Help now includes full-text search.  The index (held in OH.IDX)
   would be over 200K if all words were indexed, so I've used the Indexer's
   exclusion-list feature to eliminate words you're unlikely to search for.
   With this release the index is about 80K (still bigger than it has to be).

 - Changes and additions to the Project Options dialog:  (1) You can specify
   your own Help card and tell the Reader to use it exclusively instead of the
   little info-screens available in dialogs.  (2) You can specify your own
   filename to use as the default for print-to-file in the Reader's Print
   dialog.  (3) Some obsolete options have been removed.  For full
   documentation see online Help.

 - The Restrict Access dialog has been changed and re-enabled, but now has
   the restriction that you can only use it if you have purchased a customized
   version of the Reader.  For full documentation see online Help.

 - Made the lookfor() command more robust: if you have an updateable htx
   installed in dual locations (e.g. CD-ROM and hard disk), the Reader checks
   the current directory first, then the other location.

 - Added XMS capability to the Indexer, and a switch to set the maximum
   number of hits to record.  Also, fixed the Indexer's handling of inclusion-
   list entries.

 - Fixes in OH.EXE:
   - Memory corruption could occur when assembling a large project.
   - If Help or the Simulator was missing, the error message was wrong.

 - Fixes in the Reader:
   - If a project with more than 16 directories was assembled into more than
     one file, the Reader would eventually look for data in the wrong file.
   - On loading an HTX the Reader would go for the Homecard even if Hide
     Homecard was turned on. Now if that is the case it goes for the Designated
     Home card.
   - If an index included a character conversion list (meaning the IDX was
     created with the /s switch to strip accents), trying to open the Search
     dialog would at best do nothing and at worst hang the computer.
   - Corrected the Search dialog's response to entering characters not used
     in the index, such as numbers if there are no number-words.

 - Added a basic info-screen to the Reader for navigating text cards.  All
   aspects of the Reader now have built-in help, which you can use or not
   depending on your project options and command buttons.

 - Help's Print dialog didn't acknowledge that OH.CFG had been read.

Version 2.00.27:
================
 - For Orpheus Professional users -- we now have full-text search.  (Other
   users, both shareware and those with the standard licence, are welcome
   to evaluate this feature but may not include it with distributed works.)
   The index data for full-text search is generated with the new utility
   OHINDEX.EXE, which is documented in OHINDEX.TXT.  The resulting IDX files
   are detected by the Reader and accessed through its new Search dialog,
   which has been added to the built-in Read menu.  Search can also be called
   by using the new "search" keyword (replacing "index") either as a command
   button or in a menu() command.  Two additional keywords, "snext" (search
   next) and "sprev" (search previous), make it possible to duplicate the
   built-in keystrokes for these functions, e.g. with command buttons.
   For full documentation see online Help on the Indexer and Reader (from
   "Orpheus Programs" in Help Contents) as well as Help on making command
   buttons.

 - Fixes in OH.EXE:
   - The dialog to get a new link number didn't update the display correctly
     if you entered a number manually.
   - The Browse Topics dialog now reports errors immediately instead of after
     the dialog.
   - If an old copy of ERROR.LOG or HOTSPOT.LOG is already in a window, and a
     new LOG is generated, the dialog functions to load those files now
     replace the old copy with the new one.
   - If you use the directory picklist with Open Project or New Project, the
     file list now shows only PRJ files.
   - If the Verifier finds a link to an uncompiled card, the error message no
     longer contains two copies of the crosslink.
   - In the Define Card dialog, if you tabbed out of the topic field after
     editing the card topic, the new topic would of course be saved in the
     card file but the TOP file (topic database) wouldn't be updated.
   - Corrected several errors that could occur when the same card was loaded
     in two or more windows.

 - In the Reader and Simulator, performing an Action link would disable
   subsequent attempts to retrace your steps.  Fixed.

 - Added the Search code to Help and prepared an index for it, OH.IDX.  As
   of 96-01-29 the Help discussion of the Restrict Access dialog is out of
   date.

Version 2.00.26:
================
 - In the Reader's Notepad, pressing Esc while entering a topic for a new
   note left the dialog onscreen.

 - If you ran the Simulator from the DOS prompt it wouldn't load a project
   with an 8-character name.

 - The Converter (OH1TO2.EXE) made an error with directory numbers after
   translating the first 256 cards.  Fixed.

Version 2.00.25:
================
 - Added Field verification to the compiler, and corrected errors in the
   compiler and verifier that affected cards with many hundreds of links
   (code that hadn't been tested).

 - In the Reader, added Help for the Notepad, Print, and Color dialogs.

 - Improved mouse and cursor behavior when text is marked in the Reader,
   plus ability to reach the Print dialog through various means.  If printing
   is completely disabled (as a project option) text can't be marked.

 - Corrected errors in the Reader's Notepad.

Version 2.00.24:
================
 - In the Reader, added a built-in menu system, with access to printing,
   quitting, the Notepad (also added with this version), and the Color dialog.
   The Notepad can be accessed either through the menus or through a command
   button or popup menu.

 - Simplified behavior of the PgUp key in the Reader, the Simulator, and
   Help:  now it serves only to perform page-up in scrollable text cards,
   and does NOT jump to the Origin link (not even in non-scrollable cards).

 - In OH.EXE, if the Verify stage of building encountered a problem the
   report in ERROR.LOG didn't include a mention of the card where the error
   was found.  Now it does.

 - Fixed a bug in OH.EXE's editor code affecting wordwrap; it was most
   noticeable with a temporary left margin.

 - For those rare occasions when the Simulator needs to clear the screen
   to your original DOS colors, it will now do it right.  Also, I discovered
   that the Simulator's Exit and Print hotkeys had been unintentionally
   disabled.  Print of course does nothing in the Simulator, but now Alt-X
   exits unless you've disabled it yourself as a project option.

 - Enabled Help in the Edit Buttonbar dialog.

Version 2.00.23:
================
 - Made it easier to do revisions when you find something you want to change
   while in the Simulator:  if you exit with <Alt-F4>, Orpheus loads that
   card in the current window.  If you do so while on a different line in
   the same card, it goes to that line.

 - Fixed a bug in the code for handling marked blocks in OH.EXE.

 - Fixed an error in the new Reader code for handling large projects.

 - Fixed a long-standing bug in low-level text-handling code in OH.EXE.

 - In OH.EXE, if you cancelled the Hotspot dialog it remained onscreen
   even though you were no longer in the dialog.  Also, if you were on
   the first line the hotspot data would be added below that line instead
   of being inserted above it; changed this to be consistent.

Version 2.00.22:
================
 - Added the ability to select text for printing in the Reader (only).
   Output can go either to the printer or to a disk file.  See OHREAD.TXT
   or online Help:  Orpheus Utilities->OHREAD.EXE->Documentation.

 - If you ran "Compile, Simulate" in a long card, on return from the Simulator
   you would see the wrong part of the card you were in.  I'd forgotten to
   remind the build procedure to recover from memory swapping.  Remembered.

 - In the Reader and Simulator, after displaying a graphic from an Init or
   Exit link the layout of a Text card was not refreshed.  Fixed.

 - When you jump to a label within the same card, and then retrace your steps,
   now you go back to where you were in that card rather than to the previous
   card.  (This refers to the Reader, Help, and the Simulator; currently the
   retrace routine in OH.EXE just goes to the top of the previous card.)

 - Numbered output files now use padded numbers in the file extension, i.e.
   ".001" instead of ".1".  The Reader will look for the old style if it
   can't find the new.

 - In the Setup Orpheus dialog, one sequence of actions could cause screen
   garbage on return to the main dialog.  You could also lose the cursor
   afterwards.  Both fixed.

 - Non-English versions of the Reader now use the correct "More" flag.

 - Dropped the "text being marked" color from the Reader, since we'll use
   only one color (marked text) when text is selected.

 - In OH.EXE's Help Menu, the Registration field now accepts your number.

 - The flic() command was supposed to accept coordinates; now it does.

 - Added optional recognition of comment lines in Text cards.  If you
   select this option in the Setup Orpheus dialog, lines beginning with ";"
   are ignored by the compiler.  Note that in scripts (Graphic and Event
   cards), lines beginning with "/" are comments -- and I've re-enabled
   recognition of ";" for script comments too.

Version 2.00.21:
================
 - Finally found out why the Screen Layout dialog was disabled for everyone
   but me.  Actually it was Restrict Access that was supposed to be disabled,
   but it wasn't for me because I have the Ultimate Registration Level.

 - In assembled output, if the complete work didn't fit into the HTX file,
   numbered subfiles were named incorrectly.

 - In documentation on the Converter, added a section on Concatenating "More"
   links.  There's a gotcha concerning Origin links that you have to look
   after, described clearly in the added docs.  You can find this either in
   OH1TO2.DOC or in online Help, under Orpheus Utilities->The Converter->
   Documentation->Concatenating More Links.

 - Changes in the Build Project dialog, "Options" group:  we no longer talk
   about including Reader HLP in the finished product, because help screens
   will be incorporated into the Reader code.  The Largest File setting should
   have maxed out at 1024K, which was the real maximum until this version.
   The new maximum for a single assembled file is 4194000 bytes, nominally
   4 megabytes; therefore the highest number you can enter for Largest File
   is 4194K.

 - Added the capability to create an Updateable HTX (see the Options group
   in the Build Project dialog).  A typical application for this feature
   would be a CD-ROM for which you wish to provide monthly updates on
   diskette, but you can use it in any context where you wish to distribute
   updates containing only those parts that have changed or been added since
   the first release.  In the case of a CD-ROM application, the update
   files are installed on the user's hard disk, and the Reader automatically
   reads the correct data from either the update or the CD-ROM.  PLEASE NOTE
   that Updateable HTX is part of the Orpheus Professional feature set.
   You are welcome to evaluate it whether you are registered or not, but
   it is not included in the standard registration.

 - Internal changes provide greater capacity for users dealing with massive
   amounts of text.  Maximum size of a single card (at compile time) is now
   approximately 1 megabyte, up from 200K in the original design for OH2
   (and 2K in Orpheus 1).  Maximum size of a single output file (compiled and
   assembled for distribution) is now about 4 megabytes, up from 1M in
   previous betas (and 64K in Orpheus 1).  Total capacity of a single project
   is now approximately 4 gigabytes of compiled, assembled data, with the
   possibility of over 2.5 million distinct nodes and unlimited links among
   them.  The increased capacity was achieved while keeping memory and disk
   requirements at a minimum.  *** Note *** If you use an older version
   of the Reader with HTX's produced by this version, or if you use an older
   version of OHHELP.EXE with OH.HLP from the present version, those programs
   will misbehave.  The new Reader will however read older HTX's (from
   Orpheus 2) correctly.

 - Rationalized some of the TXT files in the package to save disk space and
   make your downloads a little easier.  Documentation on OH1TO2.EXE (the
   Converter) is now primarily in Help where it will be most useful.  While
   doing this I revised the relevant Help topics and added plenty of
   crosslinks.

 - Improved the Reader's (and Help's) response to <PgDn> in a scrollable
   card.  It no longer goes past the last line.

 - Made it easier to create unnumbered labels:  just enter "0" when prompted
   for a label number.  (See Help, Link Menu->Label.)  Also, when you make
   multiple labels in the same card, with each new label Orpheus automatically
   suggests a label number 1 higher than the last one.

Version 2.00.20:
================
 - Pressing <Alt-F1> to recall the last Help topic didn't work; now it does.

 - Added the ability to use an external editor called directly from OH.EXE.
   To set up editor use in your permanent configuration, open the Setup
   Orpheus dialog on the Other Menu, and select "External Editor".  To run it,
   select the same command but from the Edit Menu "External Editor".
   Optionally Orpheus passes to the called program the name of the card (file)
   in the current window.  Any files changed by your editor are reloaded by
   Orpheus on return.  You can also run a spell checker or any other external
   program this way.

 - Improved the Other Menu and the Edit Menu, shifting the hyper/ascii mode
   toggle to the latter, and rendering this and two other functions in a way
   more appropriate to their nature as toggles.  While doing this I refined
   the menu code so that you can use <SPACE>, the hilited command letter, or
   a mouse click to operate the toggle, but the menu remains open; if you
   press <ENTER> while on the toggle its setting is NOT changed, but you
   exit the menu.

 - Added an entry for "dimmed item on Statusbar" to OH.EXE's Color Dialog.

 - In the Restrict Access dialog the previous dialog's shadow stayed onscreen.

 - In both the Reader and the Simulator, displaying graphics from an Action
   link resulted in visual confusion on return.  Fixed.

 - Added support for the gbox() and gtext() script commands.

Version 2.00.19:
================
 - The Reader ignored command-line switches mentioned in OHREAD.DOC and
   online Help.  Now it pays attention.

 - Added support for graphic files in the Fastgraph SPR/PPR format.  These
   are generated by the SNAPSHOT utility available to registered users.

 - Dropped the "Compile 1, Simulate" command from the Project Menu.  While
   testing another function I realized that compiling just 1 card would lead
   to a situation in which any other recently-changed cards would be older
   than the CMP.

 - Dropped two accelerator keys for reformatting, best left as menu choices.

 - The simple message-dialog in OH.EXE would not, in particular circumstances,
   respond to mouse input.  Fixed.

 - The conversion utility OH1TO2.EXE (for updating projects developed under
   Orpheus 1.nn) now comments out any suspect script commands.

 - Support for Hercules mode 11 got left out; now it's in.

 - In OH.EXE there was one circumstance where a valid filename for a
   non-hypertext file would be considered invalid.  Fixed.

 - Improved the default color set.

 - If a project didn't have a STATUS file, e.g. after a conversion, OH.EXE
   would initially load it in ascii mode.  Fixed.

Version 2.00.18:
================
 - In the Reader, Simulator, and Help, printing a long card would result in
   an apparent crash.  Fixed.

Version 2.00.17:
================
 - Compiler would ignore instruction to compile only 1 card.  Fixed.

 - Improved the Reader's behavior regarding built-in colors and CFG files.

 - Fixed bug in the Export Topics List function (Browse Topics dialog).

 - Marking a whole file using <Ctrl-F5> (or the menu command) resulted in
   the card header being affected by subsequent block operations.  Fixed.

 - Now you can use unnumbered labels as a form of hiliting.

 - The hypertext compiler should continue compiling even if errors are logged,
   so you can find and correct all errors in one session.  Now it does.

 - All DOC files and the README now end with a ".TXT" extension.
