home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / sound2 / tumodd20.zip / MODDIR.DOC next >
Text File  |  1993-06-25  |  7KB  |  163 lines
  1.              ███▄ ▄███  ▄██████▄ ████████▄ ████████▄ ███ ████████▄
  2.              ███▀█▀███ ▐██   ███ ███   ███ ███   ███ ███ ███   ███
  3.              ▐██ ▐ ▐██ ▐██   ▐██ ▐██   ▐██ ▐██   ▐██ ▐██ ▐██   ▐█▌
  4.               ██    ██  ██    ██  ██    ██  ██    ██  ██  ███████
  5.               ▐█    ▐█  ▐█    ▐█  ▐█    ▐█  ▐█    ▐█  ▐█  ▐█    █▌
  6.                █     █   █     █   █     █   █     █   █   █     █
  7.                ▐     ▐    ▀▀▀▄▄▀   ▐▄▄▄▄▄▀   ▐▄▄▄▄▄▀   ▐   ▐      ▌
  8.  
  9.                                  M O D D I R
  10.  
  11.                                     v2.0
  12.                                 (c)1993.06.25
  13.                     by Tom Rathborne / Totally Unlimited
  14.  
  15.                              MODDIR is FREEWARE!
  16.  
  17. CONTENTS:
  18.           ABOUT MODDIR
  19.           USAGE
  20.           FORMATS SUPPORTED
  21.           ABOUT THE AUTHOR
  22.           OTHER STUFF
  23.           HISTORY
  24.  
  25. *** ABOUT MODDIR: ---------------------------------------------------------
  26.  
  27.     With the advent of Creative Labs' SoundBlaster audio card, the Amiga
  28.     .MOD (Module) format of music is now very popular on the PC-compatible
  29.     scene. There are LOTS of different types out there, too.
  30.  
  31.     MODDIR is a simple derivative of my ever-popular :-) MODNAMES program.
  32.     MODDIR lists the modules in the current directory, their sizes, the
  33.     title of the song, and the file type.
  34.  
  35. *** USAGE: ----------------------------------------------------------------
  36.  
  37.     There are many different extensions on modules, for example:
  38.  
  39.     MOD NST STM STS OCT 669
  40.  
  41.     MODDIR defaults to listing ALL files in the current directory. If it
  42.     finds a file that it cannot identify, it will not list it.
  43.  
  44.     If you specify a filespec, i.e. *.MOD, then all files will be listed
  45.     regardless of whether or not they can be identified.
  46.  
  47.     To display a directory, simply change to the directory where you store
  48.     your modules and run MODDIR. You can't specify another directory - only
  49.     a file specification. Here's some sample output:
  50.  
  51. ╒══════════════════════════════════════════════════════════════════════════╕
  52. │ MODDIR v2.0 ■ (c) 1993.06.20 by Tom Rathborne of Totally Unlimited       │
  53. │ Directory of *.*                                                         │
  54. ╞══════════════╤══════════╤══════════════════════╤═════════════════════════╡
  55. │ Filename     │ Size     │ Song Title           │ File Type               │
  56. ├──────────────┼──────────┼──────────────────────┼─────────────────────────┤
  57. │ HARDWIRE.669 │    62040 │  Hardwired...        │ Composer 669 Module     │
  58. │ ECHOING.MOD  │    40104 │ Echoing              │ Sound/Noise/Pro Tracker │
  59. │ VOCALIZE.MOD │    16220 │ Vocalize             │ FastTracker 8-channel   │
  60. │ RAPBEAT.OCT  │    53542 │ [No title]           │ OctaCompositor          │
  61. │ JAM.OKT      │   289280 │ JAMES BROWN IS DEAD! │ Oktalyzer               │
  62. │ GMIX.STM     │    10112 │ [No title]           │ ScreamTracker Module    │
  63. │ DRUMROLL.STS │     1595 │ A Drum Roll, Please. │ ScreamTracker Song      │
  64. ├──────────────┼──────────┴───────────┬──────────┴──────────┬──────────────┘
  65. │    7 modules │   472893 total bytes │ MODDIR is FREEWARE! │
  66. └──────────────┴──────────────────────┴─────────────────────┘
  67.  
  68.     MODDIR should work properly with most module file formats. It
  69.     originally just read the first 20 characters of the file, but the
  70.     Oktalyzer and 669 formats don't conform to that, so the autodetection
  71.     routine was born.
  72.  
  73.     If the name in the file is empty, you'll just see
  74.     "(No name)" in the appropriate column.
  75.  
  76.     If you don't specify a filespec and no valid modules are found, you'll
  77.     simply see a blank list. If you DO specify a filespec, invalid files
  78.     will be displyed with [N/A] as the name.
  79.  
  80.     The most error checking done here is this; if no files matching the
  81.     filespec are found, you will get a message like this:
  82.  
  83. * MODDIR v2.0 ■ (c) 1993.06.20 by Tom Rathborne of Totally Unlimited
  84.   ■ No files matching *.POO found
  85.   ■ MODDIR only works in the current directory!
  86.  
  87.     You'll probably get the same message if you try to look at another
  88.     directory. For example, if you are in the root directory, and type
  89.     "MODDIR C:\MODS" or "MODDIR C:\MODS\*.*". I haven't added support for
  90.     that kind of thing yet!
  91.  
  92. *** FORMATS SUPPORTED: ----------------------------------------------------
  93.  
  94.     Origin            Type                    Typical Extension
  95.    ----------------- ----------------------- -------------------
  96.     Amiga             SoundTracker            MOD, NST
  97.                       NoiseTracker            MOD, NST
  98.                       ProTracker              MOD, NST
  99.  
  100.                       Oktalyzer               OKT?
  101.                       MED                     MED
  102.                           I've never seen an Oktalyzer or MED player for
  103.                           the PC, and I can't seem to find the titles of
  104.                           MED songs!
  105.  
  106.     Mr. H             FastTracker 6 channel   MOD
  107.                       FastTracker 8 channel   MOD
  108.  
  109.     AJGG Graveland    OctaCompositor          OCT
  110.  
  111.     Sami Tammilehto   ScreamTracker Module    STM
  112.                       ScreamTracker Song      STS
  113.  
  114.     Tran              Composer 669            669
  115.  
  116.     Thanks to Mr. H. for the info in FastTracker's help screens which
  117.     helped me to identify the ST/NT/PT/FT and OctaCompositor formats, and
  118.     to Sami Tammilehto and Tran who documented their formats so well.
  119.  
  120. *** ABOUT THE AUTHOR: -----------------------------------------------------
  121.  
  122.     Totally Unlimited is my little company name. You can't have it.
  123.     Stamped it! Whenever I write something I think someone else would like,
  124.     I release it under this name.
  125.  
  126.     Questions or comments about MODDIR can be directed to me by paper mail!
  127.     What do you expect for freeware? An Internet address?
  128.  
  129.     Here's my geographical address:
  130.  
  131.         Tom Rathborne
  132.         132 Leland Rd.
  133.         London, Ontario
  134.         N6K 1T3
  135.         CANADA
  136.  
  137.     Ok, you can probably track me down somewhere electronically. Address
  138.     any messages to "Tommy Rathborne" - my name macro hasn't changed in
  139.     years!
  140.  
  141.     I try not to call long distance too often or for too long, so look
  142.     around here:
  143.  
  144.         NANet, IntelecNet:
  145.             Star Trek conferences would be your best bet! I lurk. :)
  146.  
  147. *** OTHER STUFF: ----------------------------------------------------------
  148.  
  149.     MODDIR's sibling program, MODNAMES, is for 4DOS/NDOS users. It creates
  150.     a DESCRIPT.ION file containing the titles and types of all modules in a
  151.     directory.
  152.  
  153.     MODDIR was created and compiled with Borland C++ 3.1.
  154.  
  155. *** HISTORY: --------------------------------------------------------------
  156.  
  157.     v1.0 - 1993.05.26 - Initial release!
  158.  
  159.     v1.2 - 1993.06.16 - Added totals at the bottom.
  160.  
  161.     v2.0 - 1993.06.25 - Added module type detection/display.
  162.                       - Eliminated Null Pointer Assignment error!
  163.