                                    MOD2ZIP
                                  Version 1.2

                 [.MOD .669 .STM .S3M .MTM .FAR .DMF .XM .MID]

                               Copyright (c) 1995
                           SofTech by Davide Calabro'

                              calabro@dsi.unimi.it

                              V.le XXV Aprile, 26
                           21019 Somma Lombardo (VA)
                                     ITALY


  INTRODUCTION
 

   MOD2ZIP extracts title, writes FILE_ID.DIZ and creates a compressed file
   ready to upload! It's designed for handle exclusively music files;
   this version handles .MOD .669 .STM .S3M .MTM .FAR .DMF .XM .MID modules.

   Compressed files can be created using PKZIP, ARJ, RAR, LHA
   or Info-ZIP packers.


   CHANGES MADE      (+) Added   (-) Removed   (*) Changed/Fixed
 

   01/Jun/95   Version 1.2
               + Midi files (*.mid) support
               + DMF files (*.dmf) support
               + Support for LHA packer
               + Quiet and very quiet mode
               + User-definable default song-title
               + Load options from external file (optional)
               + Composer name in FILE_ID.DIZ (option /C)
               * Improved CPU-detection routine

   17/Feb/95   Version 1.1
               * Fixed a little bug when using absolute paths. Thanks to
                 Arachnid (Sysop of Cyber Web) for report me this bug
                 so fast!

   15/Feb/95   Released version 1.0


  SYSTEM REQUIREMENTS
 

   To run MOD2ZIP requires:  80286+ based computer
                             MS-DOS v3.1 or higher
                             512Kb of free memory

                             The program you want to use to create compressed
                             files:
                                     PKZIP.EXE  (for .ZIP files)
                                     ARJ.EXE    (for .ARJ files)
                                     RAR.EXE    (for .RAR files)
                                     LHA.EXE    (for .LZH files)
                                     ZIP.EXE    (if you use Info-ZIP)
                                     ZIP386.EXE (if you use Info-ZIP *and*
                                                 you have a 80386+ machine)

                             The program you use must be available via the
                             PATH environment. See the MS-DOS manual on how
                             to set this variable.


  DISCLAIMER
 

   MOD2ZIP users are subject to this disclaimer of warranty:

   MOD2ZIP is supplied as is. The author (SofTech, a.k.a. Davide Calabro')
   disclaims all warranties, expressed or implied, including, without
   limitation, the warranties of merchantability and of fitness for any
   purpose. The author assumes no liability for damages, direct or indirect,
   which may result from the use of MOD2ZIP.


  COPYRIGHTS AND TRADEMARKS
 

   MOD2ZIP is copyright (c) 1995 SofTech by Davide Calabro'. See at the end
   of this document on how to get in touch with SofTech.

   PKZIP is copyright (c) 89-94 by PKWARE, Inc.

   ARJ is copyright (c) 90-94 by Robert K Jung

   RAR is copyright (c) 93-94 by Eugene Roshal

   LHA is copyright (c) 88-91 by Haruyasu Yoshizaki

   ZIP/ZIP386 is copyright (c) 90-94 by M.Adler,R.Wales,J.Gailly,K.U.Rommel

   WINDOWS and MS-DOS are trademarks of Microsoft Corp.

   VALIDATE v2.00 is copyright (c) 1994 by McAfee, Inc.


  MOD2ZIP REFERENCE
 

   This is the syntax of the program:

             MOD2ZIP [/?] [/F] [/I|/J|/R|/L] [/X] [/C] [/T["new title"]]
                     [/Q[!]] [/@file] [d:\path\filename]

       
   /?

   Display a quick help. You may use also /h.


   /F

   Use the fastest compression method available. MOD2ZIP by default creates
   compressed files using the maximum compression possible with the selected
   packer.


   /I

   If you want to use Info-ZIP packer instead of PKZIP. MOD2ZIP will search
   for a program called ZIP.EXE. Note that if you have a 80386+ machine
   MOD2ZIP will search for ZIP386.EXE.
   Files created with PKZIP and Info-ZIP are identical! Info-ZIP is a freeware
   program and can be found on many BBSs and FTP sites. Please refer to the
   included file PLACES.TXT on how to get the newest version of Info-ZIP.


   /J

   Use ARJ. By default MOD2ZIP uses PKZIP to create compressed files. This
   option lets you to create ARJ files instead of ZIP files.


   /R

   Use RAR. As above option but for the new packer standard called RAR.


   /L

   Use LHA. As above options but for LHA packer.


   /X

   Use extended titles. If not specified, the FILE_ID.DIZ will contains only
   the title of the files, otherwise MOD2ZIP will writes also the filetype.

     Example of FILE_ID.DIZ:   File_title_here          (without /X)
                               .MOD: File_title_here    (with /X)


   /C

   Include composer name. A file called MOD2ZIP.ATH must be present in the
   same directory of MOD2ZIP.EXE; this file is the composers' database. You
   can edit this file with a generic text editor; insert your favourite
   composers and, optionally, set the colors for the composers' dialog. A
   simple one is included with MOD2ZIP, please refer to this for an example
   of composers' database. This option will write in the FILE_ID.DIZ also
   the composer name of the module. For each module processed a listbox
   will be displayed with all the composers found in MOD2ZIP.ATH; use the
   up/down arrow keys to select the composer and press <Enter> to select or
   <Esc> to bypass (the module will be processed with no composer name). If
   the composer is not present press <Alt-N> to insert a new one: this will
   be automatically inserted in the database.

     Example of FILE_ID.DIZ:   File_title_here          (without /C)

                               File_title_here          (with /C)
                               Composed by <name>


   /T["new title"]

   Change the default song title. If a module has no title, MOD2ZIP insert
   this default title

                          <No Title For This Song!>

   This option lets the user to change, or disable, the default song title.
   Use /T"My Def Title" to _change_ the default song title in

                                My Def Title

   or use /T to _disable_ it (no default song title will be written).


   /Q[!]

   Quiet and very quiet modes. With /Q some not essential messages will
   be not displayed. With /Q! _all_ the messages (except for the copyright
   notice) will be not displayed.


   /@file

   Load options from file. Option-file must be a generic text file and the
   options must be written on the same line. Other options can also be
   normally specified on the MOD2ZIP command line.

     Example:  MOD2ZIP /@OPTIONS.TXT
               MOD2ZIP /@OPTIONS.TXT /F /I

               OPTIONS.TXT may be:
               /C /X C:\MUSIC\*.S3M          (on the same line)


   d:\path\filename

   By default MOD2ZIP handles ALL music files in the current directory. If
   you want to process files on other disks/directories or you want to
   process only a type of file use this option. Wildcards *,? may be used.

     Example:  MOD2ZIP D:\MODS         (All music files in D:\MODS)
               MOD2ZIP C:\MUSIC\*.S3M  (All *.S3M files in C:\MUSIC)


  RETURNED ERRORLEVELS
 

   MOD2ZIP returns an ERRORLEVEL with its termination.

   0 - Program terminated succesfully
   1 - Program terminated with /? option (quick help)
   2 - Program terminated succesfully with no files found/processed

   MOD2ZIP was tested under MS-DOS v6.2 and WINDOWS v3.1


  CARDWARE
 

   This program is the result of a fine programming session, done just
   for fun. It's released under the Cardware concept. You are allowed to
   use this software for a trial period of 1 (one) week. After this period
   of time if you liked MOD2ZIP you must send a postcard to the author, else
   you *must* delete it from your hard drive. Refer at the end of this
   document on how to get in touch with SofTech. E-Mails sent instead of
   postcards are INVALID!! Send a postcard from the place you live!
   You are encouraged to give a copy of MOD2ZIP to your friends, to upload
   it on BBSs or FTP sites you call, but please don't remove any file from
   the original package; if you want to add a file with your stats (i.e.
   your BBS adv.) you are free to do it.
   This program *can* be included in any CD-ROM collection, if above
   conditions are respected.


  PACKING LIST
 

   These files make the original package of MOD2ZIP v1.2:

    MOD2ZIP.EXE    - Main program
    MOD2ZIP.DOC    - Manual (this file)
    MOD2ZIP.ATH    - Sample composers' database
    FILE_ID.DIZ    - Description file for uploads
    CATALOG.EXE    - SofTech's software catalog issue #1
    PLACES.TXT     - Where find SofTech's releases and packer programs
    VALIDATE.EXE   - McAfee's Validate program
    VALIDATE.TXT   - Validate documentation

   If one or more of these files miss please think this package may be
   corrupted.


  VALIDATION CODES
 

   McAfee's VALIDATE v2.00 reports following validation codes:

   MOD2ZIP  EXE     16841  06-01-95   1:20a   FE6C   4C1B
   CATALOG  EXE     12585  06-01-95   0:01a   5211   964C


  NEXT RELEASES
 

   You can find next releases of MOD2ZIP where you got this version. For
   a list of sure places where find next releases please refer to the
   included PLACES.TXT file.

   Do you want to distribute SofTech's releases? If so please send mail to
   SofTech using, if possible, the Internet way.


  GREETINGS
 

  SofTech wishes to send its greetings to Joni Moilanen for the suggestions of
  some new features that are implemented in this version of MOD2ZIP!


  SOFTECH
 

   This software is produced by:

   SofTech "Software products, just for fun"
   by Davide Calabro'

   Internet address: calabro@dsi.unimi.it

   Snail mail address: SofTech
                       by Davide Calabro'
                       V.le XXV Aprile, 26
                       21019 Somma Lombardo (VA)
                       Italy

