
       **************************************************************
       * Upgrading RAILWAYS v3.0.x to v3.0.4 DAT, LYO and DCC files *
       *                for the new uncoupler feature               *
       **************************************************************

This file describes how to upgrade RAILWAYS DAT, LYO and DCC files
created with v3.0.x (x<=1), (or created with 2.04 (see UPGRDRLW.EXE)
and converted to v3.0.x) to this new version which supports uncoupler
drawing and uncoupler digital control.

Please note that some DAT files have been already upgraded to support
this new feature. See the table in section 'IV.3. DAT Files included in
RAILWAYS v3.0.4 package' in the documentation (README.TXT for instance).
If this is your case, please read points #0, #3, #4 and #5.
If not, please read every point.

If your DAT file contains or should contain uncoupler description(s), please
follow these instructions. Otherwise you can stop reading !

#0. Always make a backup of the files you will have to change !...
    Read this file throughoutly before doing anything.

#1. Edit your DAT file (with any ASCII editor) and find the uncoupler
    description thanks to its reference. In the following example, we
    assume that it is "S uncoupler" (straight) or "C uncoupler" (curved)...
    Then you should find something like that in the DAT file :
       |S uncoupler
       |1 1 11
       | [its length]  0.0000000000E+00
    if your uncoupler is straight, or :
       |C uncoupler
       |1 1 12
       | [its radius]  [its angle]
    if it is curved.

#2. You will have to change just ONE field.
    - If the uncoupler is STRAIGHT, change 11 to 255, and the result
      should be :
       |S uncoupler
       |1 1 255
       | [its length]  0.0000000000E+00
    - If the uncoupler is CURVED, change 12 to 127, and the result
      should be :
       |C uncoupler
       |1 1 127
       | [its radius]  [its angle]

    *** Do not change anything else, otherwise you will get errors ***

#3. Run Railways v3.0.4, load the "corrected" DAT file and your LYO
    (or DCC) file.
    If your layout contains uncouplers (for instance "S uncoupler"),
    delete them and replace them with the new "S uncoupler".
    The uncoupler drawing should change.

#4. Save your layout.

#5. And that's all.
    If you have trouble upgrading your files, you can send them to me
    on a floppy disk containing your DAT, LYO (and maybe DCC) files, at
    the snail-mail address I give in the documentation and in-line help.

/* End of File */
