EXTRA UTILITIES

   This registered package contains two extra utilities, TRSREAD.EXE and
   TRSWRITE.EXE. These utilities can transfer files to and from TRS-80
   virtual disks. They are present only in the registered package, and
   further distribution is not allowed under any circumstances.

   TRSREAD and TRSWRITE can manipulate the same virtual disk formats as
   the emulator itself, including actual TRS-80 disks (if you have
   compatible hardware). They can recognize most disk formats used by the
   major TRS-80 operating systems, including all versions of TRSDOS,
   DOSPLUS, MULTIDOS, LDOS, LS-DOS, and most formats of NEWDOS/80. They
   also transparently work with date-converted LDOS and LS-DOS disks. Be
   sure you make a spare copy of any important virtual disk (or put a
   write protect tab on any real disk) before you do any file
   manipulation with it.

TRSREAD.EXE

   This utility reads (extracts) files and also can display the directory
   of any virtual disk file. Whenever it extracts any file, both the
   logical record length and password are ignored, but the TRS-80 file
   time and date, if either are present, will be used to set the time and
   date of the new MS-DOS file. For help with the command line options,
   type:

     TRSREAD

   with no parameters. A brief help screen will be displayed.

   TRSREAD uses the following command line format:

     TRSREAD [options] virtual disk [files]

   The virtual disk can either be a file in the current subdirectory, or
   "A:" or "B:" for a real TRS-80 disk in drives A: or B:. The files can
   be expressed as MS-DOS style wildcards, lists of files, or a
   combination of both.

   TRSREAD uses the following commmand line options:

     -S: This includes files with the system attribute in the search.
     You would not normally want to use this option.

     -I: This includes files with the invisible attribute in the search.

     -E: This extracts the specified file(s) to your current MS- DOS
     directory.

     -V: This views the directory of the virtual disk. (This is the
     default action if you do not specify an option.)

   Examples:

     TRSREAD -I DISK1 */BAS

   will display a directory of all files with the "/BAS" extension,
   including invisible files, contained in virtual disk file "DISK1.DSK".

     TRSREAD -E DISK2 */CMD GAME1/BAS GAME1/TXT GAME2/*

   will extract from "DISK2.DSK" to the current MS-DOS directory all
   files with the extension "/CMD", the files "GAME1/BAS" and
   "GAME1/TXT", and all files with "GAME2" as the filename (with any
   extension).

TRSWRITE.EXE

   TRSWRITE.EXE performs the opposite function of TRSREAD.EXE. It can
   write MS-DOS files to a TRS-80 virtual disk. The dates and times of
   the files will be preserved if possible, and a blank password will be
   used. TRSWRITE uses the following command line format:

     TRSWRITE virtual disk [file]

   The virtual disk and file parameters work the same as TRSREAD, except
   that only one filename or wildcard can be specified at a time. For
   example:

     TRSWRITE DISK1 *.CMD

   will add all files with the "CMD" extension to the virtual disk
   "DISK1.DSK".

                                 ----------

   Matthew Reed
   http://www.trs-80emulators.com
   mkr@trs-80emulators.com
