Copyright 1996, Hyperion Softword ************************************* * Orpheus 2, version 2.30 * ************************************* Comments and queries to: Hyperion Softword, 535 Irene-Couture, Sherbrooke, QC J1L 1Y8, Canada tel/fax - 819-566-6296 (Rod Willmot) email - willmot@interlinx.qc.ca Contents of this file: Purpose Usage Registered Users Disk Space Requirements Step 1: The Converter For More - See Online Help PURPOSE: ======== OH1TO2.EXE (The Converter) is a utility for converting Orpheus 1.nn files to the Orpheus 2 standard. Projects to be converted must be in uncompiled format, not HTX's. OH1TO2 does not delete or overwrite the original project. You should not dispose of the original until you are fully satisfied with your results using Orpheus 2. USAGE: ====== Give the following command at the DOS prompt: OH1TO2 The Converter will take over from there, asking what you want to convert and where you want the new version to go. It's safe, easy to use, and interactive. As discussed later on this document, it even lets you pause during conversion to free up disk space. REGISTERED USERS: ================= If you are a registered user of Orpheus 1 (any version), and are using a copy of Orpheus 2 received from any shareware source (BBS, Internet archive, CD-ROM, etc), please note that you must obtain a KEY file from Hyperion Softword in order for Orpheus 2 to recognize you as a registered user. Until you do so, anything you compile with the new version will invoke the "unregistered shareware" warning from the Reader. Users who purchased Orpheus 1.64-1.65 at the full price ($79 *US*) will receive a complete upgrade package, including KEY file, in the mail. Users who purchased earlier versions of Orpheus, or who paid less than the current price in US dollars, will receive an upgrade offer in the mail. Again, if you're in a hurry just give me a call. DISK SPACE REQUIREMENTS: ======================== The Converter does not delete or overwrite any of the files from the original version of a project. The converted (Orpheus 2) version is stored in a different set of directories. This means that if you have an enormous project to convert, and little free disk space, you will need to free up space either before or during the conversion process. Don't panic. Read on. This is a friendly Converter. If you NEED to free up space and are not using a disk-compression system such as Stacker or Doublespace, you will have to offload files onto diskette. If you are not using a disk-compression system, a better method is to compress rarely-used files with PKZIP. Actually the best method in both cases is to do a little house-cleaning... I've never seen a file that didn't beg to be deleted. (We're lean and mean, here at Hyperion Softword.) Once you have told the Converter what you want to convert, and where you want it to store the new version, the program analyzes the original project and estimates how much disk space it will need. As conversion proceeds you can watch the indicators showing remaining free space and space still needed. At any time, you can interrupt processing by pressing the . This opens the "OH1to2 paused" dialog, which has three options: press the again to resume, press to abort conversion, or press to shell to DOS. Use this last option (shelling to DOS) to offload files onto diskette or compress files with PKZIP, assuming you need to free up space. When you return from the shell by giving the "exit" command at the DOS prompt, you'll be back in the "OH1to2 paused" dialog and can resume processing, abort processing, or even shell to DOS again. It's neat shelling out without spending a dime. STEP 1: THE CONVERTER: ====================== The first step is to run OH1TO2 on the project you want to convert. When you start the program the opening dialog asks for the following input: Old Project: [............................................................] New Name: [........] New Path: [............................................................] In the "Old Project" field, enter the full path to the project you wish to convert, ending with the name of the project itself. For example, if you have a TEST project based in the C:\ORPHEUS\ directory, enter "C:\ORPHEUS\TEST". In the "New Name" field, enter the name you wish to use for the Orpheus 2 version of the project. It can be the same as the original if you wish, but you might prefer a different name to avoid confusion, such as TEST2 if the original was TEST. The name can be up to 8 characters long; it cannot include a path or file extension. In the "New Path" field, enter the full path to where you want the converter to store the Orpheus 2 version of the project. This MUST be a different from the location of the original version. If any directories named in the path do not exist, the Converter will create them. For example, suppose you are using C:\OH2 as your directory for your Orpheus 2 program files. You can also use this as the base directory for your converted projects. In this case you would enter "C:\OH2" -- just the path, not the name of the project itself. ->> In Orpheus 2, project directory names are identical to the project name itself; they do not end with an underscore as in Orpheus 1. For example, the TEST project under Orpheus 1 would have a project directory named TEST_, but under Orpheus 2 it would just be TEST. Following our example, using TEST2 as the new name would result in a project directory named C:\OH2\TEST2\. The new project file, TEST2.PRJ, would be stored in C:\OH2\. Once you've filled the Old Project, New Name, and New Path fields to your satisfaction, tab to the "Begin Conversion" command and press . The Converter makes sure everything seems right before going on. The next stage begins with a scan of your old project. The Converter examines every storage directory in it, counting up how many cards you have. Then it displays an estimate of the amount of disk space needed along with the disk space currently free. Since OH1TO2 does *not* delete or overwrite your old project's files, the free space will diminish as conversion proceeds. As discussed above under "Disk Space Requirements", you can pause conversion at any time, then either abort or shell to DOS in order to free up more space. When the conversion is complete, you may see a message warning you about script commands requiring further updating on your part. This is discussed later on under "Updating Script Commands". FOR MORE - SEE ONLINE HELP ========================== Complete documentation on using the Converter, and on other important aspects of moving up to Orpheus 2, is available in online help. While in OH.EXE, press to open Help, and from the Contents page select "Orpheus Utilities->OH1TO2.EXE->Documentation". Everything in this file is included, along with the following additional topics: Results of Step 1 What Got Changed Step 2: You and OH.EXE The Reader Interface The Resource Path Concatenating "More" Links Updating Script Commands Since the Help version includes hypertext links to everything in the Orpheus system, and since you may be doing further conversion while working in OH.EXE, you will find that much easier to use than this file. You can even print out hard copy from Help.