Doc File for CNXCHNG.PRG

5/20/90 Version


This little program allows you to change the Configuration in your GenEdit
DATA files without having to run GenEdit.  It allows useage of wildcards
to automate and greatly simplify the process.

A new config may be loaded from either a DATA file that contains a config
or a .CNX file.  If a .CNX file is loaded, a dialog box containing 63
configs appears.  Click on the config of your choice or the 'closer' icon
to exit (with no selection).  You may also type <Return> to exit.  If you
load a DATA file containing a config, you are asked if that config is the
one you wish to use as replacement.  Select [Yes] or [No].  The new config
name is displayed on the menu bar.

Be careful when you choose a config as the program has no idea what patch
data goes with what config.  You can basically replace the config with
_any_ config (even a config that contains no instructions!)

After a new config has been successfully loaded, replacement of old
configs in DATA files is allowed.  Select individual files or groups of
files within a folder (by use of wildcards) to be converted.  If a file
does not contain a config (patch data only), the new config will be
appended to it.

If you use any wildcards for DATA file conversion, a dialog box will
appear with the following options:

  ALL        Convert all matching files in current directory without
             query.  This automatically overwrites the original files, so
             be careful!

  w/ Query   Ask if you wish to convert each matching file in current
             folder.  An alert box comes up for each file.  You may
             select:  [Yes] to convert and overwrite the original file,
             [No] to skip to the next matching file, or [Quit] back to the
             main menu.

  to Folder  Select a Directory you wish the files to be written to (with
             query only on potential overwrite).  If you select OK with no
             name, the files will be written to the selected path.  If you
             specify a name on the Selection line, a new folder with that
             name will be created in the current folder and the files will
             be written in the new folder.

  Cancel     Return to the File Selector to choose more DATA files.

When using wildcards, most alert messages that would normally inform you
of the reason(s) a file is not being loaded or converted are skipped.  It
would slow things up tremendously to have to hit <Return> after each file
that matches the wildcard spec but fails for some other reason.  If you
want to know exactly what went wrong, just try converting the file by
itself.

Conversion of multi-block data files is not presently handled by the
program.  If enough people seem to think it is necessary, then maybe it
will be implemented later on.  You can, however, grab a config from a
multi-block file.  The first config encountered will be taken as the new
config.

The program is not HybriSwitch compatible at this time, but will be in the
near future.

NEW THIS VERSION

The Default button in the 'Wildcard Options' dialog box is now 'w/ Query'.

BUGS FIXED THIS VERSION

Previously, in the 'To Folder' wildcard option, if you used the name of a
file in the current directory as the name for the new folder, that file
would be deleted and a new folder was created with that name.  This was a
very suprising (and heretofore unknown, to me) "feature" of the GemDos
call Dcreate().  Now, in those instances, you are alerted that the folder
cannot be created and you are returned to the File Selector to make
another selection.

CNXCHNG.PRG runs in TT Medium resolution.
