home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 17 / CD_ASCQ_17_101194.iso / vrac_os2 / wdir2081.zip / WDIR.DOC < prev    next >
Text File  |  1994-07-11  |  12KB  |  276 lines
  1. WackyDir version 0.81
  2. by Mike Stella
  3. July 10, 1994
  4.  
  5.         WackyDir and Wdir are Copyright (C) 1994 Reverse Engineering.
  6. WackyDir is released under the Shareware distribution scheme.  You
  7. may copy and distribute WackyDir freely, but only in unmodified
  8. form, including all associated files:  WDir.exe, WDir.doc. The files
  9. can be archived together for easier distribution, and any fee for
  10. distribution may not exceed $7.
  11.  
  12.         All users of WackyDir are given a reasonable amount of time to
  13. try out WackyDir.  This period is 30 days.  If you continue to use
  14. WackyDir after the evaluation period, you must register.  Any company,
  15. school, or government using WackyDir must register for as many copies
  16. as they use.  For bulk purchases, or site licensing, contact me as
  17. shown below.
  18.  
  19. =======================================================================
  20. What is WackyDir ?
  21. =======================================================================
  22.  
  23.         WackyDir is a simple program that displays a directory of files
  24. in a number of different ways and colours.  It allows complete
  25. customization of colours, sort methods, display methods and extension
  26. colours with a built-in configuration screen.  It works on both FAT and
  27. HPFS file systems, in OS/2 2.x.  Hell, it may even work in 1.x, but as
  28. no one I know still has that, I haven't tested it.
  29.         I wrote this program because I hated the way DIR works.  I used
  30. to use another program, but since it was a DOS program, and doesn't
  31. work well in OS/2 command sessions, I decided something had to be done.
  32.         WackyDir will autodetect the screen size, and pause accordingly,
  33. it will autodetect the cluster size of your drive, and report the
  34. correct value in the totals, and will of course, give you a directory.
  35.         At the moment, I haven't figured out how to display long
  36. filenames and still have the program look good, so they may make a bit
  37. of a mess.  If anyone has ideas on this, let me know.  I was thinking
  38. of making the program display the files in one column if there are long
  39. filenames, but I haven't got to it, since I don't use long filenames
  40. much.  And, of course, I'd have to do a bit of revision of the code
  41. (ugh).
  42.  
  43. =======================================================================
  44. Using WackyDir
  45. =======================================================================
  46.  
  47.         First, be sure you are in an OS/2 command prompt window or
  48. fullscreen.  Then just type:
  49.  
  50.         WDIR
  51.  
  52.         You should see a directory.  Of course, it looks the way I like
  53. it, so don't get annoyed if you don't like it right now.  We'll get to
  54. the configuration in a second.
  55.  
  56.         You can specify a path, other than the current directory.  An
  57. example:
  58.  
  59.         WDIR e:\
  60.         WDIR ..
  61.         WDIR \os2\mdos\*.*
  62.         WDIR c:\*
  63.         WDIR *.exe
  64.         WDIR wd*
  65.  
  66.         You can use some command-line paramaters.  They are as follows:
  67.  
  68.         /A : autodetect the number of columns to use
  69.         /C : clear screen before file display
  70.         /H : display a handy help screen
  71.         /N : sort files by name
  72.         /P : toggle pausing when the screen is full
  73.         /S : sort files by size
  74.         /X : sort files by extension
  75.         /, : toggle displaying of commas in the totals
  76.         /? : display the help screen
  77.         /2 : display files in two columns
  78.         /3 : display files in three columns
  79.         /4 : display files in four columns
  80.         /6 : display files in six columns
  81.  
  82.         Using the parameters is simple.  You must put ALL parameters in a
  83. row, BEFORE a path.  i.e. like this:
  84.  
  85.         WDIR /2 d:\temp
  86.         WDIR /X /4 d:\
  87.  
  88.         And, you can group the parameters together with one '/', so that
  89.  
  90.         WDIR /X4 d:\
  91.  
  92. is the same as the last example above.
  93.  
  94. =======================================================================
  95. The Configuration menu
  96. =======================================================================
  97.  
  98.         The configuration menu in WackyDir is real simple to use.  To
  99. get to it, type:
  100.  
  101.         WDIR /K
  102.  
  103.         Then, you can use the arrow keys to move the little hilight bar
  104. up and down.  Hit return to change options.  The first few options are
  105. toggles, and one is a three way toggle.  The autodetect options, you can
  106. hit return on, and then type a new value.  These options will be saved
  107. as default if you choose to do so, with one of the options at the bottom
  108. of the menu.
  109.         There are two sub-menus, the Colour Configuration, and the
  110. Extension Configuration menus.  Press return while the highlight is on
  111. either of these options to change menus.
  112.         The Colour Configuration menu is simple.  Move up and down to
  113. hilight the colour you wish to change.  Use the Left and Right arrow
  114. keys to change the foreground colour, and PageUp and PageDown to change
  115. the background colours.
  116.         The Extension Configuration menu works just like the Colour
  117. Configuration menu.  Press Left or Right to change the foreground
  118. colours, and PageUp and PageDown to change the background colours.
  119. Pressing return on an extension will allow you to change that extension
  120. to suit your needs.  You can then just type a new extension, hitting
  121. return when you're done, or just hit return to keep the old one.
  122.         Then you can exit and save the changes you just made, or abandon
  123. them, and use the old values.  That's it, it's real easy.
  124.  
  125.         But there's one more thing.  The configuration program will make
  126. a file called WDIR.CFG.  This file must either be in your path, or the
  127. current directory, in order for the program to work.  When it is first
  128. created, it will automatically be in the current directory.  In a future
  129. version, I plan to make the program write directly to the WDIR.EXE file,
  130. eliminating the WDIR.CFG file, but you're stuck with it for now.
  131.         What I do, is just throw both WDIR.EXE and WDIR.CFG into a tools
  132. directory that's in my path, and I never have to worry about it again.
  133. When you update the configuration, the program will automatically write
  134. the changes to the config file, wherever it is in your path.  Oh, you
  135. might want to make sure there is only one WDIR.CFG file in your path, or
  136. you might run into problems.
  137.         If you have any other questions, feel free to email me, I'll be
  138. glad to help out, or make addendums to this documentation file for
  139. future versions.
  140.  
  141. =======================================================================
  142. Suggestions, and how to contact the author (me)
  143. =======================================================================
  144.  
  145.     Any suggestions, improvements, or bug reports are welcome.  A
  146. registration form is included at the end of this documentation.
  147.  
  148.         Remember: WackyDir is user supported software.  It needs your
  149. support to grow.  If I continue to receive registrations for WackyDir, I
  150. will continue adding features to WackyDir.  The current version of
  151. WackyDir has taken many, many hours of work, and if you use it, you are
  152. obliged to pay for it.
  153.         And if you can come up with a neat new feature you would like to
  154. see become part of WackyDir, let me know, I may even put it in!
  155.  
  156.         You also contact me at the following locations:
  157.  
  158. Internet:
  159.         MKS94001@uconnvm.uconn.edu
  160.         mstella@ug1.eng1.uconn.edu
  161.  
  162. Netmail to Ghost Maker at:
  163.         FidoNet      :
  164.         Speakeasy Net: 18:18/42
  165.         Impact Net   :
  166.  
  167. BBS:
  168.         Shadowland, the Reverse Engineering support BBS
  169.                 (203) 456-1103, USR Dual Standard v.FC
  170.  
  171.         Type 'J' at either the message or file menu to join the Reverse
  172. Engineering programming and support conference, and to obtain the newest
  173. versions of all our products.  You may contact me or any other member of
  174. Reverse Engineering by posting in any of the message areas in the same
  175. conference, or by email on the BBS.
  176.  
  177. Post (non-electronic mail):
  178.         Mike Stella
  179.         90 Ridgewood Road
  180.         Willimantic, CT 06226
  181.  
  182. =======================================================================
  183. DISCLAIMER OF WARRANTY
  184. =======================================================================
  185.  
  186.         THIS SOFTWARE AND MANUAL ARE SOLD "AS IS" AND WITHOUT WARRANTIES
  187. AS TO PERFORMANCE OF MERCHANTABILITY OR ANY OTHER WARRANTIES WHETHER
  188. EXPRESSED OR IMPLIED.  BECAUSE OF THE VARIOUS HARDWARE AND SOFTWARE
  189. ENVIRONMENTS INTO WHICH THIS PROGRAM MAY BE PUT, NO WARRANTY OF FITNESS
  190. FOR A PARTICULAR PURPOSE IS OFFERED.  SPACE HAS BEEN THOROUGHLY TESTED
  191. BUT I CAN NOT GUARANTEE THAT THERE ARE NO PROBLEMS WITH IT.  THE USER MUST
  192. ASSUME THE ENTIRE RISK OF USING THE PROGRAM.  ANY LIABILITY OF THE SELLER
  193. WILL BE LIMITED EXCLUSIVELY TO PRODUCT REPLACEMENT OR REFUND OF PURCHASE
  194. PRICE.
  195.  
  196. =======================================================================
  197. Contents of the Disk/Archive
  198. =======================================================================
  199.  
  200.           The following files should be on the disk (or in the archive)
  201. you received, and may be distributed freely:
  202.  
  203.         WDIR.EXE        - The actual program
  204.         WDIR.DOC        - This documentation file
  205.  
  206.         If you have recieved a registered version, these files may NOT
  207. be distributed.  If you choose to do so, you will be in violation of
  208. certain shareware distribution and software piracy laws, and may be
  209. prosecuted.
  210.         Keep in mind that your name will be encoded into your copy of
  211. WackyDir, so that if you choose to distribute it, everyone will know
  212. that you are breaking the law.  And if I get wind of it...
  213.  
  214. =======================================================================
  215. Registration Information
  216. =======================================================================
  217.  
  218.         One registration of WackyDir costs $10.  For an additional $5
  219. disk and postage fee you will receive a disk with the registered
  220. version of WackyDir, a personalised copy encoded with your name.
  221. One registration means run on only one machine at a time. If you send
  222. a check, make it out to Reverse Engineering.  Please specify 3.5" or
  223. 5.25" disk.  Remember that I will send you a disk only after I am sure
  224. your check will clear.
  225.  
  226. Mail to:                        
  227.         Reverse Engineering
  228.         90 Ridgewood Road
  229.         Willimantic, CT 06226 USA
  230.  
  231. =======================================================================
  232. Registration Form
  233. =======================================================================
  234.  
  235. Name _______________________________________________________________
  236. Street Address _____________________________________________________
  237. City ___________________________________ State _____ Zip ___________
  238.  
  239. The rest of this form is optional, but please fill it out.  I would
  240. like to see what kind of people use this program.
  241.  
  242. Buisness Name ------------------------------------------------------
  243. Kind of Buisness ---------------------------------------------------
  244.  
  245. Type of Computer ---------------------------------------------------
  246. Operating System ---------------------------------------------------
  247. Model/Speed of Modem -----------------------------------------------
  248.  
  249. BBS Name -----------------------------------------------------------
  250. BBS Number ---------------------------------------------------------
  251. BBS Software -------------------------------------------------------
  252.  
  253.                       WackyDir for OS/2 v0.81ß
  254.  
  255. ______  I am sending you $10 registration cost because I use
  256. WackyDir on one machine and would like to thank you for the
  257. program.
  258.  
  259. ______  I am sending you $15 registration and disk cost.  I use
  260. WackyDir on one machine and would like you to send me a disk
  261. with the latest version of WackyDir, personalised with my name,
  262. and a program to migrate my present configuration.
  263.  
  264.         Disk size: _____ 3.5"
  265.                    _____ 5.25"
  266.  
  267.    If sending a check, make it out to Reverse Engineering.  For
  268. orders of more than one copy, and site licenses, send me mail to
  269. one of the above locations and we will work out a suitable price.
  270.  
  271.    Please send this form and payment to:                        
  272.         Reverse Engineering
  273.         90 Ridgewood Road
  274.         Willimantic, CT 06226 USA
  275.  
  276.