 Divil presents Ŀ
                   
        ܳ
          ۳
                             ۳
                                   ۳
                                          
                                   
                                                 
                                                                      
 version 2.00 shareware  (C) 1996 - 1998 


Contents:
~~~~~~~~~
 1. INTRODUCTION
 2. REQUIREMENTS
 3. ARCHIVE CONTENTS
 4. INSTALLATION
 5. DESCRIPTION
 6. USAGE
 7. HISTORY
 8. COMING SOON
 9. THANKS
10. FREE REGISTRATION
11. AGREEMENT & DISCLAIMER
12. HOW TO CONTACT THE AUTHOR
13. LAST SPOT


       Ŀ
 1. INTRODUCTION 
       

Dirmod is  an utility for  creating lists of  your MODs, S3Ms,  XMs & NSTs.
It is useful to  create 00index.txt files for module parts  of FTP archives
and also when you want to swap.

"Dirmod" is made up of "DIR" (essential DOS command) and "MOD" (basic music
module extension).


       Ŀ
 2. REQUIREMENTS 
       

In order to run Dirmod you need:

 computer
 DOS-compatible operating system 
 65 kB or more free conventional memory
 65 kB or more free disk space
 music modules (Dirmod will run even without them but what then?)

Funny requirements, what do you mean?


         Ŀ
 3. ARCHIVE CONTENTS 
         

An archive contains 4 files:

Filename        Size  Description

DIRMOD.EXE    25,515  program itself
DIRMOD.TXT    11,000  this documentation
DIRMOD.HLP       936  help file
FILE_ID.DIZ      371  ID file

If some files are missing or chnaged, download Dirmod again from

ftp://ftp.simtel.net/pub/simtelnet/msdos/music/dm200.zip

or some Simtel's mirror site.


       Ŀ
 4. INSTALLATION 
       

Step-by-step installation process:

1.  Unpack.

Simple, eh?  :-)


      Ŀ
 5. DESCRIPTION 
      

With Dirmod you can make lists  of music modules in the best and most popu-
lar formats:

ͻ
 Ext  ID(s) - sorted by spread                                       
͹
 MOD  'M.K.' '8CHN' 'FLT4' '6CHN' 'xxCH' 'M!K!' 'FLT8' 'M&K!' 'M.K!' 
Ķ
 S3M  'SCRM'                                                         
Ķ
 XM   'Extended module: '                                            
Ķ
 NST  (none)                                                         
ͼ

In 'xxCH', xx can be from 10 to 32.

NoiseTracker modules (.NST) can't  be recognized by ID, because they simply
don't use any. Anyway, all unrecognized files with extension MOD or NST are
added automatically to the list.

Other formats aren't supported since  I miss their specifications. If you'd
like to add your favourite format, REQUEST IT (see section 12)!

List includes filename, filesize in bytes, number of channels and songname;
a summary is added at the end.

You can choose  primary, secondary or  tertiary sorting by  any list items.
Multiple sort methods are useful if you want to sort primarily by extension
or number of channels.


   Ŀ
 6. USAGE 
   

There're 2 ways how you can use Dirmod:

1.  GRAPHICAL USER INTERFACE (GUI)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
If you run Dirmod with no parameters, you get to GUI, where you can:

 browse on drives & directories
 select modules & modules directories you want to place to your list
 create lists
 view created lists

Dirmod's GUI includes  one unique feature: everything  you select in a File
Selector Window (the  largest window of  a screen) remain  selected even if
you change directory. For lucidity there's a Selection Window at the bottom
of the screen where you  can see everything you've  selected and it is also
possible to unselect it there (as well as in the File Selector Window).

Press F1 to get help on current GUI window.


2.  COMMAND LINE INTERFACE (CLI)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
In CLI, you get full control about  wild (?) Dirmod using parameters on the
command line that is as follows:

[<path>]DIRMOD /O<list_filename> [<module_masks>] [/Sx[x[x]]]

Meaning of parameters:

  <path>            - disk and/or directory where DIRMOD.EXE is located
  /O<list_filename> - name of text-file you want to list your modules in
                    - if the file already exists,  you can confirm overwri-
                      ting or not
  <module_masks>    - masks of module files you want to list
                    - you can use up to 60 masks (if you're gonna breed so-
                      me huge command line, remember that its length is li-
                      mited to 127 in DOS)
                    - you can use paths or masks (or whole names) or both
                    - if you omit  them, Dirmod will search  for all *.MOD,
                      *.S3M, *.XM & *.NST files in current directory
  /Sx[x[x]]         - sort modules by x where x can be:
                         N - filename (default)
                         E - extension
                         F - filesize
                         C - number of channels
                         S - songname
                    - add minus sign after any x to reverse sort order

