How to Run the Valkyrie Demo
============================

1. Copy the contents of the demo disk to a directory on your hard
   disk. You can place the files anywhere, as long as they are
   accessible through your DOS PATH setting. After the demo files are
   copied, change to the directory containing the Clipper file(s) you
   would like to decompile.

2. Run the Valkyrie Preprocessor (VPP.EXE). For example, assume your
   program is named MENU.EXE:

      C>VPP MENU

   The Preprocessor examines your EXE file in order to locate all of
   the Clipper procedures and functions. It writes this information to
   a ".RIP" file, which is then used by the Recovery Engine.

3. Run the Recovery Engine (VDEMO.EXE):

      C>VDEMO MENU

   Using the information in the RIP file, the recovery engine will
   scan through your EXE file to locate the largest procedure in your
   program, which may take a few seconds. It will then decompile that
   procedure to disk. For example, if the largest procedure in
   MENU.EXE is "MAIN_MENU", VDEMO will create a source file named
   MAIN_MEN.SRC. Note that only the first eight letters of the
   procedure name are used for the DOS file name. The "SRC" extension
   is used to avoid overwriting any existing PRG files you may have on
   your disk.

4. Load up MAIN_MEN.SRC in your favorite editor and have a look!

   Note: After running VDEMO, you will no longer need to keep the RIP
   file. Also, in certain cases VPP will create a temporary file with
   an "OVV" extension, which the recovery engine uses. You may also
   delete this file after recovering the source code.

How to Use the Valkyrie Analysis Utility
========================================

   The Valkyrie Analysis Utility (VAU.EXE) determines the Clipper
   compiler and linker used to create a Clipper EXE file. It examines
   the executable file in detail to locate various "signatures" of the
   different versions of the compiler and the various linkers.

   To run it on a particular EXE file, type:

      VAU <progname>

   at the DOS prompt. The file extension is assumed to be "EXE", and
   is not required. VAU will examine the file and report what it
   finds.

   Compilers
   ---------
   VAU currently recognizes the Autumn '86, Summer '87, and 5.0x
   versions of the Clipper compiler. If VAU reports "No Clipper
   signature located", the file was not created with any of these
   compilers.

   Linkers
   -------
   VAU recognizes all versions of the overlay linkers BLINKER
   (including Blinker 2.01), PLINK86, WARPLINK, RTLINK, and ALINK.
   Valkyrie also supports linkers which produce non-overlaid Clipper
   applications (such as TLINK or Microsoft's LINK), but VAU does not
   report them by name, since these linkers do not insert overlay
   manager code into the executable. The message "Non-overlayed file.
   Linker identity not significant" means that the file was linked
   without overlays, usually by one of these "generic" linkers.

   At this time, Valkyrie decompiles Clipper Summer '87 executables
   linked with any of the above-mentioned linkers.

   If VAU reports that your application is either Autumn '86 or 5.01
   Clipper, please contact CodeWorks for a status report on when
   support for these versions will be available.

Where To Get Valkyrie
=====================

   Valkyrie for Clipper Summer '87 ........................... $395.00

   Complete system includes Valkyrie Analysis Utility, Valkyrie
   Preprocessor, Valkyrie Recovery Engine, UNPAK (UN-EXEPACKer), and
   free support and lifetime linker upgrades to registered users.

   USA & Canada:
   ------------
      CodeWorks
      249 North Brand Blvd, Suite 522
      Glendale, CA 91203
      Tel: 800-358-6936 / 818-244-7201 / 818-244-1564
      Fax: 818-246-2316
      CIS: 76662,1632

   Mexico:
   ------
      Computadores y Consumibles
      Torres Adalid #1955
      Col. Narvarte, C.P. 03020
      Mexico City, Mexico
      Tel: 52-5-682-4476 / 52-5-687-7796
      Fax: 52-5-669-0621

   Europe:
   ------
      Software Exclusive Ltd.
      70 High Street, Great Baddow
      Chelmsford, Essex CM2 7HH, England
      Tel: (44) 0245-478838
      Fax: (44) 0245-478597

      Lemax Company BV
      P.O. Box 263
      1170 AG Badhoevedorp, Netherlands
      Tel: (+31-20) 659-8701
      Fax: (+31-20) 659-6856

   Asia:
   ----
      RAMfarmer Computer Co., Ltd.
      Room 704, No. 105 Kai-Feng St. Sec. 1
      Taipei, Taiwan, R.O.C.
      Tel: (886) 2-3754166
      Fax: (886) 2-3754169

   Australia:
   ---------
      Talsoft
      789 Botany Road
      Rosebery, NSW 2018, Australia
      Tel: (02) 317-4404
      Fax: (02) 669-6864
