************************************************************************
*                                                                      *
*                               V5_to_V6                               *
*                               --------                               *
*                                                                      *
*            Authoright © 1995 by Ruppelware & No One Inc.             *
*                                                                      *
* Conversion of V5 caves to V6 caves. (also HIS & NAM)                 *
************************************************************************

--important----important----important----important----important----important--
--                                                                          --
-- MAKE A BACKUP OF YOUR V5 DISK / DIRECTORY BEFORE YOU START THIS PROGRAM! --
--                                                                          --
--important----important----important----important----important----important--

--------------« why this program? »----------------

The new V6 Player and Editor no longer work with the PLA & HIS directories,
but with the CAVE & HIGH directory. Also NAM has been changed and is now
called NAMES. These names seemed more logical to us.

Since we also changed the FILESIZES and NAMING standards of all the
caves and highscores, you can NOT copy the files from one directory
to the other; hence this program will do it for you. (aren't we nice?)

--------------« how does it work? »----------------

Usage: V5_to_V6 SOURCE_PATH DESTINATION_PATH [SWAP]

- Where SOURCE_PATH is the floppy disk or directory where your PLA & HIS
  directories are. (for example, if you have made a mine and saved it
  on a floppy and that floppy is in df0:, the SOURCE_PATH should be DF0:)

- Where DESTINATION_PATH is the floppy disk or directory where you want
  to save the new V6 versions.

The source and destination paths MAY be the same. (f.i. 'V5_TO_V6 DF0: DF0:')

However, the floppy disk size is NOT big enough to hold all OLD and NEW
files together. So you have 2 options:

- Use SWAP (so you would type 'V5_TO_V6 DF0: DF0: SWAP')
  After reading all the old files from the floppy disk in DF0: the program
  will ask you to insert another floppey disk into DF0: after which it
  will write the new files on that one. This disk must be formatted and
  have at least 480K free.

- don't use SWAP (so you would type 'V5_TO_V6 DF0: DF0:')
  After reading all the old files from the floppy disk in DF0: the program
  will ask you if it may DELETE all old files. If you say anything else
  than 'Y' it will stop.
  If you typed 'Y' it will first delete all files:
  - pla/...     (also the directory will be deleted)
  - his/...     (also the directory will be deleted)
  - nam
  Then it will create:
  - cave/...
  - high/...
  - names

--------------« can it go wrong? »----------------

Of course it can go wrong (remember Murphy?). No programmer is save from
powercuts, GURU's caused by other tasks and so on. SO MAKE THAT BACKUP!!

Errors that the program can cause are:
======================================
- "Invalid Source Path entered"
  The first path typed could not be accessed, please check your typing.

- "Invalid Destination Path entered"
  The second path typed could not be accessed, please check your typing.

- "Insufficient memory to complete task. Please close some of your other"
  "active tasks to free memory. This task needs 300K of free mem."
  Do I need to say more ....? (This can ONLY happen when the program reads
                               so it can NOT destroy anything)

- "...... FAILED!!!"
  If this is printed behind a file in the save cycle, something went
  wrong. The program could not open that file.
  How can that happen? :
  - Disk Full
  - The file (let us say 'cave/08T') already exists and is protected from
    writing.