home *** CD-ROM | disk | FTP | other *** search
/ Audio Plus 10-94 / AUDIOPLUS.ISO / msdos / modplay / modman15 / modman.doc < prev    next >
Text File  |  1993-09-24  |  32KB  |  725 lines

  1. ▀▀█▀▀ ▄▀▀▄ ▀▀█▀▀ ▄▀▀▄ █   █  █ █     █  █ █▄  █ █   █ █▄ ▄█ █ ▀▀█▀▀ █▀▀ █▀▀▄
  2.   █   █  █   █   █▀▀█ █   █   █      █  █ █ ▀▄█ █   █ █ ▀ █ █   █   █▀  █  █
  3.   ▀    ▀▀    ▀   ▀  ▀ ▀▀▀ ▀▀▀ ▀       ▀▀  ▀   ▀ ▀▀▀ ▀ ▀   ▀ ▀   ▀   ▀▀▀ ▀▀▀
  4. ███      ███   ▄███████▄   █████████▄   ███      ███  ▄███████▄  ███     ███
  5. ███▌    ▐███  ███████████  ███████████  ███▌    ▐███ ▐█████████▌ ███▌    ███
  6. ████    ████ ▐███▀   ▀███▌ ███    ▀███▌ ████    ████ ███▌   ▐███ ████    ███
  7. ████▌  ▐████ ███▌     ▐███ ███     ▐███ ████▌  ▐████ ███     ███ ████▌   ███
  8. █████  █████ ███       ███ ███      ███ █████  █████ ███     ███ █████   ███
  9. █████▌▐█████ ███       ███ ███      ███ █████▌▐█████ ███▄▄▄▄▄███ █████▌  ███
  10. ████████████ ███       ███ ███      ███ ████████████ ███████████ ██████  ███
  11. ███▐████▌███ ███       ███ ███      ███ ███▐████▌███ ███▀▀▀▀▀███ ██████▌ ███
  12. ███ ████ ███ ███       ███ ███      ███ ███ ████ ███ ███     ███ ███▐███ ███
  13. ███ ▐██▌ ███ ███       ███ ███      ███ ███ ▐██▌ ███ ███     ███ ███ ███▌███
  14. ███  ██  ███ ███       ███ ███      ███ ███  ██  ███ ███     ███ ███ ▐██████
  15. ███  ▐▌  ███ ███       ███ ███      ███ ███  ▐▌  ███ ███     ███ ███  ██████
  16. ███      ███ ███       ███ ███      ███ ███      ███ ███     ███ ███  ▐█████
  17. ███      ███ ███       ███ ███      ███ ███      ███ ███     ███ ███   █████
  18. ███      ███ ███▌     ▐███ ███     ▐███ ███      ███ ███     ███ ███   ▐████
  19. ███      ███ ▐███▄   ▄███▌ ███    ▄███▌ ███      ███ ███     ███ ███    ████
  20. ███      ███  ███████████  ███████████  ███      ███ ███     ███ ███    ▐███
  21. ███      ███   ▀███████▀   █████████▀   ███      ███ ███     ███ ███     ███
  22.  
  23.   ░░▒▒▓▓████████     T O T A L L Y   U N L I M I T E D     ░░▒▒▓▓████████
  24.  
  25.   ▓▓████  ██████       *   M O D M A N   v 1 . 5   *       ▓▓████  ██████
  26.       ██  ██                                                   ██  ██
  27.   ██  ██  ██  ██              (c) 1993.09.24               ██  ██  ██  ██
  28.   ██  ██  ██  ██                                           ██  ██  ██  ██
  29.   ██  ██████  ▓▓   by Tom Rathborne of Totally Unlimited   ██  ██████  ▓▓
  30.   ██          ▒▒                                           ██          ▒▒
  31.   ████████▓▓▒▒░░            MODMAN is Freeware!            ████████▓▓▒▒░░
  32.          ^                                                       ^
  33.          │    (but if you like it, you can still send money!)    │
  34.          │                                                       │
  35.          └────── My neat logo encompassing the T and the U ──────┘
  36.  
  37.                 Portions (C) Copyright 1992-1993 Andy Hakim
  38.  
  39.   ┌──────────╖
  40. ──┤ CONTENTS ╟─────────────────────────────────────────────────────────────
  41.   ╘══════════╝
  42.  
  43.         ABOUT MODMAN
  44.  
  45.         USING MODMAN
  46.         THE CONFIGURATION FILE
  47.  
  48.         FORMATS SUPPORTED
  49.  
  50.         ABOUT THE AUTHOR
  51.         OTHER STUFF
  52.         THANKS
  53.         FUTURE FEATURES
  54.         HISTORY
  55.  
  56.   ┌──────────────╖
  57. ──┤ ABOUT MODMAN ╟─────────────────────────────────────────────────────────
  58.   ╘══════════════╝
  59.  
  60.     MODMAN is a great program. I'm really proud of it. Believe me, you have
  61.     to try it! I use it all the time to make cassette tapes of my module
  62.     collection! Since it's freeware, it doesn't benefit me one bit if you
  63.     use it.
  64.  
  65.     * Send me your ideas and I'll do my best to put them into MODMAN! *
  66.  
  67.     On the PC scene, there are tons of different formats of .MOD (Module)
  68.     music files. Along with these formats are a whole bunch of players.
  69.     Some players can play only a few module formats, some can play many.
  70.     Some modules can be played by most players, some can only be played by
  71.     one or two. MODMAN allows you to quickly and easily select from a
  72.     directory of modules, associating each module with a player that
  73.     supports it. Then it makes a batch file and plays your selections.
  74.  
  75.     I've tried quite a few other mod-selection programs. MODShell is okay.
  76.     DMPShell is very good, but I wasn't satisifed. I think MODMAN blows all
  77.     of them away. I know you'll agree.
  78.  
  79.     Configuring MODMAN is a little complicated. I have included lots of
  80.     sample configurations for you to fiddle with. Basically, it's all set
  81.     up in the sample MODMAN.CFG - you just have to remove the players that
  82.     you don't have!
  83.  
  84.     MODMAN takes up exactly 0k of RAM while playing MODs! A batch file runs
  85.     MODMAN, which creates a temporary batch when you have selected your
  86.     modules. Then the first batch file runs the temporary batch file which
  87.     plays your MODs. This leaves the most RAM free to your players.
  88.  
  89.     Although MODMAN takes up 0k of RAM while playing, yes that's right NO
  90.     RAM, the memory requirements of MODMAN (while running ) will vary
  91.     depending on the number of MODs you have in one directory. The maximum
  92.     number that MODMAN will read in one directory is 1024. If anyone has
  93.     more than that in one directory, let me know and I can tell you to make
  94.     some subdirectories. I don't anticipate any memory allocation errors.
  95.  
  96.     MODMAN is, of course, freeware! That means you can copy MODMAN all you
  97.     want, as long as you don't modify it, and you include these files:
  98.  
  99.     MM.BAT
  100.     MODMAN.CFG
  101.     MODMAN.DOC
  102.     MODMAN.EXE
  103.     FILE_ID.DIZ (Please make sure that this description gets into the
  104.                  BBS file listing if you upload MODMAN to a BBS.)
  105.  
  106.     Support freeware by using and distributing it! Of course, if you have
  107.     any questions or comments, or if you think MODMAN is worth a few $,
  108.     [especially if you want to send money... :-)] please contact me.
  109.  
  110.   ┌──────────────╖
  111. ──┤ USING MODMAN ╟─────────────────────────────────────────────────────────
  112.   ╘══════════════╝
  113.  
  114.                     DON'T RUN MODMAN.EXE - RUN MM.BAT!
  115.                         MODMAN requires a VGA card.
  116.  
  117.     MM.BAT runs MODMAN and then plays any modules that were selected. Don't
  118.     run MODMAN.EXE by itself.
  119.  
  120.                               *** ESC TO EXIT ***
  121.                               *** F1 FOR HELP ***
  122.  
  123.     As of version 1.3, MODMAN uses a custom font, and does various neat
  124.     things to your VGA card. Everything should go back to normal when it
  125.     exits. If anything DOESN'T go back to normal, please let me know.
  126.  
  127.     When you exit MODMAN, it will leave you in 50-line mode if that's the
  128.     mode you started in, but if you started in anything less than that,
  129.     then you will be returned to 25-line mode. Feel free to edit MM.BAT to
  130.     do whatever you want to your sound or video options. Make sure you keep
  131.     a copy of the original just in case you make a mistake!
  132.  
  133.     MODMAN is simple to use. All keys are listed on the right of the
  134.     screen, and a more detailed keyboard reference is available by pressing
  135.     F1 then F2. Here's a sample of the important part of the screen...
  136.  
  137.     [ A "B" to the left of a line means that line has a blue background.
  138.       An "R" to left means that line has a red background. Remember that
  139.       a red and blue background makes magenta.                            ]
  140.  
  141.     ══════════════╦════════════════════════════════════════════════════════
  142.      Directory ═> ║ C:\MODS
  143.     ══════════════╬══════════════════════╤═══════════════════════════╤═════
  144.      Module file  ║ Module Title         │ Module Format             │Seq.#
  145.     ──────────────╫──────────────────────┼───────────────────────────┼─────
  146. B    MOONSNTA.669 ║ Moonlight Sonata...  │ Composer 669 Module       │  1
  147. B    CANONMIX.AMF ║ Johann Pachelbel     │ Advanced Module Format    │  3
  148. BR   GONADSCR.MOD ║ Gonads Cracks        │ ProTracker                │  2
  149.      PLASTIC .S3M ║ World of plastic     │ Scream Tracker 3 Module   │
  150.     ══════════════╬══════════════════════╧═══════════════╤═══════╤═══╪═════
  151.      Player file  ║ Player Name & Description            │Version│OK?│Used#
  152.     ──────────────╫──────────────────────────────────────┼───────┼───┼─────
  153.  R   DMP     .EXE ║ Dual Module Player                   │ 2.60ß │ √ │  2
  154. B    WOWII   .EXE ║ WOW ][ Module player                 │ 1.31  │ √ │  1
  155.      MP      .COM ║ ModPlay Pro                          │ 2.19b │ √ │
  156.     ══════════════╩══════════════════════════════════════╧═══════╧═══╧═════
  157.  
  158.     In this example, the first three modules are marked.
  159.     - indicated by blue background
  160.  
  161.     First is MOONSNTA.669, then GONADSCR.MOD, then CANONMIX.AMF.
  162.     - indicated by numbers in Seq.# column
  163.  
  164.     GONADSCR.MOD is the currently selected file.
  165.     - indicated by red background
  166.  
  167.     GONADSCR.MOD can be played by any of the three players
  168.     - indicated by three checkmarks in OK? column
  169.  
  170.     GONADSCR.MOD is scheduled to be played by WOW][.
  171.     - indicated by blue backround on WOW][
  172.  
  173.     If you press space once here, GONADSCR.MOD will be unmarked (deleted
  174.     from the sequence, loses blue background) and the red bar will move
  175.     down to PLASTIC.S3M. If you press space again, PLASTIC.S3M will be
  176.     marked, using DMP.
  177.  
  178.     At the very top you see the Directory. This is the current directory of
  179.     modules that is being displayed.
  180.  
  181.     Below that is the list of Modules. The filename, title, and format are
  182.     displayed. If a file in the current directory cannot be identified,
  183.     or if there is no player in the configuration file that can play it,
  184.     then it will not appear in the list. The "Seq.#" column shows the
  185.     number of that module in the sequence. This column will be blank if the
  186.     module has not been selected.
  187.  
  188.     At the bottom of the screen is the list of Players. The player file
  189.     (BAT EXE or COM), description, and version are displyed. These are read
  190.     from the MODMAN.CFG file. See THE CONFIGURATION FILE for more information
  191.     on this file. The "OK?" column will have a checkmark if the selected
  192.     module can be played with that player. This information is also
  193.     contained in the configuration file. The "Used#" column shows how many
  194.     times the player has been used in the sequence.
  195.  
  196.     It's all very intuitive (I hope!), so just run the program and press:
  197.     F1 then one of: F2/space/PgDn/2 for help on the keys. If anyone tells
  198.     me that it doesn't make sense, I will write some better docs for this
  199.     part. Even better, YOU write the docs and send them to me.
  200.  
  201.     Please refer to the third page of help for the mouse features.
  202.  
  203.   ┌────────────────────────╖
  204. ──┤ THE CONFIGURATION FILE ╟───────────────────────────────────────────────
  205.   ╘════════════════════════╝
  206.  
  207.     The configuration file for MODMAN is called MODMAN.CFG. To find this
  208.     file, MODMAN first checks for an environment variable called MODMANCFG.
  209.     This environment variable should NOT include "MODMAN.CFG".
  210.  
  211.     RIGHT: "SET MODMANCFG=C:\MODS"
  212.     RIGHT: "SET MODMANCFG=C:\MODS\"
  213.  
  214.     WRONG: "SET MODMANCFG=C:\MODS\MODMAN.CFG"
  215.  
  216.     If you want to save environment space, simply put a SET command for
  217.     MODMANCFG before MODMAN in MM.BAT, then put a "SET MODMANCFG=" after
  218.     MODMAN to remove it. Then all you have to be sure of is that MM.BAT is
  219.     in the path.
  220.  
  221.     If there is no MODMANCFG environment variable, MODMAN checks the
  222.     current directory, then all the directories in the PATH environment
  223.     variable.
  224.  
  225.     As for the MODMAN.CFG file itself, put a line with just
  226.     "[MODMANCONFIG]" on it, then the number of players, then the default
  227.     player to use, then a line with just "***", and then the info for the
  228.     first player, etc.
  229.  
  230.     Here's an example of a very simple MODMAN.CFG file, configured for just
  231.     DMP:
  232.  
  233. [MODMANCONFIG]
  234. 1
  235. 1
  236. ***
  237. Dual Module Player
  238. 2.60ß
  239. DMP.EXE
  240. @
  241. 1 2 3 4 5 6 7 8 9 11 12 14 15
  242.  
  243.     The sample MODMAN.CFG file included with MODMAN has all the information
  244.     you need to configure MODMAN! In case you lost it, here's the
  245.     information from MODMAN.CFG:
  246.  
  247. ───────────────────────────────────────────────────────────────────────────
  248.  
  249.     Anything before the line that starts with [MODMANCONFIG] is a comment.
  250.     After that, you have to follow the config format strictly. Putting a ~
  251.     on a line will make MODMAN ignore everything after it. To comment out a
  252.     whole line, the first character must be a ~.
  253.  
  254.     Any lines after [MODMANCONFIG] that do not belong will cause errors if
  255.     they do not start with a ~. This means that you can't have any blank
  256.     lines. If you want to add space to make the file more readable, just
  257.     add a few lines with a ~ and nothing else on them.
  258.  
  259. *** CONFIG FILE FORMAT
  260.  
  261. Starting after [MODMANCONFIG] line:
  262.     line 1: number of players - up to 39
  263.     line 2: default player to use on startup. If you use a number larger
  264.             than the number of players, the default will be 1.
  265.  
  266. Then the player records:
  267.     There must be *at least* as many player records as the number of
  268.     players specified on the first line. If the file ends too early, you'll
  269.     get an error message. If there are more players in the file than you
  270.     have specified, the ones at the end just won't be shown.
  271.  
  272.     line 1: '***'
  273.     line 2: Description of player    - up to 36 characters
  274.     line 3: Version of player        - up to  5 characters
  275.     line 4: Command (EXE/COM/BAT)    - up to 80 characters
  276.                 The first 13 characters up to the first space character
  277.                 will be displayed on the screen, split at the '.'.
  278.                     i.e. "DMP.EXE -s22050"
  279.                     Will appear as "DMP     .EXE" on the screen
  280.                     And in a batch file: "DMP.EXE -s22050 @MM0.LST"
  281.  
  282.     line 5: Maximum number of MODs on one command line
  283.                 If a player is used more than once in a row in the
  284.                 sequence, the batch file will pass (at most) this number of
  285.                 mods all on one command line. Use @ or 0 to tell MODMAN to
  286.                 generate a @listfile instead. It will be passed like this:
  287.                 "[info on line 4] @MM0.LST"
  288.  
  289.     line 6: Module formats supported - up to 80 characters
  290.  
  291.             Here's what each number means:
  292.  
  293.                NOTE THAT THE NUMBERS WERE ALL CHANGED AROUND BETWEEN
  294.                VERSION 1.1 and 1.2! Sorry for the inconvenience, but it was
  295.                for the best, believe me...
  296.  
  297.                (* = supported by most players)
  298.  
  299.           * 1  SoundTracker - 15 instruments
  300.           * 2  ProTracker
  301.           * 3  ProTracker with more than 64 patterns
  302.           * 4  Tracker - ModEdit
  303.           * 5  Tracker - KingMOD
  304.           * 6  StarTrekker - 4 channels
  305.             7  StarTrekker - 8 channels
  306.             8  FastTracker - 6 channels
  307.             9  FastTracker - 8 channels
  308.             10 OctaCompositor 8 channels
  309.             11 Scream Tracker 3 Module
  310.             12 ScreamTracker Module
  311.             13 ScreamTracker Song
  312.             14 Composer 669 module
  313.             15 Advanced Module Format
  314.             16 Oktalyzer
  315.             17 UltraTracker Module
  316.             18 Future Composer [FC14]
  317.             19 Future Composer [SMOD]
  318.             20 MED file
  319.             21 Some sort of MED file
  320.             22 OctaMED file
  321.             23 SMUS v.2 Module
  322.             24 Face the Music format
  323.             25 StarTrekker - 6 channels
  324.             26 Audiovision/ROM
  325.  
  326.   ┌───────────────────╖
  327. ──┤ FORMATS SUPPORTED ╟────────────────────────────────────────────────────
  328.   ╘═══════════════════╝
  329.                                                             Typical
  330.     Author Origin             PC?  Type / Program           Extension
  331.    ┌────────────────────────┐ ┌─┐ ┌──────────────────────┐ ┌─────────┐
  332.     Standard Amiga Trackers    *   15-channel SoundTracker  MOD, NST
  333.  
  334.     Mahoney & Kaktus           *   ProTracker               MOD, NST
  335.                                *   ProTracker 64+ pattern   MOD, NST
  336.  
  337.     Maxon Computer GmbH            Face the Music (Amiga)   FTM
  338.  
  339.     Various other Trackers     *   StarTrekker 4 channel    MOD, NST
  340.                                    StarTrekker 6 channel    MOD, NST
  341.                                *   StarTrekker 8 channel    MOD, NST
  342.                                *   Oktalyzer                OKT
  343.                                    MED [two flavours]       MED
  344.                                    OctaMED                  OCT
  345.                                    FutureComposer [FC14]    FC3
  346.                                    FutureComposer [SMOD]    FC3
  347.                                    SMUS module              MUS
  348.  
  349.     Fredrik Huss               *   FastTracker 6 channel    MOD, 6CM
  350.     (Mr. H/Triton)             *   FastTracker 8 channel    MOD, 8CM
  351.  
  352.     AJGG Graveland             *   OctaCompositor           OCT
  353.  
  354.     Sami Tammilehto            *   ScreamTracker Module     STM
  355.     (Psi/Future Crew)          *   ScreamTracker Song       STS
  356.                                *   ScreamTracker 3 Module   S3M
  357.  
  358.     Tomasz Pytel               *   Composer 669             669
  359.     (Tran/Renaissance)
  360.  
  361.     Otto Chrons                *   Advanced Module Format   AMF
  362.  
  363.     Marc André Schallehn       *   UltraTracker (for GUS)   ULT
  364.  
  365.     Christopher E. Kingsbury   *   Edited by KingMod        MOD
  366.  
  367.     Norman Lin                 *   Edited by ModEdit        MOD
  368.  
  369.     Brian Czapiga (PiXeLiTe)   *   AudioVision/ROM          ROM
  370.    └────────────────────────┘ └─┘ └──────────────────────┘ └─────────┘
  371.  
  372.     The types marked with a "*" in the list can be played by at least one
  373.     PC player. Note that the KingMod and ModEdit files are standard
  374.     ProTracker modules. They should be supported by any standard ProTracker
  375.     player.
  376.  
  377.     You only get the first 20 characters of the title in Composer 669 and
  378.     MED/OctaMED songs.
  379.  
  380.     I can't seem to find any FutureComposer modules with titles so I'm not
  381.     sure where to find the titles. I have the same problem with many MED
  382.     types. "Unknown:[filename]" appears as the title in these cases. In
  383.     the case of ROM files, there actually is no title in the file.
  384.  
  385.     If the file has the correct signature, but the title includes control
  386.     characters (less than ASCII 27), the title will appear as "[ Might be
  387.     corrupt ]"
  388.  
  389.   ┌──────────────────╖
  390. ──┤ ABOUT THE AUTHOR ╟─────────────────────────────────────────────────────
  391.   ╘══════════════════╝
  392.  
  393.     Totally Unlimited is my (and a friend's - Chris Wright - but he can't
  394.     program his way out of a wet paper bag [Sorry Chris! :-) ]) little
  395.     company name. You can't have it. Stamped it! Whenever I write something
  396.     I think someone else would like, I release it under this name.
  397.  
  398.     I'm a first year co-op Math student at the University of Waterloo.
  399.     If you want to offer me a co-op job, I'd be glad to have the job-search
  400.     process simplified for me. :-)
  401.  
  402.     I don't have a PC yet in my room at University, so you shouldn't expect
  403.     too many versions in the next five years! I will only buy a computer
  404.     when I can get the very best machine on the market... perhaps a PowerPC
  405.     running Linux!
  406.  
  407.     You can contact me via Internet mail, Paper mail, or Telephone!
  408.  
  409.     I appreciate:
  410.  
  411.         Bug reports
  412.         Information on more file formats
  413.         Suggestions
  414.         Comments
  415.  
  416. *** Internet email address:
  417.  
  418.         twrathbo@undergrad.math.uwaterloo.ca
  419.  
  420.     Use finger/mail/talk!
  421.  
  422.     I will be uploading MODMAN/MODUTILS to various FTP sites. I may also
  423.     put info on my programs on the University of Waterloo Gopher server.
  424.     Finger or email me for information on the latest versions, FTP sites,
  425.     Gopher info, etc. I normally reply to my mail immediately, so if I'm
  426.     online when the mail comes in, you just might receive a reply within
  427.     the hour! If you finger me and I'm online, feel free to request a
  428.     "talk" session!
  429.  
  430. *** Geographical address:
  431.  
  432.         Tom Rathborne
  433.         132 Leland Rd.
  434.         London, Ontario
  435.         N6K 1T3
  436.         CANADA
  437.  
  438.     This is my home address. Any mail sent to me here will find its way to
  439.     me wherever I am!
  440.  
  441. ***  Phone:
  442.  
  443.         (519) 725-9783
  444.  
  445.     This is my telephone number at the University of Waterloo. Try calling
  446.     between 10pm and 12pm EST. I have voicemail and a roommate so leave a
  447.     message if I am not around and I'll call you back (but maybe only for a
  448.     short time if it's a very long distance call!)
  449.  
  450. *** Other:
  451.  
  452.     You can probably track me down somewhere else electronically. Address
  453.     any messages to "Tommy Rathborne" - my name macro hasn't changed in
  454.     years! As for big boards, try The Sound Barrier in New York. The 14.4k
  455.     DS number there is (718) 979-6629. I don't call there often anymore,
  456.     though.
  457.  
  458.   ┌─────────────╖
  459. ──┤ OTHER STUFF ╟──────────────────────────────────────────────────────────
  460.   ╘═════════════╝
  461.  
  462. *** Technical details
  463.  
  464.     MODMAN was created and compiled with Borland C++ 3.1, using the Compact
  465.     memory model, and lots of inline assembler for the video. There
  466.     shouldn't be any memory allocation errors. Source code is not currently
  467.     available. Sorry.
  468.  
  469. *** The Smooth Mouse Driver
  470.  
  471.     Because MODMAN is freeware, the Smooth Mouse Driver (SMD) libraries
  472.     were supplied to me by Andy Hakim, *free of charge*, through Eric
  473.     Coolman. Thanks Andy!
  474.  
  475.     Here's some info on the libraries, and how to contact Andy, straight
  476.     from his documentation:
  477.  
  478.     The SMD library provides a bitmapped graphics-style mouse cursor in
  479.     ega/vga text modes. It is implemented as an extension to the regular
  480.     Microsoft mouse driver. The programmer has the convienience of using
  481.     all interrupt 33h based mouse function calls while utilizing the new
  482.     mouse cursor.
  483.  
  484.                      │
  485.              US Mail │ Andy Hakim
  486.                      │ 816 Pecore Street
  487.                      │ Houston, TX 77009-6034
  488.                      │ U.S.A.
  489.                      │
  490.            Telephone │ +1 713-880-3059
  491.                      │
  492.             Internet │ ahakim@uh.edu
  493.        DECnet/THEnet │ uhou::ahakim
  494.                      │
  495.       CompuServe and │ Send a message to the Internet address listed
  496.             MCI Mail │ above.
  497.                      │
  498.             FTP site │ karazm.math.uh.edu (129.7.128.1)
  499.            directory │ /pub/Incoming/PP/
  500.                      │ Use login name "anonymous" and give your email 
  501.                      │ address for the password.
  502.                      │
  503.       Bulletin Board │ Sands BBS          
  504.                      │ +1 713-961-1604
  505.                      │ 2400 through 16800 baud, HST/v.32bis
  506.                      │ Use login name "precise point" and "mouse" for
  507.                      │ the password.  To send Andy a message, address it
  508.                      │ to "Andy Hakim"
  509.                      │
  510.  
  511. *** MODUTILS - My other Module-related programs:
  512.  
  513.     The three MODUTILS will list directories describing modules with titles
  514.     and formats. MODDIR works like a very simple DIR command, MODNAMES
  515.     creates a 4DOS/NDOS DESCRIPT.ION file, and MODDIZ creates a FILE_ID.DIZ
  516.     for SysOps.
  517.  
  518.     Look for TUMODU34.ZIP on your local BBS - it will be released at the
  519.     same time as MODMAN 1.5!
  520.  
  521. *** The Mysteries:
  522.  
  523.     Answer these questions for me, and get your name in the thanks section!
  524.  
  525.     1. Where can I find the title in FutureComposer and MED modules?
  526.  
  527.     2. How can I identify 15-instrument files better?
  528.        (right now I look for one single character in a certain position,
  529.         which means that any file that happens to have that character there
  530.         will be identified as a 15-instrument format file!)
  531.  
  532.     3. What makes a WOW file unique? I can't figure out how to tell them
  533.        apart from normal MODs! In fact, the MODUTILS recognize WOW files as
  534.        normal MODs.
  535.  
  536.   ┌────────╖
  537. ──┤ THANKS ╟───────────────────────────────────────────────────────────────
  538.   ╘════════╝
  539.  
  540. Format thanks:
  541.  
  542. ... to Fredrik Huss (Mr. H/Triton) for the information in the help text of
  543.     FastTracker 1.1 which helped me to identify the SoundTracker,
  544.     NoiseTracker, ProTracker, FastTracker, StarTrekker, and
  545.     OctaCompositor formats.
  546.  
  547. ... to Edward Schlunder in the FidoNet QB conference for the info on
  548.     ProTracker & StarTrekker and ProTracker modules with more than 64
  549.     patterns.
  550.  
  551. ... to Mark Phipps (Rittmeister RedOctober/Starry Knights) for sending the
  552.     info from Edward Schlunder to me.
  553.  
  554. ... to Sami Tammilehto (Psi/Future Crew) who documented the ScreamTracker 2
  555.     format so well. Please release ScreamTracker ]I[!  Nobody cares if it's
  556.     finished or not!
  557.  
  558. ... to Tomasz Pytel (Tran/Renaissance) who documented the Composer 669
  559.     format so well.
  560.  
  561. ... to Draeden/VLA for MODINFO.DOC and the accompanying ASM files that let
  562.     me know that I had been doing everything right all along!
  563.  
  564. Idea thanks:
  565.  
  566. ... to Eric Coolman for -
  567.     - letting me know about his MODs that weren't being identified
  568.     - reminding me to add AMF recognition
  569.     - calling to tell me that I forgot MODMAN.CFG in V1.0!
  570.     - asking for a return to 25-line mode when exiting MODMAN
  571.     - giving me the font-changing code
  572.       That code is REALLY USEFUL! Thanks Eric!
  573.       (This means I will probably NEVER support 25-line mode now!)
  574.     - doing the file x-fer thing with Andy Hakim.
  575.  
  576. ... to Mark Eramian for suggesting that MODMAN restart itself after
  577.     playing, and also because I found out about a *very* silly bug while
  578.     trying MODMAN on his computer!
  579.  
  580. A long series of thanks:
  581.  
  582. ... to Toni Nikkanen for the info in the DMPShell documentation about
  583.     borrowing the 50-line video mode code from NNANSI.SYS
  584.  
  585. ... to Tom Almy for having the 50-line VGA mode code in NNANSI.SYS
  586.  
  587. ... to Daniel Kegel for allowing Tom Almy to use NANSI.SYS as a beginning
  588.     for NNANSI.SYS
  589.  
  590. ... to whoever wrote the standard ANSI.SYS for making it so badly that
  591.     Daniel Kegel wanted to improve on it!
  592.  
  593. ... to whoever left ANSI support out of the DOS kernel so that ANSI.SYS was
  594.     required!
  595.  
  596. And a big THANKS to Andy Hakim for SMD. See the OTHER STUFF section for
  597. more information on this fine product!
  598.  
  599.   ┌─────────────────╖
  600. ──┤ FUTURE FEATURES ╟──────────────────────────────────────────────────────
  601.   ╘═════════════════╝
  602.  
  603.     Features that are constantly being updated:
  604.  
  605.       - More MOD formats recognized
  606.       - Even more detailed docs and help screens
  607.       - Tight, fast code (not that anybody notices!)
  608.       - Any suggestions I get
  609.  
  610.     The future features below are listed in order of priority:
  611.  
  612.       - File copy/move/delete
  613.       - Save/load "album" type files
  614.         (so that the sequence can be restored upon return to MODMAN.)
  615.       - Edit module titles
  616.       - Sort module directory by filename/title/size/format/sequence
  617.  
  618.     Don't hold your breath for these ones:
  619.  
  620.       - Archive (ZIP/LHA/ARJ etc.) support
  621.       - Cross-directory selection
  622.       - Directory tree display for change directory
  623.       - 25-line text mode support
  624.  
  625.   ┌─────────╖
  626. ──┤ HISTORY ╟──────────────────────────────────────────────────────────────
  627.   ╘═════════╝
  628.  
  629. v0.5 - 1993.07.22 - Project started
  630.  
  631. v1.0 - 1993.08.05 - Initial release
  632.  
  633. v1.1 - 1993.08.06 - Boy do I feel stupid!
  634.                     - MODMAN.CFG is now included in the archive.
  635.  
  636.                   - New players in sample config:
  637.                     - JM ProTracker 5.1
  638.                     - DarkTracker 2.01
  639.                     - PowerPlayer 1.30
  640.  
  641. v1.2 - 1993.08.20 - New and improved features:
  642.                     - 0 or @ for "maximum of files on one command line"
  643.                       in MODMAN.CFG will make @listfile instead.
  644.                     - Up to 80 characters in config file command line.
  645.                       Batch files no longer required for most players!
  646.                     - * now selects only those mods which can be played
  647.                       using the selected player.
  648.  
  649.                   - Avoiding potential problems:
  650.                     - Temporary batch file constantly changes back to
  651.                       previous "current" directory throughout the batch
  652.                       file in case you shell to DOS while playing and
  653.                       forget to change back to the MOD directory.
  654.                     - Maximum number of modules reduced from 1536 to 1024.
  655.                       Nobody who is even remotely sane has more than 1024
  656.                       modules in one directory. This will ensure that even
  657.                       if you DO have more than 1024 modules in one
  658.                       directory, you will not be able to go over the limit
  659.                       of 1024 in a DMP @listfile!
  660.                     - MM.BAT Checks ERRORLEVEL (255=success, else error #)
  661.  
  662.                   - Cosmetic fixes:
  663.                     - Exciting scrollable help screen added.
  664.                     - Main screen quick-help bar improved.
  665.                     - Filenames now "split" at the '.' Filename left
  666.                       justified, extension right justified.
  667.                     - Switches back to 25-line mode upon exit if you start
  668.                       in less-than-50-line mode, otherwise doesn't change
  669.                       anything.
  670.  
  671.                   - New format recognitions:
  672.                     - ProTracker with > 64 channels
  673.                     - StarTrekker 4 channels
  674.                     - StarTrekker 8 channels
  675.                     - ModEdit
  676.  
  677.                   - Sample configuration changes:
  678.                     - No more batch files!
  679.                     - Format numbers changed - you'll have to reconfigure!
  680.  
  681.                   - Bug fixes:
  682.                     - MODMAN.CFG files with no CR or LF at end of last line
  683.                       now read properly.
  684.                     - Stays in same directory instead of exiting with error
  685.                       if you try to change to a directory containing no
  686.                       playable modules.
  687.  
  688. v1.3 - 1993.08.26 - New and improved features:
  689.                     - Search by filename with small letters
  690.                     - Search by title with capital letters
  691.                     - Dir, Random and Clear changed to Alt+D, R & C
  692.                     - Directory history added (a bit buggy but it works!)
  693.  
  694.                   - Cosmetic fixes:
  695.                     - Spiffy custom font (code courtesy of Eric Coolman)
  696.                     - Extremely 3-dimensional-looking help screens
  697.                     - Main screen quick-help bar expanded
  698.                     - Palette flashes at beginning and end of run
  699.                     - DMP fonts no longer included - I'm wondering if I
  700.                       should integrate them somehow...
  701.  
  702.                   - New format recognition:
  703.                     - StarTrekker 6 channels
  704.  
  705. v1.4 - 1993.09.01 - New and improved features:
  706.                     - Mouse support! See third help page in the program.
  707.                       Also refer to OTHER STUFF section for information on
  708.                       the SMD kit.
  709.  
  710.                   - Cosmetic fixes:
  711.                     - Even spiffier custom font
  712.                     - Overscan (border colour) restored on exit
  713.  
  714.                   - New format recognition:
  715.                     - AudioVision ROM file
  716.  
  717.                   - New player in sample config:
  718.                 - AudioVision ROM Player
  719.  
  720. v1.5 - 1993.09.25 - No new features, I just put my Internet address in this
  721.                     MODMAN.DOC file, the online help, and the FILE_ID.DIZ.
  722.                     See ABOUT THE AUTHOR for more info.
  723.  
  724. ───────────────────────────────────────────────────────────────────────────
  725.