home *** CD-ROM | disk | FTP | other *** search
/ WADS of WADS / WadsOfWads.1994.zip / UNSORTED / WM.ZIP / WM.DOC next >
Text File  |  1994-06-21  |  8KB  |  214 lines
  1. wm
  2.  
  3. wm is another wad organizer and doom launcher.
  4.  
  5. It features:
  6.  
  7.       Launch wads on what ever episode and level you prefer.
  8.  
  9.       Leaves a very small footprint in memory, so you can load your
  10.         huge disk cache in the lower 640K (a good idea, I might add.)
  11.  
  12.       Make your own episodes *on the fly*!
  13.  
  14.       Add comments, delete wads, give `em long names.
  15.  
  16.       Run any executable you wish! (doom, sersetup, etc.)
  17.  
  18.       Number of wads you can index is limited to disk space and
  19.          memory available.
  20.  
  21.       wm shows all sorts of info- which levels are present in the
  22.          wad, what music it replaces, whether it has a built-in demo,
  23.          an lmp, or text file.
  24.  
  25.       View text files directly from wm.
  26.  
  27.       Provides easy access to the most popular DOOM parameters.
  28.  
  29.       Lets you provide any parameters you wish.  So, you can use
  30.          sersetup with -com2 and any other paramters you want.
  31.  
  32.       Specify DOOM's config file.
  33.  
  34.       Delete wads (both from the internal list, and from disk).
  35.  
  36.       Easy-to-use input boxes let you use the arrow keys, control keys,
  37.          and other special keys.
  38.  
  39.       On-line help is available (heh.)
  40.  
  41.       Very little documentation!
  42.  
  43.       No telephone support.
  44.  
  45.       A colorful screen interface.
  46.  
  47.       Completely customizable to your drives and directory setup.
  48.  
  49.       umm....
  50.  
  51.       Its in English.
  52.  
  53.       It only works with the registered version of DOOM.  (Register)
  54.  
  55.       umm....
  56.  
  57.       Its FREE FREE FREE FREE FREE.
  58.  
  59.  
  60.  
  61. A SIMPLE TUTORIAL:
  62.  
  63. Before you start, have a look at the wm.ini file.  Make sure
  64. that, at the least, the doomdrive and doomroot settings are
  65. correct.  You might also like to change the other defaults.
  66. Type "wm -?" to get a look at what sort of command line parameters
  67. are available [See COMMAND LINE PARAMETERS below]
  68.  
  69. Now, you're ready to go.
  70.  
  71. Type "wm" to get started.  When it prompts you, give a fully
  72. qualified path to the directory with your .wad files.  If you've
  73. actually orgainized them into directories, wm will search through
  74. subdirectories, so give it the root directory of your wad files.
  75. (You can always add wads later, too).
  76.  
  77. You should be presented with a list of wads.  Use the arrow keys,
  78. Home, End, PgUp, and PgDn to navigate through the list.  The most
  79. frequently used commands are listed along the bottom of the screen.
  80. Red letters are hot-keys.  Press '?' or 'H' for some limited on-line
  81. help.
  82.  
  83. Now for some of the powerful stuff.  Lets say you have one wad, call
  84. it yabba.wad.  And another, dabba.wad.  You think these two would go
  85. great together, but the original authors put them on E2M3 and E1M1.
  86. What to do?  Just move the highlight bar to yabba and hit '1'.  Then
  87. move to dabba and hit '2'.  Now hit return.  That's it.  You'll be
  88. presented with a summary of what you're about to do.  Hit N (for
  89. "no"). Say you really like the music of episode 3 (for some reason...),
  90. hit 'E' to change the episode to 3.  Hit return again.  Tada.  wm
  91. will move the wads to where you want them.  Its really easy to mix
  92. wads around now.
  93.  
  94. Sounds good, but there are some catches.  First, if a wad has more
  95. than one level, wm won't mess with it.  Just look at the
  96. information presented at the bottom of the screen to see what level
  97. to select in DOOM settings.  Second, currently wm doesn't move
  98. anything but the map portion of a wad around.  If some wad is setup
  99. for E3M9 and has new MUSIC, the level will move, but the MUSIC will
  100. stay where it is.
  101.  
  102. If you're worried about wm wrecking your wads, don't be.  First,
  103. you can always download it again, second, I've had no trouble
  104. (not that you'd believe me anyway), and third, only 4 bytes need
  105. to be modified to move a wad file, so its a fairly simple operation.
  106.  
  107. If you're worried about running out of memory because you gave it
  108. all to smartdrv.  Don't.  wm only uses 1.5K once its swapped out.
  109. Which, I think is quite stellar.  This was not my doing, I got
  110. this excellent code off the Net.  [More on this later]
  111.  
  112. Experiment, hopefully you'll find this quite handy.
  113.  
  114.  
  115.  
  116. SOME NOTES:
  117.  
  118. Anytime you are asked for input, wm acts fairly intelligently.  The
  119. cursor keys work.  As does Insert, Home, and End.  Ctrl-Y clears
  120. the line.  Esc will generally undo your input.
  121.  
  122.  
  123.  
  124. COMMAND LINE PARAMETERS:
  125.  
  126.    -ini <file>     : Use the specified .ini file instead
  127.                      of the default wm.ini.  Usefull if you
  128.                      and your sibling have different priorities.
  129.  
  130.    -update         : Force a search for wads before anything else.
  131.                      This is exactly the same as the 'U' option in
  132.                      the main area of wm.
  133.  
  134.    -doomroot <dir> : Directory in which the chosen executable resides.
  135.                      Default is c:\doom.
  136.  
  137.    -doomexe <file> : File to execute when DOOMing.  Default is doom.
  138.                      Leave off the ".exe", and provide no path info.
  139.                      The path should be in doomroot.
  140.  
  141.    -datafile <file>: The file to read/write wad list information to/from.
  142.                      Default is wadlist.txt.  This is not really a text
  143.                      file, but it can be fiddled with manually (not really
  144.                      recommended).
  145.  
  146.    -parms <str>    : A list of other parameters to pass to doom.  If
  147.                      you use wm to start modem games, you might put
  148.                      dial commands, etc. in here.  Enclose the string
  149.                      in double quotes if it is more than one word!
  150.  
  151.    -episode <num>  : Your favorite DOOM episode (1-3).
  152.  
  153.    -mission <num>  : Your favorite mission.
  154.  
  155.  
  156.  
  157. THANKS TO:
  158.  
  159.    Clearly, ID software deserves a lot.  So, register if you haven't.
  160.  
  161.    The package of code that allows me to swap wm out of memory and DOOM
  162.    into memory with so little wasted space was written by Thomas Wagner,
  163.    who put his package on the Net, in the Public Domain.  Thank you, Thomas.
  164.  
  165.    Bob Stout released a package of simple and _very_ useful functions in C.
  166.    Its called SNIPPETS.  I got the line-entry code from there, along with
  167.    various file functions.  Thanks to Walter Bright, Jon Burchmore, and
  168.    Jerry Coffin for putting their code in the Public Domain and allowing
  169.    Bob Stout to put it in his collection.
  170.  
  171.  
  172.  
  173.  
  174. ABOUT THE AUTHOR:
  175.  
  176.    I can be reached with comments, suggestions (for new features
  177.    especially), and bugs at ptullman@emba.uvm.edu.
  178.    [My email address will expire sometime in late `95.]
  179.  
  180.    If you have questions about wm, the code I used off of the net,
  181.    or C coding in general, feel free to drop a line (I like mail.).
  182.  
  183.    Feedback of anysort is appreciated.  I'd love to know how far this thing
  184.    has gone, even if you don't like it.
  185.  
  186.    Look for new releases as I discover bugs, and add features.
  187.  
  188.    Thanks,
  189.  
  190.    Patrick Tullmann
  191.  
  192.  
  193.  
  194. MY ATTEMPT AT A LICENSE:
  195.  
  196.    You have permission to redistribute these files, as long as you adhere
  197.    to the following conditions:
  198.  
  199.       1) Keep all of the files together.  This means keeping wm.doc, wm.exe
  200.          and (the original) wm.ini together, preferably in the same
  201.          archive file.
  202.  
  203.       2) No fee beyond that required to cover the cost of the media
  204.          for distriubtion is charged.
  205.  
  206.       3) Don't call ID for technical support on wm.
  207.  
  208.       Basically, keep it in one piece, don't make any money off of it, and
  209.          don't pester anyone else about bugs in it.
  210.  
  211.  
  212.  
  213. (c) 1994 Black Hat Productions.
  214.