home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / diskutil / hotdir / hdirplus.doc < prev    next >
Encoding:
Text File  |  1993-06-08  |  17.4 KB  |  366 lines
  1. Documentation for HotDIR Plus 7.3 (User-Supported Version)
  2.  
  3. Thank you for obtaining the User-Supported Version (i.e. Shareware)
  4. version of HotDIR Plus 7.3 for DOS.  HotDIR Plus is distributed under the
  5. User-Supported Software method.  You get to try the program before
  6. you buy it to make sure that it meets your needs.  How many times have you
  7. bought an expensive PC software package at your local software store only
  8. to find out it won't work like you wanted it to, or that it was a dud?  Well no
  9. more!   You are free to try HotDIR Plus 7.3 for up to 30 days from the date
  10. you received it.  If after using it you decide you would like to keep using it,
  11. you are required to register your copy.  See the file REGISTER.DOC for
  12. the registration form.  If you do not register HotDIR Plus after 30 days you
  13. must erase it from your PC and stop using it.  
  14.  
  15. HotDIR Plus 7.3 is copyrighted (c) 1993 by Robert Woeger.  All rights reserved.
  16. Unauthorized sale or use is forbidden by law.  Shareware dealers, businesses,
  17. BBS's, user groups, and individuals may distribute copies of this program so
  18. long as:
  19.  
  20.         1) No fee is charged for the program (other than a modest disk
  21.         duplication fee not to exceed $8).  CD-ROM shareware disks
  22.         may re-distribute as long as they make it clear that the
  23.         program is shareware, and not being sold by them.
  24.  
  25.         2) You distribute the entire HotDIR Plus software package to include
  26.         unmodified versions of HDIRPLUS.EXE, HDIRCNFG.EXE, HDIRPLUS.DOC,
  27.         and REGISTER.DOC.  You MAY NOT distribute modified or partial versions
  28.         of this software.
  29.  
  30.         3) You must pay for this program if you use it longer than the 30 day
  31.         trial period.  This is NOT crippled in any way.  It is the full version.
  32.  
  33. For more information about HotDIR Plus or to register write to:
  34.  
  35. Old Colorado Information Services
  36. 2423 Hagerman St.
  37. Colorado Springs, CO 80904   U.S.A.        Phone (719) 471-8306
  38.  
  39.  
  40. HotDIR was the first and in my opinion the best color sorted directory
  41. utility.  I originally released version 1.0 back in early 1987, followed
  42. by the "famous" HotDIR 2.1.  Due to the change with hard disks larger than
  43. 33 MB in DOS 4 and DOS 5, I rewrote HotDIR from scratch and relased the
  44. HotDIR Plus 7.0 series.  HotDIR Plus 7.0 and 7.1 were only released to a
  45. few people as beta versions and the first MAJOR release of HotDIR Plus was 
  46. version 7.2.  Version 7.2 was released in October 1992 and is a huge success.
  47. It has even been featured on a disk in the back of the book "DOS 6 Secrets" by
  48. Bob Ainsbury published by IDG Publishing.  This release (version 7.3) is being
  49. released in June 1993 as an enhancement release which adds several new features
  50. and options to HotDIR Plus.  Please note that starting with version 7.3 there
  51. will no longer be two separate HotDIR Plus versions (shareware & registered
  52. versions).  There will only be one version, which may be distributed as 
  53. shareware and used by registered users also.  The reason I had two versions
  54. before was to nudge people to register, but in an effort to reduce the amount
  55. of disks I send out, I will now only have one version produced.  You can still
  56. order HotDIR Plus with or without a disk.  The disk version costs $5 more,
  57. and you will get the latest version.  Thanks for all your suggestions...
  58. keep them coming so HotDIR Plus can be improved even more.
  59.  
  60. All current registered users of previous versions of HotDIR Plus may use
  61. this new version 7.3 without paying any upgrade fee.  HotDIR Plus does NOT
  62. charge its registered users when upgrades come out.
  63.  
  64.  
  65.         *** New features added in 7.3 ***
  66.  
  67.         1) Volume label is now displayed for the disk you are doing a
  68.         directory of.  It is displayed at the top near the path.  Many users
  69.         missed the volume label that Version 2.1 displayed, it is now back.
  70.  
  71.         2) Path now shows the true path instead of just '*.*'.  Some users
  72.         wanted this to help them on their HDIRPLUS printouts to remember
  73.         what they were looking at.  Path has been totally reworked.
  74.  
  75.         3) OS/2 users will now be able to pause HotDIR Plus at the end of its
  76.         display to help prevent the screen from being erased when run in a
  77.         OS/2 session window.  OS/2 users asked for this.
  78.  
  79.         4) Will support HPFS under OS/2, but will only display files that
  80.         conform to the 8.3 DOS standard filename convention.
  81.  
  82.         5) The number of customizeable color extensions has been increased
  83.         from 12 to 20.  This will give you plenty of room to customize HotDIR
  84.         Plus to your favorite file extensions/colors.
  85.  
  86.         6) Now you can display just directories and files without extensions.
  87.         Run HDIRPLUS *.  to get just directories and files without extensions.
  88.         Also the ????????. and various ?,*, ., and .. combinations have been
  89.         enhanced to work together.  Also you can now search for just matching
  90.         filenames without extensions (i.e.  HDIRPLUS A*. will only serach for
  91.         files with no extension and beginning with A,  HDIRPLUS A* will still
  92.         search for all files beginning with A and any extension).
  93.  
  94.         7) HotDIR Plus now shows file sizes in Megabytes (Megs) if the file is
  95.         bigger than 10 Megabytes in size.  If smaller than 10 Meg, bytes are
  96.         still used.  This was added to keep the formatting nice.  Before files
  97.         bigger than 10 MB broke the formatting and column alignment.
  98.  
  99.         8) HotDIR Plus has been optimized for speed.  This version is faster
  100.         than version 7.2, especially when it comes to screen I/O.
  101.  
  102.  
  103.  
  104. HotDIR Plus is a color sorted directory utility.  HotDIR Plus is unique in
  105. that it was the first to display files by color (based on what extension they
  106. were).  It has options to sort your files in many different ways, and list
  107. them left to right or up and down, plus in 1, 2, 4, or 6 column format.
  108. I believe that once you've tried HotDIR you'll be hooked.  Your files will
  109. "pop out" at you, and that is how the "Hot" in HotDIR came about.  I
  110. originally wrote HotDIR for a friend of mine, Dr. John German, to help him
  111. see the different files by type (extensions) easier.  He said, "that's Hot"!
  112. and I soon released the original HotDIR 1.0 to the world.  I got such an
  113. enthusiastic response from HotDIR that I wrote HotDIR Plus.  I hope you
  114. enjoy using it as much as we do.
  115.  
  116. Feel free to rename HDIRPLUS.EXE to any file name you like.  A lot of
  117. people rename it to H.EXE or D.EXE.  Just be sure to add it to the PATH
  118. statement so DOS can find it.  Also when configuring HDIRPLUS be sure to
  119. specify the exact name of the HDIRPLUS.EXE file (or whatever you renamed it 
  120. to).  I got many frantic calls from users who got an file not found error
  121. message when they ran HDIRCNFG and didn't supply the name of HDIRPLUS.EXE.
  122.  
  123.  
  124. Type: HDIRPLUS /h     to get the help screen.
  125.  
  126. All commands are described on the help screen and appear as a forward
  127. slash followed by a letter of the option.  You may use multiple commands
  128. when you invoke HDIRPLUS:
  129.  
  130. Format:    HDIRPLUS [path] [filespec] [/option] [/option] ...
  131.  
  132. Examples are:
  133.  
  134. HDIRPLUS \os2\system /c /2
  135.  
  136.         This will display a 2 column directory format and clear the screen
  137.         first.  It will display all files in directory \os2\system.
  138.  
  139. HDIRPLUS
  140.  
  141.         This will display all files in the default drive/directory and use the
  142.         predefined options.  Default or those modified through HDIRCNFG.EXE.
  143.  
  144. HDIRPLUS /R
  145.  
  146.         Information about registering your copy of HotDIR Plus.
  147.  
  148. HDIRPLUS /h
  149.  
  150.         List of all commands available for HotDIR Plus.
  151.  
  152. HDIRPLUS a: /p
  153.  
  154.         Display directory of A: drive and toggle Pause at end of screen mode.
  155.  
  156. HDIRPLUS /p >prn
  157.  
  158.         Sends HotDIR Plus' output to the printer without page pauses.
  159.         You can send output to a file by placing >filename instead of >prn.
  160.  
  161. HDIRPLUS \junk /u
  162.  
  163.         Displays all files in the directory \junk on the default drive while
  164.         it toggles the up/down and left/right display option for filenames
  165.  
  166. HDIRPLUS /O /H
  167.  
  168.         Displays the help screen when running in an OS/2 session window.  Note
  169.         that the /O must proceed the /H and /R options or else it is ignored
  170.         and the text will scroll right off the screen.  You can permanently set
  171.         the OS/2 pause at end of program switch and need not worry about
  172.         putting the /O switch on the command line.
  173.  
  174.  
  175.  
  176. Summary
  177. -------
  178.  
  179. Commands used by HotDIR Plus:
  180.  
  181. /H - displays on-line help screen
  182. /R - displays information on how to register your copy
  183.  
  184. /N - No sort (unsorted raw file directory)
  185. /F - Filename sort (factory default)
  186. /E - Sort by extension
  187. /D - Sort by date (oldest to newest files)
  188. /S - sort by file size
  189.  
  190. /1 - 1 column display format
  191. /2 - 2 column display format
  192. /4 - 4 column display format (factory default)
  193. /6 - 6 column display format
  194.  
  195. /C - toggles Clear screen at beginning of directory display
  196. /P - Pause at end of screen toggle
  197. /U - Up/Down file sort/display toggle - alternate is left to right display
  198.  
  199. /O - OS/2 pause at end of display (for running under OS/2 sessions)
  200.  
  201. This summarizes the command switches for HotDIR Plus.
  202.  
  203.  
  204. A program named HDIRCNFG.EXE is included to give you greater flexibility
  205. and control over the permanent HotDIR Plus settings.  The above commands
  206. are great for overriding the default settings, but when you want to
  207. permanently change the colors used by HotDIR Plus, sort options, column
  208. displayed, etc. use HDIRCNFG to change HDIRPLUS.EXE.  HDIRCNFG.EXE
  209. modifies the HDIRPLUS.EXE program itself and writes the changes inside the
  210. HotDIR Plus program.  This was done to keep from having a separate
  211. configuration file for HotDIR Plus floating around.  Due to a programming
  212. error on my part HotDIR Plus 7.1 was clobbered whenever the HDIRCNFG program
  213. was run and the options saved.  This has now been fixed, but I encourage
  214. you to make a backup copy of HDIRPLUS.EXE before running the HDIRCNFG utility.
  215. Version 7.1 was a limited distribution beta version, but somehow got out to
  216. almost every BBS and CD-ROM known to man.  Version 7.2 was very stable and I
  217. have not had any bug reports or problems from it.
  218.  
  219. Simply run HDIRCNFG and it will prompt you to change each setting.  If you
  220. make a mistake just do not save the changes, exit HDIRCNFG, and rerun.
  221.  
  222. If you want to remove an extension name and color, simply overwrite the
  223. extension name with another extension and color.  If you want to just disable
  224. one extension make sure you use blanks for the extension name.  Make sure
  225. you move the other extensions forward and make the blank extension the last
  226. in the list.  Otherwise the blank extension will cause HotDIR Plus to stop
  227. searching for other colors and extensions that are after a blank entry.
  228.  
  229. HDIRCNFG is very versatile and powerful, but I recommend you get familiar
  230. with HDIRPLUS first before you change options.  Most every option is able to
  231. be changed through HDIRCNFG.EXE.  If you want to temporarily override an
  232. option use a command switch when invoking HotDIR Plus.  Also you can change
  233. the number of lines to display per screen with HDIRCNFG.  This is very useful
  234. for EGA & VGA monitors when in 43 or 50 line per screen mode.
  235.  
  236. HDIRCNFG uses standard BASIC COLOR command color numbers.  It is recommended
  237. that you use colors between 0 and 15.  16-31 are blinking versions of the
  238. lower 0-15 colors.  The most common colors numbers are:
  239.  
  240.         0       Black
  241.         1       Blue
  242.         2       Green
  243.         3       Cyan
  244.         4       Red
  245.         5       Magenta
  246.         6       Yellow
  247.         7       White
  248.         8       Gray
  249.         9       Light blue
  250.         10      Light green
  251.         11      Light cyan
  252.         12      Light red
  253.         13      Light magenta
  254.         14      Hi intensity yellow
  255.         15      Hi intensity white
  256.  
  257.  
  258. There are some self imposed limits with HotDIR Plus which are:
  259.  
  260. No more than 1,000 files per subdirectory.  This is a reasonable number
  261. of files, and it helps keep HotDIR's sort and data areas to a reasonable size.
  262.  
  263. No more than 20 different customized file extension colors at one time.  This
  264. is a reasonable number that keeps HotDIR Plus from spending too much time 
  265. sorting through a large number of files.
  266.  
  267. Through the new feature to display files larger than 10 Megabytes in Megs
  268. rather than in bytes, you can accomodate files up to 999 Megs without breaking
  269. the display and column formatting.  If you do have a file larger than
  270. 999 Megs, then you will still see the size in Megs, but the formatting on 
  271. that line will be a space off.  I doubt anyone will have a file > 999 Megs, 
  272. but I made it sufficiently large just in case.
  273.  
  274.  
  275. HotDIR Plus has been tested under all version of DOS up to and including 6.0,
  276. OS/2, and Windows NT.  It should work with all later version of the above
  277. operating systems also.
  278.  
  279. We do not offer OS/2 or Windows/Windows NT specific versions of HotDIR Plus at
  280. the current time.  Due to Windows and OS/2's graphical nature a text based DIR
  281. replacement such as HotDIR Plus is not often needed.  HotDIR Plus will run
  282. happily as a DOS mode application under these operating systems.  We have
  283. added and extra option for users running under OS/2.  You can set the switch
  284. manually (/O) each time you run HotDIR Plus or permanently with the HDIRCNFG
  285. utility.  The /O option causes HotDIR Plus to pause the screen until a key is
  286. hit when it is done.  This allows for OS/2 users to see HotDIR Plus' display
  287. when it is run from an OS/2 session (non-DOS session), instead of it flashing
  288. off the screen and returning back to the OS/2 prompt.
  289.  
  290.  
  291. *** This is not free software!  You are granted a limited non-exclusive
  292. license to use this software (HDIRPLUS.EXE and HDIRCNFG.EXE) for a trial
  293. period of no longer than 30 days.  If after that time you have not paid for
  294. the right to use the program from the author, you must STOP using it.  You are
  295. free to distribute unmodified copies of the entire Shareware version of HotDIR
  296. Plus to others, but in no way may you charge any fee for HotDIR Plus other
  297. than a modest disk duplication fee not to exceed $8.  This documentation file
  298. and the REGISTER.DOC file MUST be distributed unmodified with HDIRPLUS.EXE
  299. and HDIRCNFG.EXE.  Registration is described by the REGISTER.DOC file and
  300. by the HDIRPLUS /R command.  The author, Robert Woeger, makes no warranties
  301. or guarantees of any kind regarding this software.  This software is
  302. distributed "AS IS" and the author will not be liable for any damages from use
  303. or misuse of the software.  ***
  304.  
  305. HotDIR Plus is $15 and comes with technical support from the author, notices 
  306. of upgrades, and a software license showing you are a registered user.
  307.  
  308. For $20 you get a disk with the latest version also.
  309.  
  310. If you would like to order a site license (multiple copies of HotDIR Plus) for
  311. use at your business, school, or home, the fee is very low for extra copies. 
  312. It costs only $5.00 per extra copy you register after you have paid for the
  313. first copy at regular price.  See REGISTER.DOC for an order form with more
  314. site license information.  Or you may call 1-719-471-8306 for more 
  315. information.
  316.  
  317. Send registration payments directly to the author:
  318.  
  319. Old Colorado Information Services
  320. 2423 Hagerman St.
  321. Colorado Springs, CO 80904-3228            (719) 471-8306
  322. U.S.A.
  323.  
  324. Note the company name is new, but the author is the same (Robert Woeger).
  325.  
  326. Write or call for info about site licenses, volume discounts, and repackaging
  327. HotDIR Plus with your software.
  328.  
  329.  
  330. Special Note to Compuserve Users:
  331. ---------------------------------
  332. You may optionally register for $20 HotDIR Plus through Compuserve's
  333. Shareware Registration Service (GO SWREG) and using registration ID #364 for
  334. HotDIR Plus for DOS.  Your Compuserve account will be billed $20 and they will
  335. forward your order to me.  For this $20 fee I will also send you a disk with
  336. latest version of HotDIR Plus on it.  This is available in the U.S. and for
  337. foreign orders (same price).  Sorry, but you can not order the "registration only"
  338. version of HotDIR Plus 7.3 through Compuserve for $15.  You can only order the
  339. $20 package that includes the registration and the disk.
  340.  
  341.  
  342. Credit Card Orders Now Accepted:
  343. ------------------------------
  344. You may now register HotDIR Plus by phone with your credit card.  We have
  345. contracted with the Public software Library (Houston, TX) to do our credit
  346. card orders for us.  They can take ORDERS ONLY and can not provide technical
  347. suppport.  You can order by calling 1-800-242-4775, or from outside the U.S.
  348. by calling 1-713-524-6394.  When you call, tell them you want to order HotDIR
  349. Plus (product # 10850).  They charge $25 ($20 for HotDIR Plus with disk, plus
  350. $5 shipping/order processing charge).  Your order is electronically forwarded
  351. to us immediately.  They can only accept orders with a disk (the same as
  352. Compuserve).  If you would like to order the Non-Disk Version or want a site
  353. license for HotDIR Plus you must order directly through the mail with us.
  354. We can only accept credit card orders through your calling the number above,
  355. not through the mail.  Thank you.
  356.  
  357.  
  358. Note to Shareware Vendors:  
  359. --------------------------
  360. You are free to distribute the complete HotDIR Plus package as long as you 
  361. distribute unmodified copies and the complete package, and you only charge a 
  362. disk duplication fee of less than $8.  CD-ROM vendors may distribute HotDIR 
  363. Plus as long as the purchaser knows that HotDIR Plus is Shareware.
  364.  
  365. Enjoy!   -    Robert Woeger,  Author of HotDIR Plus
  366.