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