home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 19 / CD_ASCQ_19_010295.iso / vrac / zdir21.zip / ZDIR.DOC < prev    next >
Text File  |  1994-10-24  |  68KB  |  1,436 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                       ZANYSOFT DIR
  7.  
  8.                                        Version 2.1
  9.  
  10.                                     October 24, 1994
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                                    Christopher Kirmse 
  19.                                         ZanySoft
  20.                                     9303 Arabian Ave.
  21.                               Vienna, Virginia  22182-2028
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.                        Copyright (C) 1990, 1994 Christopher Kirmse
  32.                                    All rights reserved
  33.  
  34. Table of Contents
  35.  
  36. 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   1
  37.        1.1 Features . . . . . . . . . . . . . . . . . . . . . . . . . . . .   1
  38.        1.2 Terms in this manual . . . . . . . . . . . . . . . . . . . . . .   2
  39.  
  40. 2. Using shareware. . . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  41.        2.1 Disclaimer - agreement . . . . . . . . . . . . . . . . . . . . .   3
  42.        2.2 Contacting the author. . . . . . . . . . . . . . . . . . . . . .   4
  43.  
  44. 3. Quick-start. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  45.  
  46. 4. Running ZDir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  47.        4.1 The file listing . . . . . . . . . . . . . . . . . . . . . . . .   7
  48.        4.2 Path specification . . . . . . . . . . . . . . . . . . . . . . .  10
  49.               4.2.1 Displaying path specs . . . . . . . . . . . . . . . . .  11
  50.        4.3 Volume information . . . . . . . . . . . . . . . . . . . . . . .  12
  51.  
  52. 5. ZDir options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  53.        5.1 Information options. . . . . . . . . . . . . . . . . . . . . . .  13
  54.        5.2 Command options. . . . . . . . . . . . . . . . . . . . . . . . .  13
  55.               5.2.1 Write to file . . . . . . . . . . . . . . . . . . . . .  13
  56.               5.2.2 File find . . . . . . . . . . . . . . . . . . . . . . .  14
  57.               5.2.3 Tree display  . . . . . . . . . . . . . . . . . . . . .  15
  58.               5.2.4 User extensions . . . . . . . . . . . . . . . . . . . .  16
  59.               5.2.5 Attribute changing. . . . . . . . . . . . . . . . . . .  17
  60.        5.3 File listing options . . . . . . . . . . . . . . . . . . . . . .  17
  61.  
  62. 6. Configuration:  ZDircfg. . . . . . . . . . . . . . . . . . . . . . . . .  19
  63.        6.1 Using ZDircfg. . . . . . . . . . . . . . . . . . . . . . . . . .  19
  64.        6.2 ZDircfg menus. . . . . . . . . . . . . . . . . . . . . . . . . .  20
  65.               6.2.1 Load ZDir configuration . . . . . . . . . . . . . . . .  20
  66.               6.2.2 Save ZDir configuration . . . . . . . . . . . . . . . .  21
  67.               6.2.3 Extension editing . . . . . . . . . . . . . . . . . . .  22
  68.               6.2.4 Color editing . . . . . . . . . . . . . . . . . . . . .  22
  69.               6.2.5 Default editing . . . . . . . . . . . . . . . . . . . .  23
  70.                      6.2.5.1 Search options . . . . . . . . . . . . . . . .  24
  71.                      6.2.5.2 File list choices. . . . . . . . . . . . . . .  25
  72.                      6.2.5.3 Output format. . . . . . . . . . . . . . . . .  26
  73.  
  74. 7. Registration form. . . . . . . . . . . . . . . . . . . . . . . . . . . .  28
  75.  
  76. 1. Introduction
  77.  
  78. ZanySoft Dir (ZDir) is an easy to use and very powerful directory
  79. lister.  The main purpose of ZDir is to replace the generic DIR
  80. command with a fast, easily readable display with more
  81. functionality.  It can organize the file listing with many sorting
  82. options, color files based upon their extension, choose how many
  83. columns to use in the display, find files, draw a tree of the
  84. directory structure, use full-scale wildcards, and much more. 
  85. Besides being powerful and easy to use, ZDir is also easy to
  86. configure with the included configuration program ZDircfg.  It is
  87. very easy for a novice computer user to learn how to use ZDir, but
  88. has many features that expand upon the basic directory listing
  89. capability.
  90.  
  91. Everything about ZDir is explained in this manual.  Even if you are
  92. not interested in reading it all now, at least look at section 3,
  93. the quick-start.  It is a general overview of how to use ZDir and
  94. what it does, and only takes a couple minutes to read.
  95.  
  96.  
  97.  
  98. 1.1 Features
  99.  
  100. The following list shows some of the many features of ZDir:
  101.  
  102. o      It is extremely fast.
  103.  
  104. o      It is fully configurable--every color, extension, and default
  105.        is set by the user.
  106.  
  107. o      It colors each filename based upon its attribute and
  108.        extension.
  109.  
  110. o      It sorts the listing by filename, extension, size, date, and
  111.        time, ascending or descending.
  112.  
  113. o      It can group directory entries at the beginning or end of the
  114.        display.
  115.  
  116. o      It can search for files anywhere on a disk.
  117.  
  118. o      Wildcards may be placed anywhere in the filespec and are
  119.        correctly interpreted.
  120.  
  121. o      It gives totals for all found files at the end of the display.
  122.  
  123. o      It can color all information about each file the same color.
  124.  
  125. o      It can write a plain-text version of the listing to a file or
  126.        to the printer.
  127.  
  128. o      It prints out the current date and time at the top of the
  129.        display.
  130.  
  131. o      It shows the volume label and serial number, if they exist.
  132.  
  133. o      It fully supports any size text screen that your video card
  134.        supports, including 43/50 line mode on EGA/VGA systems.
  135.  
  136. o      It is extremely small--even with all these features, it is less
  137.        than 13k in size.
  138.  
  139.  
  140.  
  141. 1.2 Terms in this manual
  142.  
  143. Several conventions are used in this manual, and they are described
  144. as follows:
  145.  
  146. o      The Enter or Return key on the keyboard is referred to as
  147.        <Enter>.
  148.  
  149. o      All text that is meant to be typed by the user is in bold
  150.        type.
  151.  
  152. o      Text printed on the screen by the computer is in courier type.
  153.  
  154. o      The terms "window", "box", and "menu" are used somewhat
  155.        interchangeably in this manual, but the actual meaning should
  156.        be clear from the context.
  157.  
  158. o      Menu sequences in ZDircfg are in italics and referred to by
  159.        name, with -> separating each menu level, such as Default
  160.        edit->Search options->Put * before filespec, where Default
  161.        edit is the first menu choice, Search options is the second
  162.        menu choice, and Put * before filespec is the third menu
  163.        choice.
  164.  
  165. o      Some of these conventions are not detectable in the online
  166.        version of the manual.
  167.  
  168.  
  169. 2. Using shareware
  170.  
  171. Shareware distribution gives users a chance to try software before
  172. buying it. If you try a Shareware program and continue using it,
  173. you are expected to register. Individual programs differ on
  174. details--some request registration while others require it, some
  175. specify a maximum trial period. With registration, you get anything
  176. from the simple right to continue using the software to an updated
  177. program with printed manual.
  178.  
  179. Copyright laws apply to both Shareware and commercial software, and
  180. the copyright holder retains all rights, with a few specific
  181. exceptions as stated below. Shareware authors are accomplished
  182. programmers, just like commercial authors, and the programs are of
  183. comparable quality. (In both cases, there are good programs and bad
  184. ones!) The main difference is in the method of distribution. The
  185. author specifically grants the right to copy and distribute the
  186. software, either to all and sundry or to a specific group. For
  187. example, some authors require written permission before a
  188. commercial disk vendor may copy their Shareware.
  189.  
  190. Shareware is a distribution method, not a type of software. You
  191. should find software that suits your needs and pocketbook, whether
  192. it's commercial or Shareware. The Shareware system makes fitting
  193. your needs easier, because you can try before you buy. And because
  194. the overhead is low, prices are low also. Shareware has the
  195. ultimate money-back guarantee--if you don't use the product, you
  196. don't pay for it.
  197.  
  198.  
  199. 2.1 Disclaimer - agreement
  200.  
  201. Users of ZDir must accept this disclaimer of warranty:  "ZDir is
  202. supplied as is.  The author disclaims all warranties, expressed or
  203. implied, including, without limitation, the warranties of
  204. merchantability and of fitness for any purpose. The author assumes
  205. no liability for damages, direct or consequential, which may result
  206. from the use of ZDir."
  207.  
  208. ZDir is a "shareware program" and is provided at no charge to the
  209. user for evaluation.  Feel free to share it with your friends, but
  210. please do not give it away altered or as part of another system. 
  211. The essence of "user-supported" software is to provide personal
  212. computer users with quality software without high prices, and yet
  213. to provide incentive for programmers to continue to develop new
  214. products.
  215.  
  216. If you find this program useful and find that you are using ZDir
  217. and continue to use ZDir after a reasonable trial period, you must
  218. make a registration payment of $10 to Christopher Kirmse.  The $10
  219. registration fee will license one copy for use on any one computer
  220. at any one time.  You are then authorized to use your copy forever;
  221. it is as if you had bought it at a store.  Anyone else may use your
  222. copy of ZDir, but only on a trial basis.  Also, your registration
  223. name and number sent to you when you register is for you only, and
  224. only you may use it.  To register ZDir, just fill out the
  225. registration form in section 7 at the end of this document, and
  226. send it in.  Every registered user of ZDir will receive a minimum
  227. of three months of support through the mail.
  228.  
  229. If your version of ZDir did not come with the following files, then
  230. it is not the official version of ZDir:  ZDir.com, ZDir.doc,
  231. ZDircfg.exe, and Readme.doc.  If your version of ZDir is not
  232. complete, please contact whoever you received it from to remove it
  233. from their system.  To guarantee that you have the latest and
  234. complete version of ZDir, either send a note and $5 (see section 7--
  235. you don't need to register to get a disk), or preferably, call up
  236. CompuServe and download ZDirxy.zip, where x.y would be the version
  237. number.  See section 2.2 for details.
  238.  
  239. Commercial users of ZDir must register and pay for their copies of
  240. ZDir within 30 days of first use or their license is withdrawn. 
  241. Site-license arrangements may be made by contacting Christopher
  242. Kirmse.  The standard site-license is $10 for each of the first ten
  243. copies of ZDir, and $5 for every additional copy at the same site.
  244.  
  245. You are encouraged to pass a copy of ZDir along to your friends for
  246. evaluation.  Please encourage them to register their copy if they
  247. find that they can use it.
  248.  
  249. All trademarks referenced in this document are the property of
  250. their respective owners.
  251.  
  252.  
  253.  
  254. 2.2 Contacting the author
  255.  
  256. There are several ways to contact Christopher Kirmse, the author of
  257. ZDir.  The easiest way is through the US postal service--write to
  258. the address on the first page of this document.  He can also be
  259. contacted through Internet, at the address zanysoft@vt.edu
  260. (through May 1995).  The newest version of ZDir will always be on
  261. CompuServe.
  262.  
  263.  
  264. 3. Quick-start
  265.  
  266. To get a feel for how to use ZDir, just type ZDir at the DOS prompt
  267. (typically C> or C:\>).  It will instantly display a listing of the
  268. files in the current directory.  Assuming that the copy of ZDir
  269. used has the initial defaults, the display will look something like
  270. the following:
  271.  
  272. 1:52:04pm                    ZDir v2.1, by ZanySoft            January 21, 1994
  273. Path: C:\*.*                                                    Volume - Home 1
  274. ═══════════════════╤═══════════════════╤═══════════════════╤═══════════════════
  275. 123R3         <Dir>│GAMES         <Dir>│V3            <Dir>│COMMAND  PIF    545
  276. BAT           <Dir>│JUNK          <Dir>│WINAPP        <Dir>│CONFIG   BAK   1480
  277. BCPP          <Dir>│LABEL         <Dir>│WINDOWS       <Dir>│CONFIG   SYS   1697
  278. BOB           <Dir>│LASM          <Dir>│WP            <Dir>│HIMEM    SYS  11304
  279. C600          <Dir>│NEWSTER       <Dir>│ZD86          <Dir>│IBMBIO   COM  17867
  280. CASTLE        <Dir>│PBRUSH        <Dir>│ZDIR          <Dir>│IBMDOS   COM  40082
  281. CHRIS         <Dir>│Q             <Dir>│386SPART PAR   5.1M│Home 1        <Vol>
  282. CTR           <Dir>│SA            <Dir>│AUTOEXEC BAK    297│
  283. DOWNLOAD      <Dir>│TAXI          <Dir>│AUTOEXEC BAT    285│
  284. DRDOS         <Dir>│UTILS         <Dir>│COMMAND  COM  32816│
  285. ═══════════════════╧═══════════════════╧═══════════════════╧═══════════════════
  286.     10 files totalling 5,226,373 bytes using 5,236,736 bytes of disk space.
  287.       17,555,456 bytes available out of 88,842,240 total bytes on drive C:
  288.  
  289. The first line contains the current time, a message telling the
  290. current ZDir version, and the current date.  The second line shows
  291. the path specification of the files listed (described in detail in
  292. section 4.2).  On the right side of the second line the volume
  293. label and serial number are displayed, it they exist.  In this
  294. case, there is a volume label, but no serial number.
  295.  
  296. The main area of the display is surrounded by graphic lines.  It
  297. contains the list of the files which matched the file
  298. specification, in this case *.*.  As a default, all the directories
  299. are listed first, sorted by the directory name, followed by the
  300. files, sorted by name.  In the default setting ZDir adjusts the
  301. number of columns in the display based upon the number of
  302. directories and files in the directory, and in this case ZDir
  303. decided to display the listing in four columns.  Your display may
  304. be different if you have more or less files in the listed
  305. directory.  In four column listings, only the filename and file
  306. size are listed.  Notice the size of the file 386SPART.PAR
  307. file■5.1M.  This means 5.1 Megabytes, or 5,100,000 bytes.  This is
  308. truncated at the tenth's place.  When not displaying the listing in
  309. one column, all file sizes larger than 1 million bytes are printed
  310. in this manner.
  311.  
  312. The final two lines of the display give totals information.  The
  313. first summary line tells how many files were listed (optionally
  314. including directories), the sum of all the file sizes, and how much
  315. disk space the files actually consume on the disk.  The second line
  316. (which can be optionally not printed) shows how much free space is
  317. left on the disk and the total storage amount of the disk that the
  318. files were listed from.
  319.  
  320. ZDir can be used as a straight replacement of the DOS DIR command,
  321. but to take full advantage of its power you need to learn how to
  322. use its many features.  Advanced users can probably learn how to
  323. use ZDir by trial and error and by referring to the help screen
  324. (type ZDir /? to display the help screen).  This manual describes
  325. how to use all the features of ZDir, including configuring ZDir
  326. with ZDircfg, and is useful for anyone learning about ZDir.
  327.  
  328. 4. Running ZDir
  329.  
  330. The technical description for running ZDir is 
  331.  
  332.        ZDir [options] [path spec] [options]
  333.  
  334. The items in brackets are optional.  This means that the simplest
  335. way to run ZDir is just to type ZDir from the command line:
  336.  
  337. C:\>ZDir<Enter>
  338.  
  339. (<Enter> means to hit the Enter or Return key on the keyboard.)
  340.  
  341. Options are single letters preceded by a forward slash (/), such as
  342. /T or /U.  The path spec and options can be typed in upper or lower
  343. case; ZDir is not case sensitive.  Options are described in section
  344. 5.  The entire string of text following the word ZDir is called the
  345. command line.  In the following example, the command line is  /u
  346. *.exe /1 /x:
  347.  
  348. C:\>ZDir /u *.exe /1 /x<Enter>
  349.  
  350. Usually it is easier to put the options all together, either before
  351. or after the path spec, but they can be split up and put in both
  352. places.
  353.  
  354. ZDir displays a file listing with header information and total
  355. lines unless there is the option /? or /H on the command line.  The
  356. display works in any text mode, including Super VGA text modes such
  357. as 132x60.  If the screen is in a standard graphics mode, then ZDir
  358. resets the screen to 25 rows by 80 columns.  Super VGA graphic
  359. modes are not standard and cannot be detected, so ZDir will not
  360. print a correct display if the screen is in a Super VGA graphics
  361. mode.  ZDir will work with any display, including monochrome, CGA,
  362. EGA, VGA, Super VGA, and XGA.
  363.  
  364.  
  365.  
  366. 4.1 The file listing
  367.  
  368. The main area of the display is a listing of filenames, directory
  369. names, and if it exists, the volume label.  For the rest of this
  370. section, the terms file and filename are used in a generic sense,
  371. meaning every directory entry, including not only names of files
  372. but directories and volume labels as well.  The most trivial
  373. display is when there are no files, in which case ZDir prints No
  374. files found in the main area of the display.  In every other case,
  375. the display is separated into either 1, 2, 3, 4, or 6 columns.  The
  376. number of columns is determined by the configuration setting
  377. Default edit->File list choices->Number of columns, discussed in
  378. section 6.2.5.2, and the command line, discussed in section 5.3.
  379.  
  380. The number of columns that are used to display the file listing
  381. determines what information is given about each file.  Obviously,
  382. as the number of columns across the screen increases, the amount of
  383. information about each file decreases.  In one column mode,
  384. everything about the file is shown, with plenty of room for large
  385. file sizes with commas, and the time in 12-hour format with
  386. seconds.  In six column mode, there is nothing except the filename. 
  387. The following chart shows what is included depending upon the
  388. number of columns used in the display:
  389.  
  390.                        ╔═══════════════════════════════════════════╗
  391.     ╔══════════════════╣             Number of columns             ║
  392.     ║ File information ║  1       2         3         4        6   ║
  393.     ╟──────────────────┼──────┬────────┬─────────┬─────────┬───────╢
  394.     ║ Name             │ Yes  │  Yes   │   Yes   │   Yes   │  Yes  ║
  395.     ╟──────────────────┼──────┼────────┼─────────┼─────────┼───────╢
  396.     ║ Size             │ Yes  │  Yes   │   Yes   │   Yes   │  No   ║
  397.     ╟──────────────────┼──────┼────────┼─────────┼─────────┼───────╢
  398.     ║ Attribute        │ Yes  │  Yes   │   Yes   │   No    │  No   ║
  399.     ╟──────────────────┼──────┼────────┼─────────┼─────────┼───────╢
  400.     ║ Date and time    │ Yes  │  Yes   │   No    │   No    │  No   ║
  401.     ╟──────────────────┼──────┼────────┼─────────┼─────────┼───────╢
  402.     ║ Disk space       │ Yes  │  No    │   No    │   No    │  No   ║
  403.     ║ used             │      │        │         │         │       ║
  404.     ║──────────────────┼──────┼────────┼─────────┼─────────┼───────╢
  405.     ║ Commas in        │ Yes  │  No    │   No    │   No    │  No   ║
  406.     ║ file sizes       │      │        │         │         │       ║
  407.     ║ 100,000 bytes    │      │        │         │         │       ║
  408.     ╚══════════════════╧══════╧════════╧═════════╧═════════╧═══════╝
  409.  
  410. For commas to be printed in file sizes ≥ 100,000 bytes, the option
  411. Default edit->Output format->Use commas in file size must be set to
  412. yes.
  413.  
  414. The filename is printed in two parts:  the normal part of the
  415. filename which can be up to eight characters in length, left
  416. justified in a field of eight spaces, followed by a space or a
  417. period (depending on the setting of Default edit->Output
  418. format->Print a . before extensions), followed by the up to three
  419. character extension.  The color of the filename is based upon
  420. whether the file is a hidden file and whether the extension matches
  421. any of the fifty set extensions (see section 6.2.3).
  422.  
  423. ZDir stores a table of fifty extensions and associated colors that
  424. it matches against each file.  If a file's extension matches one of
  425. the extensions in the table, then the file is displayed in the
  426. color associated with the extension.  Wildcards are allowed in the
  427. stored extensions, which are configured using ZDircfg.  If the file
  428. is actually a directory or if it is hidden, then the directory
  429. color or hidden color overrides the extension color and the file is
  430. not displayed in the extension color.  Depending on the setting of
  431. Default edit->File list choices->Entire entry in file color the
  432. rest of the directory entry is automatically displayed in the same
  433. color as the filename or in the color selected for each part of the
  434. directory entry.
  435.  
  436. File sizes are printed in every column mode except in six column
  437. mode.  They are displayed in either the same color as the file or
  438. in the color set in Color edit->File entry area->Size of file,
  439. depending on whether the entire file entry is the color of the file
  440. (set in Default edit->File list choices->Entire entry in file
  441. color).  If commas are set to be printed in file sizes, then if the
  442. file size is five or fewer digits (i.e., less than 100,000 bytes),
  443. then a comma separates the thousands from the hundreds place.  In
  444. one column mode, no matter what the file size, if commas are set to
  445. be added to file sizes, then commas separate every three digits of
  446. file sizes.  In any other column mode, file sizes 1,000,000 bytes
  447. and larger are displayed in terms of megabytes (one million bytes),
  448. such as 1.2M or 84.5M.
  449.  
  450. The attributes of each file are displayed in one, two, and three
  451. column mode.  The five attributes are described in section 5.2.5,
  452. but in short are archive, hidden, read-only, system, and network. 
  453. They are abbreviated in the display with the first letter■A, H, R,
  454. S, and N.  They are displayed in either the same color of the file
  455. or in the color set in Color edit->File entry area->Attributes. 
  456. (In two column mode, the network attribute touches the date if the
  457. month is two digits long (October, November, and December), because
  458. of lack of space.)
  459.  
  460. Every time that a file is written to, the date and time are saved
  461. with the file by DOS.  ZDir displays the most recent access date
  462. and time in one and two column modes.  The colors are determined by
  463. the setting in Color edit->File entry area->Date and Time, and
  464. whether or not the entire file entry is in the filename's color. 
  465. In one column mode, the time is displayed in 12 hour mode with an
  466. "a" or a "p" after the seconds signifying AM or PM.  In two column
  467. mode, the time is in 24 hour mode, and the seconds are not printed. 
  468. The dates are the same in either number of columns.
  469.  
  470. In one column mode, the actual space on disk used by each file is
  471. placed after the file size, in the color specified by Color
  472. edit->File entry area->Used disk space of file, or the color of the
  473. filename if the entire entry is in the filename's color.  To
  474. understand the difference between this number and the file size,
  475. the method of storing files on disk has to be explained.
  476.  
  477. Files are stored on disk as a chain of clusters, each of which
  478. contains part of the file.  The disk has a table which keeps track
  479. of which clusters belong to which files, and in what order. 
  480. Clusters are of fixed length on each disk, as small as 512 bytes
  481. and as large as 8192 bytes.  Because of the fact that clusters can
  482. belong to only one file, every file contains an integral number of
  483. clusters.  This means that most files, not being a multiple in size
  484. of the cluster size, use up more disk space than their actual size. 
  485. This accounts for the difference in the file size and the disk
  486. space used by a file.  The total lines at the bottom show both the
  487. file sizes and the file disk space used.
  488.  
  489.  
  490.  
  491. 4.2 Path specification
  492.  
  493. The path specification determines how ZDir searches the disk to
  494. determine which files to include in the file listing.  It contains
  495. three parts:  the disk drive, the path, and the file specification,
  496. called the filespec.  The path specification can be no longer than
  497. 63 characters, the maximum that DOS allows.
  498.  
  499. The disk drive is a letter followed by a colon--A:, C:, H:, etc.  A:
  500. and B: are usually floppy disk drives, C: is usually the first hard
  501. disk, while higher letters can be anything from a RAM disk to a CD-
  502. ROM to a network drive.  If the disk drive is typed as part of the
  503. path specification, then it is used in the search.  If it is
  504. omitted from the path specification, then the current disk drive is
  505. used.
  506.  
  507. The path is a string of directories and subdirectories, separated
  508. by backslashes (\).  If the path starts with a backslash, then the
  509. rest of the string is relative to the root, or top-level, directory
  510. on the drive.  If it does not start with a backslash, then the rest
  511. of the string is relative to the current directory on the disk
  512. drive.  If no path is specified in the path specification at all,
  513. then the current directory is used.
  514.  
  515. Like filenames, the filespec consists of two parts, the "normal"
  516. filename, which is one to eight characters long, and the extension,
  517. which is zero to three characters in length.  Letters of the
  518. alphabet and some symbols (such as !, $, and greek letters) are
  519. valid characters in the filespec.  Filespecs, and in fact all DOS
  520. filenames, are not case sensitive.  If only these alphabetic and
  521. symbol characters are part of the filespec, then ZDir will either
  522. match one file or not match any files, because either a file by
  523. that name exists or it does not.  To make a listing include more
  524. than one file the filespec must contain special characters called
  525. wildcards.
  526.  
  527. The wildcards characters are the asterisk, *, and the question
  528. mark, ?.  They can be placed in the "normal" part of the filespec,
  529. in the extension, or both.  The question mark matches all files
  530. that have any single character in the place of the question mark,
  531. or none at all.  The asterisk tells ZDir to match all files that
  532. have any string of characters in place of the asterisk.  This is
  533. just how DOS does file matching.  However, DOS has a fatal flaw
  534. when matching filespecs to filenames:  all characters following an
  535. asterisk in either part of the filename are ignored!  This means
  536. that perfectly valid filespecs, such as *Z*.*,  which should find
  537. all files containing a Z in the main part of the filename, actually
  538. find every file in the directory, as if the filespec were *.*!  For
  539. example, suppose the current directory contained the files
  540. BOOKS.TXT, BDN.EXE, and HERES.DOC.  Using the filespec *s.* with
  541. ZDir would include the files BOOKS.TXT and HERES.DOC, but the DOS
  542. DIR command would incorrectly translate the filespec to *.* and
  543. include all three files, even BDN.EXE!  ZDir's expanded wildcard
  544. capability corrects this mistake and uses the correct
  545. interpretation of the wildcard characters.
  546.  
  547. If no filespec was typed on the command line then ZDir uses *.*
  548. (all files) as the file spec.  If the filespec contains an
  549. extension, such as NONAME.WK1 or S*.H, then it uses the filespec
  550. exactly as specified on the command line.  If the filespec ends in
  551. a period, then it matches all files that match the "normal" part of
  552. the filename and have no extension.  If no extension or period are
  553. typed then ZDir adds wildcards depending upon how it is configured. 
  554. If the option Default edit->Search options->Put * before filespec
  555. is set to yes (expanded capability), then ZDir puts a * before the
  556. filespec, and a *.* afterwards (e.g, Z becomes *Z*.*).  If it is
  557. set to no (DOS compatibility), then only the trailing *.* is added
  558. (e.g., Z becomes Z*.*).
  559.  
  560. The chart below contains examples that illustrate many different
  561. scenarios that commonly occur using ZDir.  Assume that the
  562. directory tree of drive C: is as follows:
  563.  
  564.  
  565.  
  566.                            C:\
  567.                             └───────┬─BIN
  568.                                     ├─BATCH
  569.                                     │   └───────TEMP
  570.                                     └─TEMP
  571.  
  572.     ╔══════════════════════╦══════════╤════════════════════════╗
  573.     ║ Current directory:   ║          │                        ║
  574.     ║ C:\batch             ║          │                        ║
  575.     ╠══════════════════════╣ Setting  │                        ║
  576.     ║                      │ of Put * │                        ║
  577.     ║ Text on command line │ before   │ Path spec used by ZDir ║
  578.     ║                      │ filespec │                        ║
  579.     ╟──────────────────────┼──────────┼────────────────────────╢
  580.     ║ ZDir                 │ Yes, No  │ C:\batch\*.*           ║
  581.     ╟──────────────────────┼──────────┼────────────────────────╢
  582.     ║ ZDir C:\             │ Yes, No  │ C:\*.*                 ║
  583.     ╟──────────────────────┼──────────┼────────────────────────╢
  584.     ║ ZDir \               │ Yes, No  │ C:\*.*                 ║
  585.     ╟──────────────────────┼──────────┼────────────────────────╢
  586.     ║ ZDir D:\*.bat        │ Yes, No  │ D:\*.bat               ║
  587.     ╟──────────────────────┼──────────┼────────────────────────╢
  588.     ║ ZDir temp\all        │ Yes      │ C:\batch\temp\*all*.*  ║
  589.     ╟──────────────────────┼──────────┼────────────────────────╢
  590.     ║ ZDir temp\all        │ No       │ C:\batch\temp\all*.*   ║
  591.     ╟──────────────────────┼──────────┼────────────────────────╢
  592.     ║ ZDir C:wp.bat        │ Yes, No  │ C:\batch\wp.bat        ║
  593.     ╟──────────────────────┼──────────┼────────────────────────╢
  594.     ║ ZDir C:\batch\wp.bat │ Yes, No  │ C:\batch\wp.bat        ║
  595.     ╟──────────────────────┼──────────┼────────────────────────╢
  596.     ║ ZDir C:\bin\.exe     │ Yes, No  │ C:\bin\*.exe           ║
  597.     ╟──────────────────────┼──────────┼────────────────────────╢
  598.     ║ ZDir \temp\fdr       │ Yes      │ C:\temp\*fdr*.*        ║
  599.     ╟──────────────────────┼──────────┼────────────────────────╢
  600.     ║ ZDir \temp\fdr       │ No       │ C:\temp\fdr*.*         ║
  601.     ╟──────────────────────┼──────────┼────────────────────────╢
  602.     ║ ZDir \temp\fdr.001   │ Yes, No  │ C:\temp\fdr.001        ║
  603.     ╟──────────────────────┼──────────┼────────────────────────╢
  604.     ║ ZDir \bin\tempfile   │ Yes, No  │ C:\bin\tempfile.*      ║
  605.     ╟──────────────────────┼──────────┼────────────────────────╢
  606.     ║ ZDir \bin\tempfile.  │ Yes, No  │ C:\bin\tempfile        ║
  607.     ╟──────────────────────┼──────────┼────────────────────────╢
  608.     ║ ZDir .               │ Yes, No  │ C:\batch\*.*           ║
  609.     ╟──────────────────────┼──────────┼────────────────────────╢
  610.     ║ ZDir ..              │ Yes, No  │ C:\*.*                 ║
  611.     ╟──────────────────────┼──────────┼────────────────────────╢
  612.     ║ ZDir ..\*.com        │ Yes, No  │ C:\temp\*.com          ║
  613.     ╚══════════════════════╧══════════╧════════════════════════╝
  614.  
  615. 4.2.1 Displaying path specs
  616.  
  617. If there is a volume label and serial number on the disk of the
  618. directory listing, there may not be room on the screen for the
  619. complete path spec on the left side of the second line of the
  620. display.  In these cases, the first few directories of the path are
  621. replaced by a single \...\, such as
  622. F:\USR\GROUP1\MICHAEL\WORK\DATA\123FILES\*.WK? being shortened to
  623. F:\...\DATA\123FILES\*.WK?, where the \...\ replaced
  624. \USR\GROUP1\MICHAEL\WORK.
  625.  
  626.  
  627.  
  628. 4.3 Volume information
  629.  
  630. Every disk can have a volume label.  The volume label is a zero
  631. length file in the root directory on the disk that has the volume
  632. label attribute set.  Unlike all other files, it is case sensitive,
  633. and is just treated as an eleven character title.  To set the
  634. volume label, type label from the DOS prompt.  To make a volume
  635. label with upper and lowercase letters, a sector editor or a
  636. special volume label program is needed.  If a volume label is
  637. present on the disk, ZDir displays the information on the right
  638. side of the second line of the display.
  639.  
  640.  
  641. 5. ZDir options
  642.  
  643. Placing options on the command line alters the function of ZDir. 
  644. Many of the options tell ZDir to perform a different operation than
  645. the usual directory listing, including information options and the
  646. command options.  These either have ZDir do something totally
  647. different than normal, such as display a help screen, or just add
  648. to the normal function, such as changing attributes.  There are
  649. also options to change features of the display, such as the sort
  650. type and number of columns, which are called display options.  All
  651. options are typed on the command line, starting with a slash (/)
  652. and then the letter or characters describing the option.
  653.  
  654.  
  655.  
  656. 5.1 Information options
  657.  
  658. The first class of options are those that tell ZDir to pop up
  659. information screens instead of performing a directory listing. 
  660. These are /H, /?, and /R.  The first of these options found on the
  661. command line is used, and all other information on the command line
  662. is ignored.
  663.  
  664. Two of these options, /H and /?, display the help screen for ZDir. 
  665. This is a short page of information about how to run ZDir and a
  666. description of every option.  Hitting Shift-Print Screen (or just
  667. Print Screen on 101/102 key keyboards) prints out the help screen
  668. on the printer.  Hitting any other key quits the help screen and
  669. returns to DOS.
  670.  
  671. The other information command option is /R.  This command displays
  672. an order form for ZDir on the screen, which can be printed with
  673. Shift-Print Screen (or Print Screen).  The form is identical to the
  674. one at the end of this manual.  For more information on registering
  675. ZDir, see section 2 about Shareware, and section 7 for a
  676. registration form similar to the one displayed with ZDir /R.
  677.  
  678.  
  679.  
  680. 5.2 Command options
  681.  
  682. Command options that add on to the basic ZDir functionality are /L,
  683. /F, /T, /U, and the attribute changing options, /+x or /-x, where
  684. x is one of A, H, R, or S.  Each of these commands and associated
  685. options are described below.
  686.  
  687.  
  688.  
  689.  
  690.  
  691. 5.2.1 Write to file
  692.  
  693. ZDir always displays information on the screen, but using /L
  694. followed directly by a filename tells ZDir to write another copy of
  695. its output to a file.  Normally,  ZDir will display the message
  696. Writing to file filename, and write out a text version of its
  697. output to the file.  To send the output to the standard printer,
  698. use PRN as the filename.  ZDir will either send an exact copy of
  699. the output to the indicated file or substitute pluses and dashes
  700. for the graphics characters depending on the setting of the option
  701. Default edit->Output format->Graphics in alt. output.  This option
  702. should be set to Standard ASCII when using printers that cannot
  703. print IBM extended graphics characters.
  704.  
  705. The option /A, when put on the command line, writes out ANSI color
  706. codes to the file specified with /L.  This is useful when writing
  707. listings over the modem (/LAUX or /LCOM1).
  708.  
  709. Several errors can occur when writing to files using /L.  If ZDir
  710. cannot write to the indicated file, then the message Error!  NOT
  711. writing to file filename is printed.  This can occur for several
  712. reasons:
  713.  
  714. o      The file already exists.
  715.  
  716. o      The file is a read-only device, such as the keyboard.
  717.  
  718. o      There is a data error on the disk.
  719.  
  720. o      The disk drive or directory does not exist.
  721.  
  722. When an error occurs, just correct the problem and rerun ZDir.
  723.  
  724. Several example runs are shown below:
  725.  
  726. C:\>ZDir /Llist.txt *.*<Enter>
  727.  
  728. This would write a copy of the file listing of all files in the
  729. current directory to the file LIST.TXT.
  730.  
  731. C:\>ZDir *.exe /A /Lcom1<Enter>
  732.  
  733. This would write a copy of the file listing of all files having the
  734. extension EXE to the first communications port including ANSI color
  735. codes.
  736.  
  737. C:\>ZDir *.exe /Lprn<Enter>
  738.  
  739. This would write a copy of the file listing of all files having the
  740. extension EXE to the standard printer.
  741.  
  742. 5.2.2 File find
  743.  
  744. ZDir performs file finds quickly and easily using the option /F. 
  745. It displays a listing of the directory in the path specification
  746. and then goes to every directory below the specified directory and
  747. performs a listing, not printing anything if no files are found in
  748. a directory.  By specifying the root directory, ZDir will search an
  749. entire disk for files.  Example runs should clarify how to use file
  750. finding:
  751.  
  752. C:\WORK>ZDir *.bat /F<Enter>
  753.  
  754. This command tells ZDir to first display all files with the
  755. extension BAT in the directory C:\WORK.  Next, ZDir goes to all the
  756. subdirectories of C:\WORK, and displays a listing of all files with
  757. the extension BAT in each directory under C:\WORK.
  758.  
  759.  
  760. C:\WORK>ZDir \*.bat /F<Enter>
  761.  
  762. This command is the same as the previous one, but starts at the
  763. root directory, C:\, and displays a listing.  Then ZDir searches
  764. every directory on the disk for files with the extension BAT, and
  765. displays a file listing in each directory that has a file with the
  766. extension BAT.
  767.  
  768. C:\WORK>ZDir /F /Lprn D:\<Enter>
  769.  
  770. This command combines file finding with writing a listing to a file
  771. (see section 5.2.1).  ZDir will list every file on the D drive,
  772. displaying it on the screen and printing it on the printer.
  773.  
  774.  
  775.  
  776. 5.2.3 Tree display 
  777.  
  778. Directory trees give an overall view of all or part of a disk in a
  779. compact format.  With ZDir, directory trees are printed where the
  780. file list is normally displayed.  Using the tree display option is
  781. similar to using the file find option, in that the path of the path
  782. spec is used as the first directory (top level of the tree), and
  783. then all the subdirectories are printed after it.  The tree does
  784. not have to start at the root directory; any directory can be
  785. selected to be the top level of the tree display.  The number of
  786. files that match the path spec and the sum of the file sizes of
  787. each directory (in kilobytes) are printed on the left.  Only files
  788. matching the filespec are included in the number of files count and
  789. total number of bytes count of each directory.  Up to five levels
  790. of directories below the top level are displayed.
  791.  
  792. Unlike file finding, directories with no matching files are
  793. included, but a zero is listed under files and bytes.  The command
  794. to display a tree is /T.  Below is a sample run:
  795.  
  796. C:\WORK>ZDir /T \WORK<Enter>
  797.  
  798. 8:15:50pm                    ZDir v2.1, by ZanySoft               March 2, 1992
  799. Path: C:\WORK\*.*                                            Volume - VDISK 1-2
  800. ═══════════════════════════════════════════════════════════════════════════════
  801.  
  802. Files  Bytes Path
  803.   15    160k WORK
  804.   22     45k   └──────┬─WINPROG
  805.   45    429k          ├─BACKUP
  806.    4     94k          │    └──────WKS
  807.   22    190k          └─WP
  808.    8    129k             └──────┬─REPORT
  809.   25    228k                    └─PERSONAL
  810.  
  811. ═══════════════════════════════════════════════════════════════════════════════
  812. File listing of C:\WORK\
  813.    and the 6 directories under it, of files of the form *.*
  814. Totals --
  815.     141 files totalling 1,319,529 bytes using 1,351,680 bytes of disk space.
  816.  
  817.  
  818. (Notice that there are no disk totals on this display, only the
  819. totals for the files.  This is not due to the tree, but due to the
  820. fact that the copy of ZDir that made the above display was
  821. configured to not print disk totals, using the Default edit->Output
  822. format->Disk totals option in ZDircfg.)
  823.  
  824.  
  825.  
  826. 5.2.4 User extensions
  827.  
  828. ZDir stores fifty extensions that it checks against each file, and
  829. colors the filename in the display the color associated with its
  830. extension.  Also, every extension is classified as either a user
  831. extension or not a user extension.  See section 6.2.3 for how to
  832. configure the extensions.
  833.  
  834. User extensions allow you to designate up to fifty extensions that
  835. can be quickly displayed to the exclusion of other extensions. 
  836. When the command option /U is specified on the command line, only
  837. the files with extensions that are classified as a  user extension
  838. are listed■all other files are ignored.  (ZDir's factory default
  839. for the user extensions are EXE, COM, and BAT, so typing ZDir /U
  840. from the command line is a handy way to list all executable files
  841. in the current directory.)  An additional line is added after the
  842. file listing that tells you the current user extensions.  Any
  843. number of extensions can be made user extensions and are used to
  844. match against the files in the directory, and the first ten are
  845. displayed on the line following the file list area.
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852. 5.2.5 Attribute changing
  853.  
  854. Every file has five attributes that tell DOS about the file.  Each
  855. of the five attributes are either on or off for every file.  ZDir
  856. can change all of the attributes except for the network attribute.
  857.  
  858. The archive attribute is used with the DOS programs backup and
  859. restore, to determine which files have been newly modified since
  860. the last time backup was run.  The /+A command turns this attribute
  861. on for all files in the directory listing; the /-A command turns
  862. this attribute off for all files in the directory listing.
  863.  
  864. The hidden attribute tells DOS to not list the file in DIR listings
  865. (ZDir can list all files, including hidden files--see section
  866. 6.2.5.1).  The /+H command turns this attribute on for all files in
  867. the directory listing; the /-H command turns this attribute off for
  868. all files in the directory listing.
  869.  
  870. The system attribute is supposed to mean that the file is necessary
  871. to boot the computer, but all it really does is prevent the file
  872. from being run from the DOS prompt.  The /+S command turns this
  873. attribute on for all files in the directory listing; the /-S
  874. command turns this attribute off for all files in the directory
  875. listing.
  876.  
  877. Files possessing the read-only attribute can not be written to or
  878. changed by DOS.  Making files read-only is a good way to prevent
  879. accidental deletions of important files.  The /+R command turns
  880. this attribute on for all files in the directory listing; the /-R
  881. command turns this attribute off for all files in the directory
  882. listing.
  883.  
  884. The network attribute is used to identify whether a given file is
  885. shareable over a network.  It cannot be changed using ZDir.
  886.  
  887.  
  888.  
  889. 5.3 File listing options
  890.  
  891. Although everything about ZDir can be configured using ZDircfg,
  892. there are times when you want to override the defaults for just one
  893. run of ZDir.  There are options that can be put on the command line
  894. to set the number of columns of the output, the sort type, and
  895. whether ZDir waits for a keypress between each screen of
  896. information.
  897.  
  898. The options to set the number of columns on the command line are
  899. /1, /2, /3, /4, /6, and /W.  The number is the number of columns
  900. ZDir uses to display the directory listing, with /W the same as /6. 
  901. Section 4.1 describes what the display looks like for each number
  902. of columns.
  903.  
  904. The available sort options are /N, /X, /Z, /D, and /S.  They stand
  905. for sort by name, extension, size, date and time, and no sort,
  906. respectively.  When there is no sort, the files are listed in the
  907. same order as the DOS DIR command.  When there is no sort, the
  908. setting of Default edit->File list choices->Directory placement is
  909. ignored and directories are placed together with files.  This makes
  910. the list of filenames and directories appear in the exact same
  911. order as the DOS DIR command.
  912.  
  913. The /K option toggles the default of waiting for a key between each
  914. screen of data.  For example, if the default is to wait for a key
  915. each screen, then typing /K on the command line will make ZDir not
  916. wait for a key each screen.  At the prompt at the end of each
  917. screenful of information, hitting the down arrow key scrolls the
  918. display one line, and any other key scrolls an entire new page onto
  919. the display.  Regardless of the setting of this option, the Press
  920. any key to continue message does not appear in the file output.
  921.  
  922.  
  923. 6. Configuration:  ZDircfg
  924.  
  925. The most exciting part of ZDir is that every color, extension, and
  926. option is configurable with an easy to use companion program,
  927. ZDircfg.  ZDircfg is a menu driven program that presents
  928. configuration information in the menus.  It loads and saves the
  929. configuration info in the executable program ZDir.com itself.  When
  930. ZDircfg is run, it starts with "factory settings" for every option
  931. which are identical to the configuration in ZDir.com when you
  932. received it.  If at some future date you wish to restore the
  933. "factory settings" to a copy of ZDir, just run ZDircfg and
  934. immediately save to a copy of ZDir.com.  ZDircfg also allows
  935. registered users to incorporate settings they have established in
  936. previous versions of ZDir into the latest version by loading in the
  937. settings from the old version and saving to the new version.
  938.  
  939.  
  940.  
  941. 6.1 Using ZDircfg
  942.  
  943. ZDircfg is easy to use because it is menu driven.  The initial
  944. layout of ZDircfg has a title line at the top of the screen, the
  945. top level menu in the upper left of the screen, and the help line
  946. on the bottom.  The help line shows several of the most important
  947. keys for the current situation, but due to space limitations it
  948. does not have all of them.
  949.  
  950. In every menu, the current menu item is in a different background
  951. color, which is called the cursor.  To move the cursor up or down
  952. one choice, hit the up or down arrow keys.  To go to the first menu
  953. choice, hit page-up.  To go to the last menu choice, hit page-down. 
  954. To select the current menu item, hit <Enter> or the space bar.  To
  955. select a menu item other than the current item, hit the fast key,
  956. usually the first letter of the item.  This letter, called the fast
  957. key, is in a different color than the rest of the text.  To abort
  958. the current choice or to go back up a menu, hit the escape key. 
  959. From the top level menu, this will quit ZDircfg if no changes have
  960. been made, or, if changes were made, ask you if you want to quit
  961. and lose the changes.
  962.  
  963. There are several different types of menu entries, including
  964. submenus, color choices, pick from a list, and other functions. 
  965. Submenus are indicated by a  character on the right of the entry. 
  966. These contain an additional menu, which are of a similar function. 
  967. Color choices have the word Sample on the right of the entry, in
  968. the current color of the option.  Pick from a list menu items have
  969. a short description of the current choice on the right of the
  970. entry, which can be changed with the left and right arrow keys, as
  971. well as <Enter> and the space bar (which are the same as right
  972. arrow).  Many of the pick from a list menu items are yes or no
  973. questions.  Other menu items perform various functions: these
  974. include quitting ZDircfg, popping up a window to load or save
  975. configuration information, editing the extensions, and setting the
  976. column auto-detection amounts.  These menu choices are indicated by
  977. three periods(...) after the choice.
  978.  
  979.  
  980.  
  981. 6.2 ZDircfg menus
  982.  
  983. The main menu of ZDircfg looks like the following:
  984.  
  985. ┌──────────────────────────────┐
  986. │ Load ZDir configuration...   │
  987. │ Save ZDir configuration...   │
  988. │ Extension edit...            │
  989. │ Color edit                  │
  990. │ Default edit                │
  991. │ Registration form...         │
  992. │ Quit                         │
  993. └──────────────────────────────┘
  994.  
  995. The first two selections load and save configuration information to
  996. and from one or more copies of ZDir.  Extension edit pops up a
  997. window that allows setting of the fifty extensions and
  998. corresponding colors with which to display files matching these
  999. extensions, and setting whether each is a user extension or not. 
  1000. Color edit and Default edit are submenus containing the settings of
  1001. every color and default of ZDir.  The selection Registration form
  1002. displays the same registration form as when ZDir /R is run.  The
  1003. last menu selection, Quit,  exits ZDircfg, but if any changes have
  1004. been made and were not saved, it asks if you are sure.
  1005.  
  1006.  
  1007.  
  1008. 6.2.1 Load ZDir configuration
  1009.  
  1010. Loading in configuration information from a copy of ZDir.com on
  1011. disk is the first step in configuring ZDir.  If the copy of ZDir
  1012. you are loading from is prior to version 2.1, then ZDircfg pops up
  1013. a window asking for your registration name and number, because
  1014. upgrading config info from an old version to the current version
  1015. 2.1 is only available to registered users.
  1016.  
  1017. When the main menu option Load ZDir configuration is selected,
  1018. ZDircfg draws a small text input window on the screen with the
  1019. prompt Enter ZDir filename.  You must type in the path to the copy
  1020. of ZDir for ZDircfg to load.  If the copy of ZDir to load is in the
  1021. current directory, then only the filename is required.  Note that
  1022. ZDir does not have to be called ZDir.com.  Many users shorten it
  1023. (using the DOS REN command) to ZD.com or Z.com for ease of typing. 
  1024. ZDircfg automatically adds .COM to the end of the filename if you
  1025. do not type the extension.
  1026.  
  1027. Several keys have special functions when typing filenames in
  1028. ZDircfg.  The left and right arrow keys move the cursor left and
  1029. right in the filename.  Delete deletes the character at the cursor
  1030. (or does nothing if the cursor is at the end of the filename). 
  1031. Backspace deletes the character to the left of the cursor.  Home
  1032. and end move the cursor to the beginning and end of the filename,
  1033. respectively.  To toggle between inserting characters and
  1034. overwriting text, hit the insert key.  The status of insert mode is
  1035. indicated by the cursor.  It is a full block in overwrite mode, and
  1036. an underline in insert mode.
  1037.  
  1038. The maximum length of the path and filename to ZDir is 60
  1039. characters.  Once the entire filename is typed in, hit <Enter>.  If
  1040. ZDircfg successfully loads in configuration information from ZDir,
  1041. it pops up a window that says Loaded ZDir version x.y, where x.y is
  1042. the version of ZDir it loaded from.  If there was a problem loading
  1043. ZDir, ZDircfg displays an error window that describes the problem
  1044. and then returns to the main menu.  If the version of ZDir you are
  1045. trying to load is less than 2.1, then you are trying to upgrade
  1046. information from one version to another, and ZDircfg displays a
  1047. window asking you for your registration name and number.  Type your
  1048. registration name and number exactly as printed on the letter you
  1049. received as acknowledgement of your registration.  The case of
  1050. letters is significant, and should all be uppercase.  Also, if
  1051. there are any extra spaces ZDircfg will not load the old
  1052. configuration information, so be sure to type the registration name
  1053. and number carefully.
  1054.  
  1055. Filenames entered to attempt to load ZDir, whether successful or
  1056. not, are saved (in the current session of ZDircfg) for the next
  1057. time you try to load ZDir from disk.  When you enter Load ZDir
  1058. configuration again, the text is displayed in a different color. 
  1059. To use the text, hit any of the special keys (left and right arrow,
  1060. home and end, backspace, and enter), or hit any other key to
  1061. restart with a new filename.  This can save a lot of typing if you
  1062. are getting errors trying to load in ZDir.
  1063.  
  1064.  
  1065.  
  1066. 6.2.2 Save ZDir configuration
  1067.  
  1068. Saving the current configuration information to a copy of ZDir 2.1
  1069. looks a lot like loading info from ZDir, and is in fact very
  1070. similar.  When you pick this menu selection from the main menu, a
  1071. small text window is popped up and you are asked to enter the
  1072. filename of the copy of ZDir where you want to save the
  1073. configuration info.  The editing keys are the same as with loading
  1074. ZDir.  Unlike loading from ZDir, however, configuration info can
  1075. only be saved to ZDir version 2.1, and ZDircfg will give an error
  1076. if you try to save to a different version of ZDir.
  1077.  
  1078.  
  1079.  
  1080. 6.2.3 Extension editing
  1081.  
  1082. Selecting the extension edit choice on the main menu opens a window
  1083. that shows all fifty extensions, each in its extension color, and
  1084. indicates which ones are designated user extensions.  When ZDir is
  1085. run, each filename is checked against the extensions, and if the
  1086. filename's extension matches one of the fifty extensions, then it
  1087. is displayed in the designated color for that extension.  Wildcards
  1088. are allowed anywhere in the extensions, making grouping of files by
  1089. color very easy.
  1090.  
  1091. Editing the extensions themselves is a simple matter.  The
  1092. horizontal arrow keys move one letter at a time through the
  1093. extension, and the vertical arrow keys move between extensions. 
  1094. Tab and shift-tab move forward or backward one extension.  Home and
  1095. end move to the beginning and end of the row; page-up and page-down
  1096. move to the top and bottom of the column.  To change the character
  1097. at the cursor, simply type a valid filename character (any letter,
  1098. number, or certain special characters).  The new character
  1099. overwrites the old.  There is no insert mode.  For extensions less
  1100. than three characters long, delete and backspace remove characters. 
  1101. The space bar does not put a space in the extension, because it is
  1102. used with setting user extensions.
  1103.  
  1104. When ZDir is run with the /U option, the only files included are
  1105. those that match extensions designated "user extensions".  These
  1106. are shown in the extension edit window by a check mark to the right
  1107. of the extension name.  The space bar toggles whether the extension
  1108. at the cursor is a user extension or not.
  1109.  
  1110. To edit the color of the extension at the cursor, hit the <Enter>
  1111. key.  This causes a color selection box to be displayed to the
  1112. right of the extension, with the white line cursor surrounding the
  1113. current color of the extension.  The vertical arrow keys change the
  1114. foreground color and the horizontal arrow keys change the
  1115. background color.  Home and end move the cursor to the left and
  1116. right of the color selection box.  Page up and page down move the
  1117. cursor to the top and bottom of the box.  To set the extension to
  1118. the color at the cursor, hit <Enter>.  To abort the color entry and
  1119. retain the previous color, hit escape.
  1120.  
  1121. When you are done editing the extension information, hit the escape
  1122. key to return to the main menu.  Any changes you made will be
  1123. retained in memory, for further editing later or saving to a copy
  1124. of ZDir.
  1125.  
  1126.  
  1127.  
  1128. 6.2.4 Color editing
  1129.  
  1130. The color edit menu contains several submenus that contain the
  1131. colors for the display of everything other than the filename that
  1132. can be configured.  The menu looks as follows:
  1133.  
  1134. ┌──────────────────────┐
  1135. │ Header lines        │
  1136. │ File entry area     │
  1137. │ Summary lines       │
  1138. │ Tree display        │
  1139. │ Miscellaneous       │
  1140. └──────────────────────┘
  1141.  
  1142. Each of the submenus contains the colors that may be configured for
  1143. a particular part of ZDir's display.  The header lines colors are
  1144. the colors of the current time and date, the text indicating the
  1145. path and volume label, and the ZanySoft message.  The ZanySoft
  1146. message is ZDir v2.1 by ZanySoft.  For the two colors of the
  1147. ZanySoft message only, the foreground is not allowed to be the same
  1148. as the background.
  1149.  
  1150. The file entry area is everything that ZDir displays within the
  1151. graphic lines (except for trees).  This includes the time and date
  1152. of each file, file sizes and used disk space, file attributes,
  1153. directories, volume labels, hidden files, and the graphic lines
  1154. themselves.  The color of files that match no extension is also in
  1155. the file entry area menu.
  1156.  
  1157. The summary lines give the totals for the ZDir run and are
  1158. displayed in up to three different colors.  The first summary color
  1159. is the color of the message displayed directly after the file area
  1160. when the /U option is used which says Files matching extensions
  1161. followed by the extensions in their own colors.  The other two
  1162. colors are for the text of the summary lines, and the numbers and
  1163. the path spec in the summary lines.
  1164.  
  1165. The miscellaneous color menu has the colors that do not fit into
  1166. any other category.  The most important of these is the empty space
  1167. color, which is the color of most of the spaces in the ZDir
  1168. listing.  Since only spaces are printed in this color, the
  1169. foreground part of the empty space color does not matter.  Usually
  1170. you will want this to be black, but if you set your background
  1171. color in DOS to another color (using ANSI escape sequences, for
  1172. example), then you can set ZDir to match it.  The other
  1173. miscellaneous colors are the two colors for the press any key to
  1174. continue message in between each screen of data, the no files found
  1175. message color, and the color of the message giving the status of
  1176. writing to a file (when /L is on the command line).
  1177.  
  1178.  
  1179.  
  1180. 6.2.5 Default editing
  1181.  
  1182. The default edit menu opens up a submenu that categorizes the
  1183. configurable defaults into three groups:
  1184.  
  1185. ┌────────────────────────┐
  1186. │ Search options        │
  1187. │ File list choices     │
  1188. │ Output format         │
  1189. └────────────────────────┘
  1190.  
  1191. Each of these submenus contains several options, and is discussed
  1192. separately.
  1193.  
  1194.  
  1195.  
  1196. 6.2.5.1 Search options
  1197.  
  1198. The search options all deal with how ZDir chooses which files to
  1199. list.  Depending on how they are set, ZDir can include many more
  1200. files than the standard DOS DIR command, or show the same files as
  1201. the DOS DIR command would.  The search options menu appears on the
  1202. screen as follows:
  1203.  
  1204. ┌───────────────────────────────────────┐
  1205. │ Put * before filespec             Yes │
  1206. │ Add directory entries in totals    No │
  1207. │ Show . and .. files               Yes │
  1208. │ Include:  Hidden files            Yes │
  1209. │           Read only files         Yes │
  1210. │           System files            Yes │
  1211. │           Volume labels           Yes │
  1212. └───────────────────────────────────────┘
  1213.  
  1214.  
  1215. In every run ZDir adds *.* to the end of the filespec if there is
  1216. no extension specified, but the Put * before filespec selection
  1217. determines whether ZDir also adds a * to the beginning of the
  1218. filespec as well.  For example, with this option set to no, then
  1219. the command
  1220.  
  1221. C:\>ZDir abc<Enter>
  1222.  
  1223. tells ZDir to use abc*.* as the filespec.  If it is set to yes,
  1224. ZDir will use *abc*.* as the filespec.  See section 4.2 for more
  1225. about filespecs.
  1226.  
  1227. The next two search options are related:  add directory entries in
  1228. totals and show . and .. files.  If ZDir does not add directories
  1229. to totals, then the total lines give a count of actual files and
  1230. their total space.  If ZDir does add directories in the totals,
  1231. then the total number of files includes directory entries, and the
  1232. total space accurately shows how much disk space is used by every
  1233. listed directory entry.  Every directory on a disk except for the
  1234. root directory contains two directory entries, called . and ..,
  1235. which help DOS keep track of the directory.  ZDir will not show
  1236. these two directory entries if Show . and .. files is set to no.
  1237.  
  1238. The last four search options tell ZDir what attributes a file may
  1239. have and still be listed by ZDir.  Normally, all four are set to
  1240. yes so that ZDir shows every file in the directory.  The DOS DIR
  1241. program does not include files with any of the four attributes,
  1242. which are hidden, read-only, system, and volume label.  Running
  1243. ZDir under the DR DOS operating system restricts the options
  1244. slightly, in that DR DOS ignores files with the volume label
  1245. attribute, so the setting of the volume label option does not
  1246. matter because files with the volume label attribute can never be
  1247. listed.
  1248.  
  1249.  
  1250.  
  1251. 6.2.5.2 File list choices
  1252.  
  1253. The file list choices affect the look of the center part of the
  1254. actual file listing.  The main choices are the number of columns
  1255. and the sort used, but several other options affect the file list
  1256. as well.  The file list choices menu is shown below:
  1257.  
  1258. ┌─────────────────────────────────────────────┐
  1259. │ Number of columns               Auto detect │
  1260. │ Auto detect settings...                     │
  1261. │ Sort ordering                 Top to bottom │
  1262. │ Directory placement        Before all files │
  1263. │ Entire entry in file color               No │
  1264. │ 1st sort factor                        Name │
  1265. │ 2nd sort factor                        Name │
  1266. │ 3rd sort factor                        Name │
  1267. │ 4th sort factor                        Name │
  1268. └─────────────────────────────────────────────┘
  1269.  
  1270. The number of columns that ZDir uses to display the listing is the
  1271. choice that affects the ZDir display the most.  The choices are 1,
  1272. 2, 3, 4, 6, or auto detect.  If it is set to auto detect mode, then
  1273. ZDir uses the auto detect settings to choose how many columns to
  1274. use.  For a description about the benefits and drawbacks of each
  1275. choice, see section 4.1.
  1276.  
  1277. The auto detect settings menu entry opens up into a window which
  1278. shows the range of the number of files for which ZDir will select
  1279. 1, 2, 3, 4, or 6 column display mode.  The cursor is on the
  1280. righthand side of the window, highlighting the upper limit of the
  1281. range.  The vertical arrow keys, page up, and page down move the
  1282. cursor up and down to the different columns' ranges.  The right and
  1283. left arrow keys change the upper limit of the range by one, and the
  1284. plus and minus keys change the upper limit by ten.  When one range
  1285. is changed, the others are adjusted to prevent overlapping ranges. 
  1286. The maximum number of the lower part of the six column range is
  1287. 255.  If a change would push the six column range over 255 or the
  1288. one column range below zero, the change is ignored.
  1289.  
  1290. There are two ways to display a directory listing when there are
  1291. multiple columns:  left to right or top to bottom.  This is the
  1292. choice of the sort ordering option.  If it is set to left to right,
  1293. then the first filename is printed in the top of the first column,
  1294. the second is in the top of the second column, etc.  If it is set
  1295. to top to bottom, then the first file is still in the top of the
  1296. first column, but the next file is just below it in the first
  1297. column.  The DOS DIR command uses left to right ordering, but most
  1298. people find top to bottom ordering easier to read.
  1299.  
  1300. Although subdirectories are listed together with files in directory
  1301. listings, they are quite different from normal files and should be
  1302. treated differently.  The directory placement option gives you the
  1303. capability to separate directories from normal files, by either
  1304. placing the subdirectories before or after the normal files.  When
  1305. files are displayed in the DOS file order (no sort), then this
  1306. option is ignored, because in the DOS file order directories are
  1307. always interspersed among the files.
  1308.  
  1309. Having each type of information about a file displayed in different
  1310. colors can be distracting to some people when looking at the
  1311. directory listing line by line, especially in one or two column
  1312. mode.  For easier recognition of a file's information, the entire
  1313. file entry can be displayed in the filename's color (determined by
  1314. its extension).  Although for certain applications this is helpful,
  1315. for most of the time the Entire entry in file color should be set
  1316. to no.
  1317.  
  1318. The order in which files are listed is determined by the sort.  The
  1319. DOS DIR command does not have any sort, and instead displays the
  1320. files in the order it gets the filenames from disk.  This is one
  1321. option for the sort in ZDir, called the DOS file order.  The other
  1322. options are name, extension, size, date, and time.  All of the sort
  1323. options, except the DOS file order, can also be set to sort in
  1324. reverse order.  If files are tied after the first sort (for
  1325. example, if sorting by date, they have the same date), then the
  1326. secondary sort is used to break the tie.  If they are still tied,
  1327. then the third sort is used, etc.  Usually only the first two or
  1328. three factors are all that are important, however in some cases the
  1329. fourth is needed.  Sorting by the DOS file order is only available
  1330. as the first sort factor, because it is only needed to show files
  1331. in the same order as DOS, and would be pointless as a tie breaker.
  1332.  
  1333.  
  1334.  
  1335. 6.2.5.3 Output format
  1336.  
  1337. The options in the output format menu deal with how the output of
  1338. ZDir is presented.  This menu looks as follows:
  1339.  
  1340. ┌──────────────────────────────────────────────┐
  1341. │ Screen writes                           Fast │
  1342. │ Clear screen to start                     No │
  1343. │ Graphics in alt. output         IBM extended │
  1344. │ Wait for keypress each screen            Yes │
  1345. │ Use commas in file size                   No │
  1346. │ Print a . before extensions               No │
  1347. │ Disk totals                           Always │
  1348. └──────────────────────────────────────────────┘
  1349.  
  1350. The screen writes option tells ZDir how to write to the screen. 
  1351. The options are fast and BIOS.  Except for users of old CGA cards,
  1352. it should normally be set to fast screen writes.
  1353.  
  1354. Clearing the screen to start the display makes ZDir run much
  1355. faster, because the slowest part of ZDir is scrolling the screen. 
  1356. If you want to make ZDir as fast as possible, set Clear screen to
  1357. start to yes, and the display will start at the top of the screen.
  1358.  
  1359. The third option affects the output when writing to file (see
  1360. section 5.2.1).  If it is set to IBM extended, then an exact copy
  1361. of the ZDir output is written to the file specified with /L.  If it
  1362. is set to standard ASCII, then characters such as -, |, and + are
  1363. substituted for the graphic lines characters.
  1364.  
  1365. ZDir will wait for a keypress in between each screen of information
  1366. when the wait for keypress each screen is set to yes.  If this
  1367. option is set to no, then ZDir will not wait for a key at any time,
  1368. and complete its listing without pausing.  This option can be
  1369. toggled for one run by placing /K on the command line.
  1370.  
  1371. Although there is plenty of room in one column mode for commas in
  1372. file sizes, when multiple columns are displayed it is a bit of a
  1373. stretch, as there is not room for commas in six digit numbers.  The
  1374. commas in file sizes option gives you the choice of using commas in
  1375. file sizes, when there is room.  The numbers in the total lines at
  1376. the end are always displayed with commas for easier reading, and
  1377. this option does not affect them.
  1378.  
  1379. Filenames are displayed in two parts, the up-to-eight character
  1380. normal part of the name, padding spaces, and then the up-to-three
  1381. character extension.  The Print a . before extensions option
  1382. determines whether a period character is printed instead of the
  1383. last padding space before the extension.
  1384.  
  1385. The last line in the ZDir display is the disk totals line, which
  1386. shows how many bytes are free on the listed disk drive, and the
  1387. total amount of data it can hold.  Since this is useless to some
  1388. people, the disk totals option allows you to set ZDir to not
  1389. display the disk totals, to only display the disk totals when doing
  1390. a listing from either A: or B:, or to always display disk totals.
  1391.  
  1392.  
  1393. 7. Registration form
  1394.  
  1395.  
  1396. Name            _______________________________________________________________
  1397.  
  1398. Street Address  _______________________________________________________________
  1399.  
  1400. City            ______________________________________ State _____ Zip_________
  1401.  
  1402. Where did you get ZDir? _______________________________________________________
  1403.  
  1404.  
  1405.                                 ZanySoft Dir, version 2.1
  1406.  
  1407.                Remember, if you use ZDir, you are obligated to pay for it.
  1408.  
  1409. ___ $10       I am registering ZDir for use on one computer.  Please
  1410.               send me my registration number so I can upgrade
  1411.               configuration colors and defaults to all future versions
  1412.               of ZDir.
  1413.  
  1414.               Registration name, no more than 25 characters: __________________
  1415.  
  1416.     The following three items do NOT include registration:
  1417.  
  1418. ___  $5       I would like a 3.5" disk with the current version of ZDir.
  1419.  
  1420. ___  $5       I would like a 5.25" disk with the current version of ZDir.
  1421.  
  1422.     The following is for registered users ONLY:
  1423.  
  1424. ___  $5       I would like the laser printed version of the manual.
  1425.  
  1426.  
  1427. _______ Total.       Enclose cash or a check drawn on US currency made
  1428.                      out to Christopher Kirmse.  Send this form and
  1429.                      payment to:
  1430.  
  1431.                            ZanySoft
  1432.                            9303 Arabian Ave.
  1433.                            Vienna, VA  22182
  1434.  
  1435. Write any comments below
  1436.