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: searches down, 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: performs the replacement, 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 , 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 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 when used at the beginning of an empty line (to delete the line). The info screen for the Notepad wrongly gave as the accelerator to Minimize the Notepad; it was changed to 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 , 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 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 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 , the hilited command letter, or a mouse click to operate the toggle, but the menu remains open; if you press 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 (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.