home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 19 / CD_ASCQ_19_010295.iso / vrac / ddir100.zip / DDIR100.DOC < prev    next >
Text File  |  1994-11-12  |  18KB  |  393 lines
  1.  
  2.  
  3.                                       DDIR       ▌
  4.                                                  ▌
  5.                                    Version 10.0  ▌
  6.                                                  ▌
  7.                                  ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▌
  8.  
  9.      Note: this package contains the following files, zipped with PKZIP 2.04g:
  10.  
  11.                      DDIR.EXE      - the program
  12.                      DD100CFG.COM  - customization program
  13.                      DDIR100.DOC   - documentation
  14.                      UPGRADE.TXT   - important information
  15.                      DDUSERF2.BAT  - (sample)
  16.                      DDIRUSER.LST  - blank file listing user-defined
  17.                                      functions
  18.                      FILE_ID.DIZ   - brief description for BBS use
  19.  
  20.  
  21.  
  22. DDIR
  23. ▀▀▀▀
  24.  
  25. Purpose: gives a forward/backward scrollable double-column directory display.
  26.          Protected files are flagged with a "+", system files with a "$",
  27.          hidden files with a "*".  Files created today are shown in a
  28.          different color.
  29.  
  30.          Toggles w, x, y and z  allow rapid on-screen display of file size
  31.          in different ways - the file size reported by DOS, the total space
  32.          ACTUALLY required to store the file, the dead space "wasted" by the
  33.          file, and the file "storage efficiency"  which is simply the ratio
  34.          of file size to space actually required for storing the file.
  35.          (Depending on your DOS version and/or hard drive type, a certain
  36.          minimum amount of space is required for all files.  For example, a
  37.          10 byte batch file may actually use 512 bytes on a floppy disk and
  38.          32kb of your network drive! The dead space is the amount of disk
  39.          space wasted by a file.)
  40.  
  41.          DDIR allows to mark files for deletion, and delete them and re-list.
  42.          You can view files using the author's VIEW utility and Vernon Buerg's
  43.          LIST utility. There is also a link to a graphics viewer. I recommend
  44.          Bob Montgomery's excellent VPIC.
  45.  
  46.          DDIR includes a facility to pack files into ZIP, ARJ, SQZ, ZOO or
  47.          LZH archives, and of course to unpack from those archives.  You
  48.          do, of course, need the programs pkzip/pkunzip, etc. in order to
  49.          use this feature.
  50.  
  51.          You can also change directories from within the file list and exit
  52.          either to the starting drive/directory or to the currently displayed
  53.          drive/directory.
  54.  
  55.          DDIR reports as a summary total file size, total space actually
  56.          for the file(s) specified. TAKE A LOOK AT THE STORAGE EFFICIENCY FOR
  57.          THOSE SMALL BATCH FILES!!
  58.  
  59.          DDIR allows you to sort directory listings alphabetically,
  60.          by size, extension, age, attribute or storage efficiency, and to
  61.          instantly (well, almost!) resort or reverse the sort order.
  62.          For lists that require more than one screen, you can also scroll
  63.          back and forth.
  64.  
  65.          You can toggle write-protect on and off for files (i.e. make them
  66.          read-only or read-and-write).
  67.  
  68.          You can copy files from the current list to another location.
  69.  
  70.          Please note that DDIR reports the count of files and
  71.          subdirectories separately, unlike the DOS dir command.
  72.  
  73.  
  74.  
  75.  
  76.  USAGE
  77.  ▀▀▀▀▀
  78.  
  79. Notes:   Use the same way as the DOS dir command.  Wild-card characters are
  80.           allowed.
  81.  
  82. Usage:    ddir [d:][path][file.ext]
  83.  
  84. Examples: directory of current drive and directory     ddir
  85.           list of .COM files on drive a -              ddir a:*.com
  86.           list of files of directory "one', drive c -  ddir c:\one
  87.  
  88.  
  89. Keys:
  90.  
  91.  F1  - help screens
  92.  Shift F1 - shows list of user-defined functions
  93.  Esc - exit to home drive and directory
  94.  q   - exit to currently displayed drive and directory.
  95.  
  96.  t - mark/unmark files for deletion, for archiving (packing), or for copying
  97.  Del - delete any marked files and re-list.
  98.  
  99.  Tab - change bottom display (file count summary or quick help)
  100.  
  101.  a   - sort by file attribute (system, hidden, directory etc.)
  102.  b   - back up highlighted file
  103.  c   - toggle upper/lower case display
  104.  d   - sort by file date
  105.  e   - sort by extension
  106.  f   - sort by file "storage efficiency"
  107.  g   - view graphics file with viewer VPIC
  108.  k   - pack (archive) tagged files.
  109.        Note: in order to use this feature, these programs must be present
  110.        in a directory that is specified in the PATH statement in your
  111.        AUTOEXEC.BAT file.
  112.  l   - view highlighted file with LIST (by Vernon Buerg)
  113.  m   - move tagged files (they can optionally be deleted from the source
  114.        drive)
  115.  n   - sort by file name
  116.  p   - toggle file protect/unprotect (i.e. read-only or read and write)
  117.  r   - reverse sort order
  118.  s   - sort by size
  119.  u   - unpack selected file using pkzunzip.exe, arj,exe or lha.exe.  (See
  120.        note for "k" (pack) above).
  121.  v   - view highlighted file with VIEW (for WordPerfect 5.0-6.0,
  122.        DOS Word 4-5.5, WinWord 1-6, Win Write, Ami Pro, ASCII, ANSI, Wordstar)
  123.  w   - show file "wasted space"
  124.  x   - show file total space
  125.  y   - show DOS file size, wasted space and individual storage efficiency
  126.  z   - show file size reported by DOS
  127.  
  128.  
  129.  Grey +      - scroll display up one file
  130.  Grey -      - scroll display down one file
  131.  PgDn        - next screen
  132.  PgUp        - previous screen
  133.  Home        - go to beginning of list
  134.  End         - go to end of list
  135.  
  136.  Up arrow    - move down current screen list to select "active" file
  137.  Down arrow  - move up current screen list to select "active" file
  138.  Enter       - change to highlighted directory
  139.  
  140.  Ins  - print directory listing, including via Tony Caine's compressed
  141.         print utilities 2COL and JETCOL. If you choose this option you
  142.         should have the directory containing 2COL or JETCOL in the PATH
  143.         statement in your autoexec.bat file.
  144.  
  145. F2-F9       - user-defined functions defined by dduserf2.bat, dduserf3.bat
  146.               to dduserf9.bat.  If a %1 is specified in the batch file
  147.               the action specified in the file is on the currently
  148.               highlighted file.  If no %1 is given the action    is simply
  149.               that specified - such as bringing up a calculator.  See the
  150.               example dduserf2.bat.  NOTE: the naming convention refers
  151.               to the function key that calls the batch file.
  152.  
  153. F10         - change drive.  A list of all available drives will be displayed;
  154.               simply type in the letter of the drive you want and press
  155.               "Enter".
  156.  
  157. Shift F1 - view a file called ddiruser.lst.  This must be in the root
  158.            directory of your c: drive.  It can be edited to your
  159.            specifications. A blank is provided with this package.
  160.  
  161. IMPORTANT NOTES
  162. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  163.   -     To use v or l you must have the VIEW or LIST utilities in a directory
  164.         referenced in your AUTOEXEC.BAT PATH statement).
  165.  
  166.   -     To use g you must have a graphics file viewer called VPIC in your
  167.         path. If you use a different viewer, you should make a copy of
  168.         the executable file and call it vpic.exe (or vpic.com if it is
  169.         a COM file).
  170.  
  171.   -     When you press the right or left arrow keys, the up and down arrow
  172.         keys are disabled. To re-enable, press Spacebar, PgUp, PgDn, Home
  173.         or End
  174.  
  175.  
  176.       **** IMPORTANT UPDATE NOTE ******** IMPORTANT UPDATE NOTE ****
  177.  
  178.       DDIR is an EXE file.  If you are upgrading from an earlier COM
  179.       version, be sure to delete DDIR.COM.
  180.  
  181.       **** IMPORTANT UPDATE NOTE ******** IMPORTANT UPDATE NOTE ****
  182.  
  183. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  184.  
  185.  
  186. CUSTOMIZING DDIR WITH DD100CFG.COM
  187. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  188.  
  189. Usage: dd100cfg [filename]
  190.                where filename is ddir.exe or a copy of ddir.exe
  191.                given some other .exe name (e.g. dd100.exe)
  192.  
  193. If you omit the filename, dd100cfg will assume you want to configure
  194. ddir.exe.
  195.  
  196.  
  197. What can you configure? (quick summary)
  198.  
  199. - the display color for the file list (old files)
  200. - the display color for new files
  201. - the display color for files marked for deletion
  202. - the display color for scrolling through the file list
  203. - the date and time format (date: US, UK or International; date: 12 or
  204.   24 hour clock)
  205. - the way in which DDIR sorts the file list when you first run it
  206. - the display speed (normal e.g. for CGA, 8088; fast e.g. for EGA/VGA,
  207.   80286 or better)
  208. - whether or not DDIR automatically detects the number of display lines
  209.  
  210.  
  211. NOTE: the customization now allows you to save your settings to a file
  212. DDIR9CFG.SAV.  You can have different versions of this file in different
  213. directories if you wish; DDIR will use the settings it finds in the directory
  214. it is run from, if a SAV file exists there.  otherwise it will use its
  215. customized default settings.  You can also reconfigure the default
  216. customization for DDIR from any SAV file you have previously created.  This
  217. feature will be maintained, if possible, in any future upgrades of DDIR,
  218. so that you will be able to reconfigure future versions automatically using
  219. the preferences you have established now.
  220.  
  221. The display colors, the date and time format and the default display (upper
  222. or lower case) can be set automatically using the accompanying configuration
  223. program DD100CFG.BEFORE CUSTOMIZING, MAKE SURE YOU HAVE BACKED UP THE ORIGINAL
  224. DDIR.EXE TO A SAFE PLACE!  Then from the directory where you have ddir.exe
  225. simply type   dd100cfg or dd100cfg ddir.exe (where ddir.exe can be replaced
  226. with a copy of ddir.exe renamed to some other executable e.g. dd100.exe).
  227. Follow instructions.  If you choose to reconfigure ddir.exe (or the copy)
  228. directly, a modified file called DDIRN.EXE, using your selected
  229. customizations, will be created.  Test this before using the DOS COPY
  230. command to copy it to ddir.exe.
  231.  
  232. You can also just create a new DDIR9CFG.SAV configuration file, or reconfigure
  233. ddir.exe from an existing DDIR9CFG.SAV file (including those created from
  234. earlier versions).
  235.  
  236. If you choose to modify the executable, rather than just create a new
  237. configuration file, DD100CFG will try to open the file you specify on the
  238. command line, or, if none is given, will try to open DDIR.EXE.
  239.  
  240. The first set of customizations are for the display colors. You can then set
  241. the mode of date display (e.g. dd.mm.yy, mm-dd-yy etc.) and the default sort
  242. method when DDIR is run.
  243.  
  244. DDIR can, if your display adapter is appropriate, use fast screen display.
  245. Unless you are using a CGA adapter or VGA in a slow computer, you should
  246. be able to use this mode.  However, because some adapters are non-standard
  247. it is possible that running in fast display mode would lock your system.
  248. DDIR therefore ships with the default normal display speed.  You can modify
  249. this through DD100CFG.  If doing so causes no problems stay with it; if a
  250. problem does arise, re-run DD100CFG and select normal display speed.
  251.  
  252. Some non-standard BIOSes do not correctly return the number of lines being
  253. used on the display screen (25 on CGA; up to 60 on VGA displays).  Although
  254. DDIR tries to detect abnormal results, you can, as an added precaution, force
  255. it to use only 25 lines.  Normally,  select "let DDIR choose", and force it
  256. to 25 lines only if there is a problem with the display.  IMPORTANT: If you
  257. have selected "normal display speed" DDIR will run in 25 line mode ONLY.
  258.  
  259.  
  260. THE LEGAL STUFF
  261. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  262.  
  263. The author makes no warranty that the software in this package
  264. will work with your particular hardware configuration.  You use the
  265. programs entirely at your own risk, and the author will not be held
  266. liable for any damage caused to your hardware or software through
  267. use of this software, or for any other effects, direct or indirect,
  268. of using the software.
  269.  
  270. Legalities aside, you should not run into difficulties with this
  271. software.
  272.  
  273.  
  274. SHAREWARE
  275. ▀▀▀▀▀▀▀▀▀
  276.  
  277. These programs are distributed as shareware, AND ARE NOT CRIPPLED!!.
  278. (Editorial note: I don't support "crippleware" - I want to know
  279. EXACTLY what I'm expected to pay for! Crippleware is, in my opinion,
  280. like test driving a Mercedes that's been fitted with a two-stroke engine!
  281. There, that's said - but each to his own.)
  282.  
  283. You do not have to register as a user, nor are you under any
  284. obligation to buy the program(s).  However, they are not free, and in
  285. the spirit of shareware, you are requested to make a small
  286. donation to the author if you find the software in this package useful,
  287. and if you continue to use it after an evaluation period of 30 days. This
  288. would both fulfill your moral obligation and help ensure the viability of
  289. the shareware concept, from which we all benefit. If you choose not to pay,
  290. you are asked to remove the program files from your computer.
  291.  
  292. The suggested contribution is $20, but less (or more!) would be fine. Pay what
  293. you think the software is worth to you.  If you pay the recommended amount,
  294. I will send you a diskette with the latest version plus some other
  295. sdhareware and freeware, including trhe shareware utilities2COL/JETCOL by
  296. Tony Caine).  Please specify the disk size (5 1/4 or 3 1/2").
  297.  
  298. Should you decide to make a contribution, please remit to:
  299.  
  300.                    Malcolm Drury
  301.                    11 Adele Crescent
  302.                    Nepean
  303.                    ON  K2J 2T7
  304.                    Canada
  305.  
  306. Internet drury@gsc.emr.ca
  307. Compuserve 70574,3457
  308.  
  309. Bank notes would be fine, as would international money orders and US or
  310. Canadian checks.  Thank you.  Please tell me where you got the software
  311. from (this helps me in knowing where to post updates), and, most
  312. importantly, which version it is.
  313.  
  314. Please contact me if you wish to negotiate site licenses.
  315.  
  316. IF YOU HAVE PREVIOUSLY PAID FOR AN EARLIER VERSION  -  THANKS, AND
  317. OF COURSE YOU ARE NOT EXPECTED TO PAY AGAIN. YOUR INPUT, COMMENTS
  318. ETC. ARE, OF COURSE, ALWAYS WELCOME.
  319.  
  320. Please note that at the low contribution requested, I cannot provide DIRECT
  321. technical support, nor automatically send upgrades, should they
  322. become available. If you have comments, questions, bug reports etc., please
  323. leave a message at my Compuserve or INTERNET address, or write to me via
  324. snail mail.  I will endeavor to fix any problems you might encounter.
  325. Those who have paid are, of course, entitled to obtain the latest version
  326. from the BBS of their choice and consider it a fully registered version.
  327. My software will NEVER be crippled, nor will it ever contain "nag" screens.
  328.  
  329. The software is supplied on an "as is" basis. You are free to distribute
  330. this software package provided that you distribute the ENTIRE package,
  331. including this documentation file. (This is necessary for others to be able
  332. to use it properly.  I've downloaded too many shareware packages that had
  333. been posted without accompanying documentation!).
  334.  
  335. I hope you find this package useful.
  336.  
  337.  
  338. Malcolm Drury
  339. November 11th, 1994
  340.  
  341.  
  342. HOW TO OBTAIN VIEW
  343. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  344.  
  345. VIEW is available on many BBS and on Compuserve/Ziffnet (VWFILE.ZIP
  346. in ZNT:TIPS and CIS:IBMAPPS).  If you wish to obtain a registered copy
  347. directly from me, please add $20 to your contribution (this is a specially
  348. discounted price).  Alternatively, get it from your BBS and "try before you
  349. buy" just as you are doing with DDIR.  From your favorite BBS just do a
  350. search on "VIEW??.*" As of this date the current version is 9.7a.
  351.  
  352. ********************************************************************************
  353.  
  354.                   Look for the following shareware on this BBS
  355.  
  356. VGAPAL40.ZIP - customize up to 4 VGA text color palettes, choosing from more
  357.              than 260,000 colors! (And see how many you can actually discern!).
  358.              One palette can be used to create a small (2k) TSR program that
  359.              maintains your chosen scheme.  Alternatively, you can set any of
  360.              the palettes, or a grey-scale scheme, from a non-TSR if
  361.              memory or loading a TSR is a problem. (On Compuserve/Ziffnet
  362.              in ZNT:TIPS as vgacus.zip)
  363.              BBS search: vgapal??.zip
  364.  
  365.  
  366. DSPACE64.ZIP - shows graphically hard disk space installed, used and free,
  367.                for all drives, and shows drive type (local, remote, RAM etc.);
  368.                second program shows graphically space on designated drive
  369.                (including floppy), and reports on installed and available
  370.                RAM, including XMS and EMS memory. (On Compuserve/Ziffnet
  371.                in ZNT:TIPS as dskspc.zip)
  372.                BBS search: dspace??.zip
  373.  
  374. VIEW97A.ZIP  - file viewer for WordPerfect 5.0 - 6.0, ASCII, Ami Pro and
  375.                Word (DOS 4/5 and Windows 1/2); includes text search,
  376.                printing full or partial file, etc.  (On Compuserve as
  377.                VWFILE.ZIP in ZNT:TIPS).  BBS search:  view???.zip.
  378.  
  379. You can also find 2COL and JETCOL on many BBS and on Compuserve.  Search on
  380. 2COL??.ZIP and JETCOL??.ZIP.
  381.  
  382. IF YOU DO NOT FIND ANY OF THESE, LEAVE ME A MESSAGE! I'LL BE HAPPY TO SEND
  383. THEM TO YOU, BUT IN THE INTERESTS OF CUTTING DOWN CONNECT TIME WOULD
  384. PREFER TO USE INTERNET. THAT WOULD REQUIRE YOU TO HAVE THE UUDECODE.EXE
  385. PROGRAM, WHICH SHOULD BE AVAILABLE ON ANY BBS YOU USE.
  386.  
  387. CIS 70574,3457
  388. INTERNET drury@gsc.emr.ca
  389.  
  390. ===========================================================================
  391.  
  392. This document was prepared using the BOXER (TM) version 6.0a text editor.
  393.