home *** CD-ROM | disk | FTP | other *** search
/ Rat's Nest 1 / ratsnest1.iso / dos / dutils / ndir177.arj / NDIR.DOC < prev    next >
Text File  |  1992-02-12  |  11KB  |  284 lines
  1.  
  2.  
  3.                              NewDIR, Version 1.77
  4.  
  5.  
  6.                         The Ultimate Directory Program
  7.  
  8.  
  9.  
  10.                                  Written by:
  11.  
  12.                              Daniel D. Miller
  13.                              931 S. Clover Avenue
  14.                              San Jose, CA  95128
  15.  
  16.  
  17. This program, NDIR.EXE, and its associated utilities are hereby released 
  18. to the public domain, though I retain the copyrights on them.  Please
  19. feel free to distribute it on bulletin boards and to anyone who seems
  20. like they might like it.
  21.  
  22. ***************************************************************************
  23.  
  24.                       NDIR.EXE - The directory lister.
  25.  
  26. This version provides the following modifications:
  27.  
  28.         - A modified NO-SORT option (-z) is now implemented.
  29.           I say "modified", because it will only work on a straight,
  30.           single filespec search.  If you ask for NDIR -Z *.TXT *.DOC, 
  31.           it won't work right.  However, since this is usually used
  32.           for looking at an entire directory, that should be fine.
  33.           Let me know if it's not, for some reason.
  34.  
  35.         - Some obscure bugs were fixed in file exclusion handling.
  36.         - Some obscure bugs were fixed in duplicate-filespec handling.
  37.         - The directory-tree display has been widened, so that
  38.           directories larger than 100 megabytes now display correctly.
  39.         - The directory-tree totals didn't include system/hidden/read-
  40.           only files, nor did they include the sizes of the subdirectories.
  41.           That's now fixed.
  42.  
  43. Details are included in the revision file NDIR.HST.
  44.  
  45. ***************************************************************************
  46.  
  47.                                  NDIRMOD.EXE
  48.  
  49. NDIRMOD is a configuration program that allows you to change any of the
  50. NDIR options, permanently, in NDIR.EXE.  It also allows you to add to or 
  51. delete from the list of extensions which have special colors, as well 
  52. as setting these colors.
  53.  
  54. ***************************************************************************
  55.  
  56.                                  NDINSTAL.EXE
  57.  
  58. NDINSTAL is only required if you are upgrading a previous version of 
  59. NDIR.  It copies your existing configurations from the old version to
  60. the new one, so you won't have to run NDIRMOD every time you upgrade.
  61. If you don't already have a previous version of NDIR, NDINSTAL will rename
  62. NDIRNEW to NDIR for you, or you can do so yourself.
  63.  
  64. ***************************************************************************
  65.  
  66.                        REVISION LISTS - WHAT A CONCEPT!!
  67.  
  68. Why I've been so lazy, I can't say, but up until 1992, I've
  69. never had a revision list.  I didn't even keep track on my own of
  70. what I changed from version to version!!  It's really sad... Anyway,
  71. as of version 1.76, the NDIR distribution now contains a revision
  72. list (NDIR.HST) which tells what I've changed from version to version.
  73. Sorry it took so long.
  74.  
  75. ***************************************************************************
  76.  
  77.  
  78.          WHAT DOES NDIR DO THAT EVERY DIR LISTER DOESN'T ? ?
  79.  
  80. Here are some of the features of NDIR, a summary of which can be
  81. obtained by typing NDIR -? :
  82.  
  83. - Full color file display.
  84.  
  85. - List executable files only (.BAT, .COM, .EXE) 
  86.  
  87. - Full control over display format 
  88.   (pause-on-full-screen, clear-screen-before-listing, 
  89.    select number of columns and amount of file info shown).
  90.  
  91. - File exclusion (list all files EXCEPT *.ult, for example).
  92.  
  93. - Full directory tree, showing size of current directory
  94.   as well as current directories PLUS subdirectories.
  95.  
  96. - List files separately by extension.
  97.  
  98. - Show ALL files, including read-only, hidden and system files.
  99.  
  100. - A separate configuration program, for customizing default options,
  101.   as well as all color and extension settings.
  102.  
  103. - EGA 43-line support (50 lines on VGA).
  104.  
  105. - A "batch" mode which can assist you in creating batch files.
  106.  
  107.  
  108.      WHAT DOESN'T NDIR DO THAT EVERY DIR LISTER DOES OR DOESN'T ? ?
  109.  
  110. Functions that are NOT supported (because I ran out of time before other
  111. projects developed), but may be added if interest is shown, are:
  112.  
  113. - Support for global subdirectories; i.e., search for files across all
  114.   subdirectories under current default. The framework for implementing 
  115.   this is in place, but it would take a fair amount of work to finish 
  116.   it, and I'm waiting to see if anyone cares.
  117.  
  118. - Ability to search for files with only a certain attribute or combination
  119.   of attributes.
  120.  
  121. - Sort directory TREE listing by dir name or directory size.
  122.  
  123. - Anything else that I didn't think of, and nobody's requested.
  124.  
  125.  
  126.  
  127.                  WHO ARE YOU ? ?  (who-who. who-who.)
  128.  
  129. I am an Electronic Engineer, living near San Jose, CA.  My professional
  130. orientation is digital circuit design, but I have a strong interest in
  131. computer science, with professional experience with BASIC, PASCAL, C, 
  132. numerous assemblers, and DBASE III (don't laugh).  
  133.  
  134. NDIR, NDIRMOD, and NDINSTAL were written in BORLAND C++ Version 2.0, 
  135. with assistance from the excellent CXL extended libraries.
  136. These excellent libraries, unfortunately, are no longer available
  137. from the original author, and the TCXL libraries which replaced CXL,
  138. under new ownership, haven't been very reliable for me, so I've
  139. stayed with CXL.  I am also gradually converting over to the 
  140. SpontaneousAssembly libraries, which explains the small drop in 
  141. file size from previous versions.
  142.  
  143. If anyone has suggestions for anything else that you think should be in 
  144. this program, please mail them to me at the address below.  If you really
  145. like NDIR, a contribution of $10 or so would be appreciated.  
  146. Source code is no longer available because of my heavy reliance on
  147. external libraries, which I cannot provide source for.
  148.  
  149. ENJOY!!!!
  150.  
  151.  
  152.  
  153. NDIR Command-Line switches
  154. --------------------------
  155.  
  156. This is a list of the command-line switches supported by NDIR.
  157.  
  158. This list can also be obtained by typing 'NDIR /?'
  159.  
  160. USAGE:  NDIR <filespecs> -options or /options !<exclusions>
  161.  
  162. NOTE: items with a * after the flag are TOGGLES
  163.  
  164.  OPTIONS                      FUNCTIONS                        DEFAULT
  165.    -x *     List executables only (.EXE,.COM,.BAT).              off
  166.    -a *     List ALL files (hidden, system, read-only, etc.).    ON
  167.    -c *     Clear screen before listing.                         ON
  168.    -p *     Pause on full screen.                                off
  169.    -d *     Display directory TREE.                              off
  170.    -e       Sort by extension.                                   ON
  171.    -n        "   by name.                                        off
  172.    -s        "   by file size, smallest first.                   off
  173.    -t        "   by Date, oldest first.                          off
  174.    -r *     Reverse normal sort order.                           off
  175.    -1,-l    Display one column,   with name/size/date/attr.      off
  176.    -2          "    two   "   ,   with name/size/date.           off
  177.    -4          "    four  "   ,   with name/size.                ON
  178.    -6          "    six   "   ,   with name only.                off
  179.    -?          "    HELP screen.                                 off
  180.    -k *     Toggle color mode. (non-color mode is redirectable)  ON
  181.    -j *     Use standard ASCII (for redirection). (forces -k)    off
  182.    -5 *     Displays data in 43/50 lines, stay there afterwards. off
  183.    -3 *     Displays data in 43/50 lines, then return to 25.     off
  184.    -q *     List files separately by extension.                  off
  185.    -u *     List filenames in UPPERCASE.                         off
  186.    -v       Display registration/update information.             off
  187.    -g *     List directories FIRST.                              ON
  188.    -h *     List files horizontally.                             off
  189.    -f *     List files only (No directories).                    off
  190.  
  191.    -b       Batch mode;  files listed in one column.             off
  192.             (This format can be redirected to a batch file)
  193.    ["string"  specifies a string BEFORE each filename (Batch mode)
  194.    ]"string"  specifies a string AFTER  each filename (Batch mode)
  195.  
  196.  
  197.                      
  198. NOTES on using command-line switches:
  199. -------------------------------------
  200. NDIR's functionality can be modified in three ways:
  201.  
  202. 1. Type NDIR <options> as documented above.
  203.  
  204. 2. Run the NDIRMOD program (supplied with NDIR) to permanently customize
  205.    NDIR exactly the way you want it.  
  206.  
  207. 3. Use the NDIR ENVIRONMENT VARIABLE to specify NDIR options.
  208.    At the DOS prompt, type SET NDIR=-options
  209.    This method is convenient when you wish to make temporary, on-the-fly
  210.    modifications to NDIR's configuration, without running NDIRMOD.
  211.  
  212.  
  213. Order of interpretation for command options:
  214.  
  215. The environment variable will override any default options in NDIR.EXE.
  216. Options typed on the command line will override both the default options
  217. AND the options in the environment variable.
  218.  
  219.  
  220. Notes on using Batch mode (-b) :
  221. --------------------------------
  222. The purpose of batch mode is to assist you in creating DOS batch files.
  223. The output from NDIR in batch mode is a single-column list of the 
  224. requested filenames, with no other information.  This output is written
  225. using BIOS functions, so the output can be redirected to printer or file.
  226.  
  227. In addition, NDIR provides a method for inserting text before and after
  228. each filename in the listing.  The LEFT square bracket ([) is used to
  229. indicate a string PRECEDING each filename.  The RIGHT square bracket (])
  230. is used to indicate a string FOLLOWING each filename.  This is easy to
  231. remember if you think of the filename enclosed in 
  232. square brackets ( [filename] ).  Then it's easy to remember which string goes
  233. in front of (filename) and which goes after.
  234.  
  235. Let's look at some examples of NDIR batch-mode commands.
  236. Assume that the following files are in the current subdirectory;
  237.  
  238. NDINSTAL.C          NDINSTAL.EXE
  239. NDIR.C              NDIR.DOC
  240. NDIR.EXE            NDIR.HLP
  241. NDIR.TXT            NDIRMOD.C
  242. NDIRMOD.EXE         NDIRSRC.BAT
  243. NDIRZIP.BAT         NUPDATE.BAT
  244.  
  245. Here are some sample commands and their outputs:
  246. ------------------------------------------------
  247.  
  248.    NDIR -B *.BAT
  249.  
  250. This will list all BAT files, in single-column, with no other information.
  251. The output looks like:
  252.  
  253. ndirscr.bat
  254. ndirzip.bat
  255. nupdate.bat
  256.  
  257. ------------------------------------------------
  258.  
  259.    NDIR -B *.TXT *.DOC ["PRINT " >printit.bat
  260.  
  261. The output from this command will be a list of all DOC and TXT files,
  262. preceded by "print ", and these lines will be written to a file 
  263. called PRINTIT.BAT .  The contents of PRINT.BAT will be:
  264.  
  265. print ndir.doc
  266. print ndir.txt
  267.  
  268. ------------------------------------------------
  269.  
  270.    NDIR -B *.EXE *.BAT ["COPY " ]" B:" >copyexec.bat
  271.  
  272. This will list all EXE and BAT files, preceded by 'copy ' and followed by ' b:'.
  273. The output of NDIR will be written to COPYEXEC.BAT.
  274. The output:
  275.  
  276. copy ndinstal.exe b:
  277. copy ndir.exe b:
  278. copy ndirmod.exe b:
  279. copy ndirsrc.bat b:
  280. copy ndirzip.bat b:
  281. copy nupdate.bat b:
  282.  
  283. ------------------------------------------------
  284.