home *** CD-ROM | disk | FTP | other *** search
/ Shareware Supreme Volume 6 #1 / swsii.zip / swsii / 126 / DDIRV82.ZIP / DDIR82.DOC < prev    next >
Text File  |  1993-04-02  |  13KB  |  272 lines
  1.  
  2.    ************************************************************************
  3.    *                                                                      *
  4.    **********************  DDIR  VERSION 8.2 *****************************
  5.    *                                                                      *
  6.    ************************************************************************
  7.  
  8.      Note: this package contains the following files:
  9.  
  10.                      DDIR.EXE  (version 8.2)
  11.                      DD82CFG.COM
  12.                      DDIR82.DOC
  13.  
  14.  
  15. DDIR
  16.  
  17. Purpose:  gives a forward/backward scrollable double-column directory display.
  18.           Protected files are flagged with a "+", system files with a "$",
  19.           hidden files with a "*".  Files created today are shown in a
  20.           different color.  Toggles d, t and w allow rapid on-screen display
  21.           of file size as reported by DOS, the total space required to store
  22.           the file, and the dead space "wasted" by the file. (Depending on
  23.           your DOS version and/or hard drive type, a certain minimum amount
  24.           of space is required for all files.  For example, a 10 byte batch
  25.           file may actually use 8192 bytes of your drive. The dead space is
  26.           the amount of disk space wasted by a file.)  
  27.  
  28.           DDIR reports as a summary total file size, total space actually
  29.           used, total dead space, and compute the "storage efficiency",
  30.           which is simply the ratio of file size to space actually required
  31.           for storing the file(s) specified. TAKE A LOOK AT THE STORAGE
  32.           EFFICIENCY FOR THOSE SMALL BATCH FILES!!
  33.  
  34.           DDIR allows you to sort directory listings alphabetically,
  35.           by size, extension, age or attribute, and to instantly (well,
  36.           almost!) resort or reverse the sort order.
  37.  
  38.           For lists that require more than one screen, you can also scroll
  39.           back and forth.  Press PgDn to go to next screen, PgUp to go to
  40.           previous screen, and Home to go to first screen. Use the up and down
  41.           cursor arrows to scroll through the list file by file.
  42.  
  43.           Pressing End takes you to the last screen PROVIDED you have
  44.           previously scrolled all the way through the listing using PgDn.
  45.  
  46.           Pressing F1 brings up a help box.
  47.  
  48.           Pressing c at any time toggles back and forth between UPPER CASE
  49.           and lower case displays.
  50.  
  51.           Pressing d, t or w changes the file size display.  The current
  52.           choice is indicated on the top line.
  53.  
  54.           Pressing Esc  at any time exits the program, first listing the
  55.           summary information (total number of files, dead space etc.).
  56.  
  57.           Please note that DDIR reports the count of files and
  58.           subdirectories separately, unlike the DOS dir command.
  59.  
  60.  
  61.           ** NEW IN VERSION 8.0 ***
  62.  
  63.           Version 8.0 ships with the configurable video display speed set
  64.           to "normal", which prevents DDIR from trying to determine your
  65.           overall system video parameters (mode, number of lines and columns,
  66.           VGA or CGA etc.). On some systems, the call to find these parameters
  67.           causes the system to freeze.
  68.  
  69.           ** NEW IN VERSION 8.1 ***
  70.  
  71.           Version 8.1 adds the ability to scroll back and forth in the file
  72.           list one file at a time. Note the convention: the up arrow means
  73.           scroll towards the top of the list, the down arrow means scroll
  74.           towards the end of the list.
  75.  
  76.           The "sort by age" function has been enhanced to incorporate file
  77.           creation/modification time as well as date.
  78.  
  79.           ** NEW IN VERSION 8.2 ***
  80.  
  81.           Version 8.2 adds the ability to use d, t or w to change the type
  82.           of file size information directly on screen.  THE /t AND /d SWITCHES
  83.           REQUIRED IN EARLIER VERSIONS ARE NO LONGER ACTIVE.
  84.  
  85.           Version 8.2 corrects a problem with color displays that caused a
  86.           black block to appear when scrolling file up from the end of the
  87.           list under certain circumstances.  It also corrects an error that
  88.           placed a small block of the wrong color on the menu line if the
  89.           background colors for normal and summary displays were different.
  90.  
  91. USAGE
  92.  
  93. Notes:    Use the same way as the DOS dir command.  Wild-card characters are
  94.           allowed.
  95.  
  96. Usage:    ddir [d:][path][file.ext]
  97.  
  98. Examples: directory of current drive and directory     ddir
  99.           list of .COM files on drive a -              ddir a:*.com
  100.           list of files of directory "one', drive c -  ddir c:\one
  101.  
  102.  
  103.       **** IMPORTANT UPDATE NOTE ******** IMPORTANT UPDATE NOTE ****
  104.  
  105.       DDIR is an EXE file.  If you are upgrading from an earlier COM
  106.       version, be sure to delete DDIR.COM.
  107.    
  108.       **** IMPORTANT UPDATE NOTE ******** IMPORTANT UPDATE NOTE ****
  109.  
  110.  
  111.  
  112. Customizing DDIR with DD82CFG.COM
  113.  
  114. Usage: dd82cfg [filename]
  115.                where filename is ddir.exe or a copy of ddir.exe
  116.                given some other .exe name (e.g. dd82.exe) 
  117.  
  118.  
  119. NOTE: the customization now allows you to save your settings to a file
  120. DDIRCFG.SAV.  You can have different versions of this file in different
  121. directories if you wish; DDIR will use the settings it finds in the directory
  122. it is run from, if a SAV file exists there.  otherwise it will use its
  123. customized default settings.  You can also reconfigure the default
  124. customization for DDIR from any SAV file you have previously created.  This
  125. feature will be maintained, if possible, in any future upgrades of DDIR,
  126. so that you will be able to reconfigure future versions automatically using
  127. the preferences you have established now.
  128.  
  129. The display colors, the date and time format and the default display (upper
  130. or lower case) can be set automatically using the accompanying configuration
  131. program DD82CFG.  These user-defined settings can be saved in
  132.  
  133. BEFORE CUSTOMIZING, MAKE SURE YOU HAVE BACKED UP THE ORIGINAL DDIR.EXE
  134. TO A SAFE PLACE!  Then from the directory where you have ddir.exe simply
  135. type   dd82cfg or dd82cfg ddir.exe (where ddir.exe can be replaced with
  136. a copy of ddir.exe renamed to some other executable e.g. dd82.exe). 
  137. Follow instructions.  If you choose to reconfigure ddir.exe (or the copy)
  138. directly, a modified file called DDIR82N.EXE, using your selected
  139. customizations, will be created.  Test this before using the DOS COPY
  140. command to copy it to ddir.exe.
  141.  
  142. You can also just create a new DD82CFG.SAV configuration file, or reconfigure
  143. ddir.exe from an existing DD82CFG.SAV file.  
  144.  
  145. If you choose to modify the executable, rather than just create a new
  146. configuration file, DD82CFG will try to open the file you specify on the
  147. command line, or, if none is given, will try to open DDIR.EXE.
  148.  
  149. The first set of customizations are for the normal, highlighted and summary
  150. display colors. You can then set the mode of date display (e.g. dd.mm.yy,
  151. mm-dd-yy etc.) and the default sort method when DDIR is run.
  152.  
  153. DDIR can, if your display adapter is appropriate, use fast screen display.
  154. Unless you are using a CGA adapter or VGA in a slow computer, you should
  155. be able to use this mode.  However, because some adapters are non-standard
  156. it is possible that running in fast display mode would lock your system. 
  157. DDIR therefore ships with the default normal display speed.  You can modify
  158. this through DD82CFG.  If doing so causes no problems stay with it; if a
  159. problem does arise, re-run DD82CFG and select normal display speed.
  160.  
  161. Some non-standard BIOSes do not correctly return the number of lines being
  162. used on the display screen (25 on CGA; up to 60 on VGA displays).  Although
  163. DDIR tries to detect abnormal results, you can, as an added precaution, force
  164. it to use only 25 lines.  Normally,  select "let DDIR choose", and force it
  165. to 25 lines only if there is a problem with the display.  On a correct
  166. display you will see the following two lines at the bottom of the screen:
  167.  
  168.                                                                                
  169.  
  170. F1 - help  ■ ■ Home PgUp PgDn End     c - toggle upper/lower case    Esc -
  171. exit
  172. Sort: n(ame) e(xtension) s(ize) a(ge) f(ile attribute)   r - reverse sort
  173. order
  174.  
  175.  
  176.                              *** IMPORTANT ***
  177.  
  178. The author makes no warranty that the software in this package
  179. will work with your particular hardware configuration.  You use the
  180. programs entirely at your own risk, and the author will not be held
  181. liable for any damage caused to your hardware or software through
  182. use of this software, or for any other effects, direct or indirect,
  183. of using the software.
  184.  
  185. Legalities aside, you should not run into difficulties with this
  186. software.
  187.  
  188. These programs are distributed as shareware, AND ARE NOT CRIPPLED!!.
  189. (Editorial note: I don't support "crippleware" - I want to know
  190. EXACTLY what I'm expected to pay for! Crippleware is, in my opinion,
  191. like test driving a Mercedes that's been fitted with a two-stroke engine!
  192. There, that's said - but each to his own.)
  193.  
  194. You do not have to register as a user, nor are you under any
  195. obligation to pay for the use of the programs.  However, in the
  196. spirit of shareware, you are requested to consider making a small
  197. donation to the author if you find the software in this package useful.
  198. The suggested contribution is $10 but less (or more!) would be fine.
  199. The suggested contribution for multiple copies, e.g. for several users,
  200. is $5 each.
  201.  
  202. Should you decide to make a contribution, please remit to:
  203.  
  204.                    Malcolm Drury
  205.                    11 Adele Crescent
  206.                    Nepean
  207.                    ON  K2J 2T7
  208.                    Canada
  209.  
  210. Internet drury@gsc.emr.ca
  211. Compuserve 70574,3457
  212.  
  213. Bank notes would be fine!  Thank you. Please tell me where you
  214. got the software from (this helps me in knowing where to post updates).
  215.  
  216.  
  217. IF YOU HAVE PREVIOUSLY PAID FOR AN EARLIER VERSION  -  THANKS, AND
  218. OF COURSE YOU ARE NOT EXPECTED TO PAY AGAIN. YOUR INPUT, COMMENTS
  219. ETC. ARE ALWAYS WELCOME.
  220.  
  221. Please note that at the contribution requested, I cannot provide direct
  222. technical support, nor automatically send upgrades, should they
  223. become available. If you have comments, questions, bug reports etc., please
  224. leave a message at my Compuserve or INTERNET address, or write to me via
  225. snail mail.
  226.  
  227. The software is supplied on an "as is" basis. You are free to distribute
  228. this software package provided that you distribute the ENTIRE package,
  229. including this documentation file. (This is necessary for others to be able
  230. to use it properly.  I've downloaded too many shareware packages that had
  231. been posted without accompanying documentation!).
  232.  
  233. I hope you find this package useful.
  234.  
  235. Malcolm Drury
  236. March 28, 1993
  237.  
  238.  
  239. ******************************************************************************
  240.  
  241.             Look for the following shareware on this BBS
  242.  
  243. VGAPAL40.ZIP - customize up to 4 VGA text color palettes, choosing from more
  244.              than 260,000 colors! (And see how many you can actuallydiscern!).
  245.              One palette can be used to create a small (2k) TSR program that
  246.              maintains your chosen scheme.  Alternatively, you can set any of
  247.              the palettes, or a grey-scale scheme, from a non-TSR if
  248.              memory is a problem.
  249.  
  250. DSPACE60.ZIP - shows graphically hard disk space installed, used and free,
  251.                for all drives; second program shows graphically space on
  252.                designated drive (including floppy), and reports on installed
  253.                and available RAM, including XMS and EMS memory.
  254.  
  255.  
  256. ADR60.ZIP - address and telephone number filer, and label maker.  Suitable
  257.             for personal databases or for small clubs etc.  Ideal for finding
  258.             telephone numbers quickly.
  259.  
  260. VIEW80.ZIP - file viewer for WordPerfect 5.0 - 5.2, ASCII and Word (DOS 4/5
  261.               and Windows 1/2); includes text search, printing full or partial
  262.               file, etc.  (On Compuserve as VUFILE.ZIP)
  263.  
  264.  
  265. IF YOU DO NOT FIND ANY OF THESE, LEAVE ME A MESSAGE! I'LL BE HAPPY TO SEND
  266. THEM TO YOU, BUT IN THE INTERESTS OF CUTTING DOWN CONNECT TIME WOULD PREFER
  267. TO USE INTERNET. THAT WOULD REQUIRE YOU TO HAVE THE UUDECODE.EXE PROGRAM,
  268. WHICH SHOULD BE AVAILABLE ON ANY BBS YOU USE.
  269.  
  270. CIS 70574,3457
  271. INTERNET drury@gsc.emr.ca
  272.