All the parameters can be mixed up anyway. And of course you can use lower-
case, uppercase, whatever you like......

Run Dirmod with /? parameter to get command line help.

Examples of command line:

C:\DIRMOD\DIRMOD /O00index.txt

 - lists all *.mod, *.s3m, *.xm & *.nst modules in current directory sorted
   by filename to a file 00index.txt

DIRMOD fyc.mod it.mod booboo.mod dns.mod eg.mod kent.mod /Oa:\mods.lst /SF

 - lists some mods sorted by filesize to a:\mods.lst

DIRMOD /SC-EN d:\mods\pop-rock\w*.* /O\w.txt

 - lists all modules with filename beginning with "w" from d:\mods\pop-rock
   sorted by number of  channels (more first), extension  and filename to a
   file w.txt in root of current disk


    Ŀ
 7. HISTORY 
    

1.00  finished 13th Jan 1997
      first try - made as my Turbo Pascal term-work

1.01  finished 10th Mar 1997
      filesize added to the list
      summary improved

1.02  finished 16th Mar 1997
      module-files access improved

1.03  finished 29th Mar 1997
      module-files access improved once again
      support for MODs with '16CH' ID added
      NoiseTracker modules support added

1.10  finished 20th Apr 1997
      sorting by any of all 3 list items added
      NoiseTracker modules support improved
      some minor improvements done

1.20  finished 9th May 1997
      support for any directory added
      duplication removed (e.g. when a file suits to 2 or more masks)
      and of course other good stuff.....

1.21  finished 9th Jun 1997
      both exe and txt improved a bit

2.00  finished 20th Jun 1998
      original GUI added
      number of channels added to list
      secondary & tertiary sorting added
      '16CH' support changed to 'xxCH' (xx can be from 10 to 32)
      filesizes added to summary
      sorting by extension added
      extension separated from filename in list
      duplication removing removed (see changes in v1.20)
      new logo


      Ŀ
 8. COMING SOON 
      

 mouse support
 list including also time length and number of samples and patterns
 support for more formats (if you request it)
 recursive searching in subdirectories
 maybe more...


    Ŀ
 9. THANKS 
    

Big thanx to:

 former roommate Milan for providing a few lines of source
 ? for MOD.TXT (Protracker 1.1B Song/Module Format)
 ? for TECH.DOC (Scream Tracker 3.20 File Formats And Mixing Info)
 Mr.H of Triton for XM.TXT (The XM ver. $0104 module format description)
 JSInc. for MOD4WIN


          Ŀ
 10. FREE REGISTRATION 
          

This program is shareware,  i.e. if you continue using it  after 30 days of
your evaluation period,  you're expected to  REGISTER FREELY  by sending an
E-MAIL to divil@post.cz. Please use subject "Dirmod Registration" and write
your full name, your age, where you live, how you like Dirmod, what you use
lists created with it for and whether  you want to get update announcements
by e-mail. Feel free to omit anything except subject, but before you do it,
please take note that I WILL NOT  pass your information to any third party,
I'd just like to know something about users of my product.

If you don't register,  you must remove all program's  components from your
system.
REMEMBER: All shareware authors  including me continue improving their work
only if they get enough registrations (free or paid) to see it has a sense.


            Ŀ
 11. AGREEMENT & DISCLAIMER 
            

You may use, copy and distribute only  the whole archive freely, as long as
no money is charged for it. You are NOT allowed to modify, disassemble, re-
engineer or misuse any of the files in the archive.

YOU ARE USING THIS PROGRAM  AT YOUR OWN RISK. THE  AUTHOR IS NOT LIABLE FOR
ANY DAMAGE OR LOSS WHICH MAY RESULT DIRECTLY OR INDIRECTLY FROM USE OF THIS
PROGRAM.


              Ŀ
 12. HOW TO CONTACT THE AUTHOR 
              

Your registration e-mails, comments, questions, bug reports, cool web links
etc. are awaited at:

  divil@post.cz

If you think the post is fast enough, send me whatever (except a bomb) to:

  Petr Diblik
  Libchavy 41
  561 16
  Czech Republic
  (Europe)

By the way, it is also possible to visit me at this address  :-)

Wanna talk to me? Try this fone number:

  +420 465 58 22 56


      Ŀ
 13. LAST SPOT 
      

Pssst! - - - Don't say it to anyone! - - I've heard experimenting with text
modes reveals something like a hidden part...