home *** CD-ROM | disk | FTP | other *** search
/ Phoenix CD 2.0 / Phoenix_CD.cdr / 11a / cover20.zip / COVER.DOC < prev   
Text File  |  1991-01-21  |  6KB  |  137 lines
  1.  
  2. DOCUMENTATION FOR COVER.COM, A MASM ASSEMBLER PROGRAM FOR A SORTED
  3.   DIRECTORY SIZED TO FIT A 5 1/4" DISKETTE POCKET.
  4.  
  5.     COMMENT        * Version 1.0  -  June 1983
  6.             (PER Dr. Dobbs Journal, January, 1984, #87)
  7.             (Dan Daetwyler "Sorted Diskette Directory for
  8.                  the IBM PC")
  9.  
  10.         Version 2.0       Bruce F. Cameron
  11.                   Cincinnati  OH 
  12.  
  13.            February 25, 1985
  14.  
  15.     Counts hidden files
  16.     Grouped sort (i.e. all COM files first etc.)
  17.     Includes Volume Label and Directory (if not root)
  18.     Lists Subdirectory names
  19.     Free space up to 100M (hard disk)  *
  20.  
  21.  
  22. [Documentation for the original version {1.0} ] 
  23.  
  24.   COVER is a utility to print a sorted directory listing in such a
  25. format as to allow the listing to be cut and inserted into the sleeve
  26. with the diskette.  It was written by Dan Daetwyler of Arkansas and
  27. first published (and placed in the public domain) in the January 1984
  28. issue of "Dr. Dobb's Journal".  Anyone interested in the details is
  29. referred to that issue.
  30.  
  31.   To run, insert diskette with the program in the default drive and
  32. type COVER.  The program will prompt you for the ID of the drive that
  33. contains the diskette to be listed.  Type the appropriate letter
  34. (either case) ONLY -- no colon or RETURN.  The program will then ask
  35. for a title to appear on the listing.  The title may be up to
  36. forty-four characters; if you do not want a title, simple press ENTER.
  37. This process continues until ESC is entered at the drive ID prompt. The
  38. program prints two envelope covers per page; if exited via ESC, it will
  39. advance the paper to Top-of-Form and restore the printer to its power
  40. up defaults.
  41.  
  42.   The program issues Epson printer control codes for selecting
  43. compressed print, 1/8 inch line spacing, and 44 lines to the logical
  44. 'page'.  Those with IBM/Epson printers should be able to use COVER as
  45. is.  Those with a printer that uses different control codes with have
  46. to 'patch' the program (using DEBUG or some other such program).  The
  47. sequence to initialize the printer begins at location 13C; the Epson
  48. sequence is six bytes long (1B 30 1B 43 2C 0F) but it is padded with
  49. zeros so that there is room for eleven codes altogether. The string
  50. MUST terminate with a zero for the DOS call to work correctly.  The
  51. printer restore sequence is two bytes long (1B 40) and begins at
  52. location 148; again, it is padded with five extra zeros for patching
  53. room.  If this is insufficient for setting up your printer, you might
  54. try zeroing these sequences out and setting up your printer outside the
  55. COVER program.
  56.  
  57.   NOTE:  Cover issues ONLY the DOS call interupt.  This should insure
  58. that it can run on any MS-DOS machine not just the IBM compatibles.
  59. It has been successfully run on a TI Professional Computer with no
  60. modification whatsoever.
  61.  
  62.  
  63. [Documentation for additional features, version {1.1} ] 
  64.  
  65.           !!!!!!   NOTE  COVER, NEW VERSION 1.1    !!!!
  66.  
  67.      If you do not have the documentation for the original ver-
  68. sion of COVER, you should download and list the file COVER.DOC, 
  69. since this text includes only changes and additions from that 
  70. version.
  71.  
  72.      The simplest way to describe said changes is to include my 
  73. letter to Dr. Dobbs Journal, published in the August 1984 issue.  
  74. In addition to the changes described there, code lines have been 
  75. added to count and record directory entries irrespective of the 
  76. state of the "archive" bit, so that the program works correctly 
  77. under DOS 2.1 as well.
  78.  
  79.      NOTE!!!  This program produces a cover that does not recog-
  80. nize subdirectories.  They are neither noted as occurring, nor 
  81. are their contents listed, nor do their names appear in the 
  82. listing.  If you wish the cover to identify the particular di-
  83. rectory/subdirectory involved, then put the name in the TITLE.
  84.  
  85.  
  86.      !!!***!!!   NOTE   ***!!!***   IF YOU RECOMPILE AND LINK 
  87. THIS PROGRAM, BE SURE TO PUT THE MODULE "COENDP" LAST IN THE LIST 
  88. OF OBJECT MODULES FOR THE LINKER!  ALSO REMEMBER, OF COURSE, TO 
  89. RUN "EXE2BIN" TO CONVERT THE .EXE FILE PRODUCED BY THE LINKER TO 
  90. A .COM FILE.
  91.  
  92.  
  93.  
  94.                                           Feb. 19, 1984   
  95.  
  96. Dr. Dobbs Journal
  97. People's Computer Company
  98. Box E
  99. Menlo Park,  CA  94026
  100.  
  101. Dear DDJ,
  102.  
  103.      I enjoyed the Dan Daetwyler article "Sorted Diskette Direc-
  104. tory for the IBM PC" (Jan DDJ, # 87).  One of the advantages of 
  105. implementing something of that sort is the opportunity to add a 
  106. few personal flourishes.  I enclose two additions that do addi-
  107. tional tasks, and a third which corrects an annoyance.  First, 
  108. although one may not want hidden files included on the COVER, I 
  109. do want to know that there are such files on the diskette, and 
  110. how many.  I have added code to count them, and indicate the 
  111. count at the end of the list.  Second, I find it very convenient 
  112. to group like files together, e.g., list all .COM files first 
  113. (alphabetically), then all .BAS files, and lastly all the other 
  114. files.  I have included a procedure (COORDR) that prompts for the 
  115. file name extensions that you wish to place first on the sorted 
  116. list, and changes in COSCAN and COPRNT that handle the modified 
  117. sort and print.  Finally, I note that if you have a file with the 
  118. maximum 8-character file name plus maximum 3-character extension, 
  119. and a file length greater than 99999, there is no space in the 
  120. listing between name and length.  I have added a single space 
  121. between each column to take care of this.
  122.  
  123.      I enclose complete listings of the added procedure COORDR, 
  124. and the two procedures which have significant additions (COSCAN 
  125. and COPRNT).  I also include full listing for COENDP, since, al-
  126. though there are only minor changes, it is short.  In addition to 
  127. the listings included, you need to add "GETORD:NEAR" to the 
  128. EXTERN definition in the main program COVER, and the code line 
  129. "CALL  GETORD" following the "CALL  GETTTL" (line 79 in the pub-
  130. lished listing of COVER).  Finally, add code to make the PROC 
  131. DECMAL in COTITL a PUBLIC definition.
  132.  
  133.                               Yours truly
  134.                               Bruce F. Cameron
  135.                               4067 Rose Hill
  136.                               Cincinnati  OH  45229
  137.