home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / CPM / ZCPR33 / A-R / D15.LBR / D15.DZC / D15.DOC
Text File  |  2000-06-30  |  13KB  |  299 lines
  1.  
  2.                                 D
  3.                     A ZCPR3 Directory Program
  4.                            Version 1.5
  5.  
  6.          Version 1.5 and Documentation by Gene Pizzetta
  7.                          October 6, 1989
  8.                  Original Program by Hank Blake
  9.  
  10.  
  11. D has long been my favorite directory program.  It provides a 
  12. number of features not provided by other directory utilities.  
  13. The display is in lowercase, which makes it more readable to most 
  14. people.  In addition, it shows total disk capacity, the total 
  15. number of bytes used by the displayed files, the number of bytes 
  16. remaining on the disk, and the number of remaining directory 
  17. entries.  It also shows SYS, ARC, R/O, and other file attributes, 
  18. and displays files from all user areas in a single listing.  
  19. Originally written for CP/M 2.2 and above, it is designed to give 
  20. most of the information a user requires, while remaining under 4K 
  21. in size.  This version of D runs only under ZCPR3 and Z3PLUS.
  22.  
  23. Give D a little time and the value of the various features will 
  24. become obvious.
  25.  
  26. USAGE:
  27.  
  28.      D {dir:}{<{afn}.aft>} {{/}<options>}
  29.  
  30. If a drive and user or named directory is omitted, the current 
  31. drive and user is assumed.  If a filename is omitted then all 
  32. files (*.*) is assumed.  If a filetype is given without a 
  33. filename, DA wildcards the filename.  If no option is given then 
  34. all non-system files are displayed.
  35.  
  36. Options must be preceded by a space and slash (/), unless a DU or 
  37. DIR specification and/or a filename or filetype is given.  
  38. Several options may be included without intervening spaces.  A 
  39. filename mask may include slashes, but if it begins with a slash 
  40. then the mask must be preceded by a DIR or DU specification, or 
  41. simply a colon.
  42.  
  43. D is re-entrant and may be used with the GO command.
  44.  
  45. The number of columns used for the display varies, depending on 
  46. the number of files, the options chosen, and the width of your 
  47. screen.
  48.  
  49. OPTIONS:  All options are specified after a space and slash.  If 
  50. two successive slashes are used, then a brief usage message is 
  51. displayed.
  52.  
  53.      A    archived files only
  54.      B    include both non-system and system files
  55.      C    comprehensive, complete file control block information
  56.      F    suppress file sizes
  57.      N    no formfeeds to printer
  58.      O    read-only files only
  59.      P    send to printer
  60.      R    reset disk system
  61.      S    only system files
  62.      U    include files from all user areas
  63.      W    only read/write files
  64.      X    do not sort
  65.      Z    only non-archived files
  66.  
  67. EXAMPLES:
  68.  
  69.      A0>d b: /a     displays all the archived files from the
  70.                     current user area (0) on drive B.
  71.  
  72.      A0>d e4:       displays all non-system files from user 4 on
  73.                     drive E.
  74.  
  75.      A0>d /so       displays all the read-only system files from
  76.                     the current user area and drive (A0).
  77.  
  78.      M0>d edit:foo.*  displays all non-system files named FOO
  79.                     from the named directory EDIT.
  80.  
  81.      A0>d c23:.bar b  displays all files, both system and non-
  82.                     system, from user 23 on drive C with a file-
  83.                     type of .BAR.
  84.  
  85.      B1>d :/*.* u   displays all filenames beginning with a
  86.                     slash in all user areas of drive B (the
  87.                     default drive).
  88.  
  89. EXPLANATIONS OF OPTIONS:  Some options, particularly those that 
  90. regulate the display, are mutually exclusive.  If two or more 
  91. such options are given in the command line, generally the more 
  92. comprehensive options take precedence.  Unknown options are 
  93. ignored.
  94.  
  95.      A    Archived files only.  This filters for files with the 
  96.           Archive bit set and only those files are displayed.  
  97.           (The Archive attribute is a CP/M 3.0 feature that has 
  98.           also been implemented by ZRDOS, ZSDOS, and other 2.2 
  99.           replacements).  See also Z option.
  100.  
  101.      B    Both system and non-system files included.  This option 
  102.           turns off the system file filter and displays all files 
  103.           on the disk, both system and non-system.  System files 
  104.           are highlighted, however.  See also S option.
  105.  
  106.      C    Comprehensive file information.  Displays the complete 
  107.           directory entry for the selected files.  The files are 
  108.           unsorted but the filters work normally (the default is 
  109.           all non-system files.  All file attributes, including 
  110.           F1 through F8, are shown using highlighting on the 
  111.           corresponding characters of the filename.
  112.  
  113.      F    File sizes suppressed.  Displays files without file 
  114.           size information, resulting in a more compact display, 
  115.           with one additional column of filenames.
  116.  
  117.      N    No formfeeds.  If the P option is specified, this 
  118.           option causes formfeeds to be suppressed.  Without the 
  119.           P option, N has no effect.
  120.  
  121.      0    Read-only files only.  This filters for files that have 
  122.           the RO attribute set, and only those files are 
  123.           displayed.  See also W option.
  124.  
  125.      P    Printer echo.  Sends the directory to the printer, as 
  126.           well as to the screen (but there is no page pause if 
  127.           the screen fills).  Normally the printer listing is 
  128.           paged (every 4 lines less than your page length), and a 
  129.           final formfeed is sent when the listing is completed, 
  130.           but see also N option.
  131.  
  132.      R    Reset disk system.  The disk system is reset before the 
  133.           directory is read, so that the correct disk space is 
  134.           given under CP/M 2.2 compatible systems if the disk is 
  135.           changed.  This option should not be necessary under 
  136.           CP/M Plus.
  137.  
  138.      S    System files only.  This filters out non-system files 
  139.           and displays only system files.  See also B option.
  140.  
  141.      U    All users included.  Displays files from all user areas 
  142.           of a disk in a single listing.  
  143.  
  144.      W    Read/write files only.  This option displays only 
  145.           files that are not read-only.  See also R option.
  146.  
  147.      X    Cancel sort.  The directory files is not sorted in the 
  148.           display.  This is handy to find out the order that the 
  149.           filenames appear in the directory.  Some files with 
  150.           multiple directory entries that are not sequential will 
  151.           be listed more than once.
  152.  
  153.      Z    Non-archived files only.  This filters for files that 
  154.           do not have the Archive bit set and allows you to 
  155.           determine how many files need to be backed up.  See 
  156.           also A option.
  157.  
  158. DISPLAY FEATURES:  The directory display is fairly obvious, but a 
  159. few items might need clarification.
  160.  
  161. The default filter excludes system files.
  162.  
  163. Sorting the file entries alphabetically by filename is also a 
  164. default.  Files, sorted or unsorted, are displayed in a columnar 
  165. format.
  166.  
  167. System files are displayed in alternate video (dim or reverse), 
  168. when the B or S option is used, if alternate video is supported 
  169. by your TCAP.
  170.  
  171. Following the file size is either a k (for kilobytes) or an r 
  172. (for a read-only file).  The size is always in kilobytes, 
  173. regardless of the letter.  If the letters are uppercase (K or R) 
  174. then the corresponding file has the Archive bit set.
  175.  
  176. The characters in the filename display are reverse-cased.  Most 
  177. filenames will be in lowercase, but a filename in lowercase 
  178. (it's easy to do with MBASIC) is displayed in uppercase.
  179.  
  180. If a directory entry has a non-printable character in it, the 
  181. character is replaced by a question mark (?).
  182.  
  183. If the C option is used, any space characters with an attribute 
  184. bit set are replaced with an asterisk (*), so the attribute can 
  185. be displayed using dim video.
  186.  
  187. SPECIAL CONSIDERATIONS:  Be cautious when the disk in question is 
  188. read-only.  Incredibly spurious results can occur, especially 
  189. under CP/M 3.0.  For that reason D will display a "Disk is Read 
  190. Only" message, so you can treat the results with a grain of salt.  
  191. You can also use the R option (reset disk system) to eliminate 
  192. the problem.
  193.  
  194. If you use CP/M 3.0, you may have noticed that single-letter 
  195. program names followed by the name of a file on another disk 
  196. confuses the CCP.  That is, if you type (from the prompt)
  197.      A>d b:*.bar
  198. the CCP can't find D and reports an error.  This is a bug in the 
  199. CCP and there are public domain patches available to fix it.  If 
  200. your CCP isn't patched, I recommend renaming single-letter 
  201. programs like D to something else under CP/M 3.0.  Try something 
  202. like DD.COM.  Or you can use any single character name above P.
  203.  
  204. CP/M 3.0 supports disk labels, which are a directory entry under 
  205. user 32.  If D is assembled with the DSKLBL label TRUE, the D 
  206. looks for a user 32 entry and, if it finds one, lists it as the 
  207. disk name just after the user/drive callout.  User 32 is not 
  208. available to D under any other circumstances.  I left this 
  209. feature in as an assembly-time option because it is probably more 
  210. useful for users of floppy drives under CP/M Plus than named 
  211. directories.  If users of CP/M 2.2 desire such labels on their 
  212. disks, they must find a way to install a directory label entry in 
  213. user 32.  Any disk utility, such as DU, could be used to do this 
  214. by modifying a null (0K) directory entry to user 32.  Only 
  215. experienced users should try this.  The regular version of D 
  216. display ZCPR3 named directories instead of disk labels.
  217.  
  218. INSTALLATION:  Installation is no longer required.  The alternate 
  219. video string is determined from your TCAP.  The width and length 
  220. of your screen and the page length of your printer are determined 
  221. from your environment descriptor.
  222.  
  223. There are two assembly-time options that may be set in the source 
  224. file, however.  Set DSKLBL to True if you'd rather display CP/M 
  225. Plus disk labels, than ZCPR3 directory names.  Set REVVID to True 
  226. if you use reverse video for highlighting.
  227.  
  228. HISTORY:  The source code began as a disassembly of NEW-D.COM 
  229. using DASM 1.6 by Richard Conn and Joe Wright.
  230.  
  231. Version 1.0 -- Hank Blake -- 1984
  232.      For CP/M 2 and 3.  Source code not released.
  233.  
  234. Version 1.1 -- Gene Pizzetta -- June 25, 1989
  235.      For ZCPR3.  Source code derived from disassembly of original
  236.      COM file.  Added DU and DIR support under ZCPR3.  Added "//"
  237.      help screen.  Option delimiter changed from "[" to "/".  "G"
  238.      (specific user area) option eliminated.  Several other
  239.      cosmetic changes.
  240.  
  241. Version 1.2 -- Gene Pizzetta -- July 29, 1989
  242.      Now searches for filenames containing slashes, but not
  243.      filenames beginning with a slash unless it is preceded by a
  244.      DU or DIR specification (actually, a single colon will do).
  245.      Added R option to reset disk system.  Renamed old R option
  246.      to O option (to include only read-only files).  Added TCAP
  247.      support for dim or reverse video; no installation required.
  248.  
  249. Version 1.3 -- Gene Pizzetta -- August 21, 1989
  250.      No longer sends initial formfeed to printer; instead sends
  251.      formfeed after every 62 lines and a final formfeed after
  252.      printing directory, unless "N" option is used.  Changed
  253.      "Ext" to "Typ" in display.  Now prints ZCPR3 named directory
  254.      following DU specification, if the DSKLBL label below is set
  255.      to FALSE, otherwise looks for CP/M Plus disk label.
  256.  
  257. Version 1.4 -- Gene Pizzetta -- September 8, 1989
  258.      Horizontal lines in dim video.  Added equate for reverse
  259.      video version.  Revamped command line parser:  slash (/)
  260.      no longer required before options, if option list is second
  261.      token on the command line; and if a filetype is given, but
  262.      not a filename, the filename is automatically wildcarded.
  263.  
  264. Version 1.5 -- Gene Pizzetta -- October 6, 1989
  265.      Corrected problem with file mask, DU, and option selection
  266.      that only occurred under Backgrounder ii.  Now reads
  267.      environment to determine the number of lines on the screen,
  268.      number of screen columns, and number of lines on printer
  269.      page.  Now re-entrant for use with the "GO" command.
  270.  
  271. COPYRIGHT:  The original version of D.COM is copyright (c) 1984 
  272. by Hank Blake, Source Maverick, San Diego, California.  According 
  273. to that copyright, you may use D.COM for your own purposes other 
  274. than selling it.  You may distribute it as you wish, as long as 
  275. you do not charge for the program.  D.COM may be distributed on a 
  276. disk with other programs, for which there is a copy charge only 
  277. associated with the disk.  The copy charge may not exceed US 
  278. $2.00 in 1984 dollars, however.  The author assumes no liability 
  279. whatsoever with respect to another party's usage of D.COM, your 
  280. acceptance of this statement being a prerequisite to said party's 
  281. use of the program.
  282.  
  283. The changes made in this version are numerous and are not 
  284. copyright, but they would be of little use by themselves.
  285.  
  286. I hope to more improvements in this program in future releases, 
  287. including support of re-entrancy for use with the GO command.
  288.  
  289. If you have any suggestions, complaints, or bug reports, please 
  290. let me know.
  291.  
  292.      Gene Pizzetta
  293.      481 Revere St.
  294.      Revere, MA 02151
  295.  
  296.      Voice:  (617) 284-0891
  297.      Newton Centre Z-Node:  (617) 965-7259
  298.      Lilliput Z-Node:  (312) 649-1730
  299.