                      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


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, when
    Orpheus 2 is officially ready.  If you're happy with Orpheus 2 even
    in beta form and want your KEY file as quickly as possible, give me
    a voice call at 819-566-6296 and we'll arrange for you to download 
    it directly from me.  Or I can email it to you as a file attachment.

    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 <Spacebar>.  This opens the "OH1to2 paused" dialog,
    which has three options:  press the <Spacebar> again to resume, press
    <Esc> to abort conversion, or press <Alt-S> 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 <Enter>.
    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 <F1> 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.

