home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / sigm / vol254 / print.doc < prev    next >
Encoding:
Text File  |  1986-03-22  |  8.7 KB  |  161 lines
  1.  
  2. PRINT.LBR is a substantial extension to ENCOL.LBR, contained in SIG/M
  3. volume 206. ENCOL contained programs which would fold a file onto itself,
  4. so that it could be listed in two (TWCOL), three (THCOL) or four (FOCOL)
  5. columns. Many files, particularly assembly listings or tables of data,
  6. occupy only a few lefthand columns on each page, which means that a two-,
  7. three-, or four-fold saving of paper would result from a multiple column
  8. listing. Additionally, more compact listings are easier to consult for
  9. reference or cross checking.
  10.  
  11. ENCOL also contained a program for listing on both sides of the paper,
  12. resulting is a further saving in paper, and convenience for consulting
  13. bound listings. Basically it counted out the number of lines per page as
  14. it sent them to the printer, withholding the even-numbered pages for a
  15. second run after the paper had been turned over.
  16.  
  17. All of these programs were presented in two versions, one for the Intel
  18. 8080 and one for the Intel 8086, using the corresponding CP/M operating
  19. systems. PRINT also contains two versions, one for each of these CPU's.
  20.  
  21. PRINT introduces a new type of listing, in which multiple files may be
  22. listed side by side for purposes of comparison. Two (TWFIL), three (THFIL),
  23. or four (FOFIL) files may be shown as parallel strips on the same sheet
  24. of paper.
  25.  
  26. Experience has shown that assembly listings can be doubled up, and still
  27. retain a significant portion of their comments, if the compressed mode
  28. of 16.5 characters per inch which is available on many printers is used.
  29. This is particularly convenient when the listings are prepared for archival
  30. purposes. If the comments can be sacrificed, Intel 8086 assembly listings
  31. can be reproduced in three columns, while Intel 8080 assembly listings
  32. are still intelligible in the four column format.
  33.  
  34. Further space saving is possible - 25% more - if the listings are prepared
  35. at eight lines per inch rather than the customary six lines per inch. For
  36. the programs TWFIL, THFIL, or FOFIL this does not matter, but TWCOL, THCOL,
  37. and FOCOL must take account of the number of lines which will be printed
  38. on each page in order to do their folding correctly. Consequently a switch
  39. has been incorporated in this new version of these programs to choose
  40. between the two different line densities.
  41.  
  42. Finally, the page printing program, formerly PRINTDO, has been thoroughly
  43. reorganized. It, too, admits a switch to choose between six or eight lines
  44. per inch, so that either format can be handled by the same program. It is
  45. now called simply PRINT, and through another switch setting can be made to
  46. handle either single sided printing or double sided printing. Many times
  47. a two-sided printing was ruined when an interruption occurred when the job
  48. was half done, so another switch has been included which allows printing
  49. only front sides, or only back sides.
  50.  
  51. With the advent of squeezed programs and libraries of programs whose
  52. members might plausibly also be squeezed, there is a tendency to endow
  53. programs with the capability to work directly with these alternative
  54. formats. In common with some other contributions to SIG/M, we have used
  55. parentheses to indicate indirect references, and as a sort of "area code"
  56. when referring to libraries. Thus, if a somewhat intricate print job is
  57. contemplated, a Command Line File (extension CLF) may be built up, and
  58. then executed by indirect reference.
  59.  
  60. Let us suppose that some assembly listings are present, both squeezed
  61. and unsqueezed, with some of them in a library X.LBR, and some of them
  62. regular files on the disk. Suppose also that the file Y.CLF contains
  63. the following two lines:
  64.  
  65.     A.ASM,B.ASM,C.ASM
  66.     ((X) G.AQM),((X) H.AQM)
  67.  
  68. Then, the following lines give some examples of the use of PRINT:
  69.  
  70.     PRINT A.ASM            - A.ASM at 6 lines, 2 sides
  71.     PRINT A.AQM            - supposing A was squeezed
  72.     PRINT [8] *.ASM            - all ASM files at 8 lines, 2 sides
  73.     PRINT [8S] A.ASM,B.ASM        - A.ASM and B.ASM, 8 lines, 1 side
  74.     PRINT [B] ((X) *.AQM)        - backsides of all squeezed ASM's
  75.                       in the library X.LBR, 8 lines/inch
  76.     PRINT [B] ((B:X) *.AQM)        - but library is on disk B
  77.     PRINT [8] (Y)            - assemblies A,B,C, and squeezed
  78.                       A and B in X.LBR   [see Y.CLF]
  79.     PRINT (X),D.ASM            - as above, plus D.ASM, at 6 lines
  80.     PRINT (B:Y)            - command line file is on disk B
  81.     PRINT B:*.*            - everthing <except> .COM, .CMD,
  82.                       or .LBR on disk B at 6 lines/inch
  83.                       [hopefully no other binary files]
  84.     PRINT                - print a tutorial message
  85.  
  86. Further information about the programs comprising PRINT.LBR can be found
  87. in the assembly programs comprising the individual members. Generally
  88. speaking, each program will present sufficient information for its use
  89. by giving it a null command line. This feature is particularly useful if
  90. one is not just sure about the form of the correct command line, or if one
  91. has forgotten the switches.
  92.  
  93. To prepare the lines that follow, this much of PRINT.DOC has been subjected
  94. to each of the six programs TWCOL, THCOL, FOCOL, TWFIL, THFIL, FOFIL. Of
  95. course, the last three programs would normally be used on distinct files
  96. and not on the same repeated file. In each case a few lines of the composite
  97. file is shown to illustrate the corresponding program.
  98.  
  99. TWCOL PRINT.DOC -8
  100.  
  101. PRINT.LBR is a substantial extension to ENCOL.LBR, conta-    With the advent of squeezed programs and libraries of pr-
  102. volume 206. ENCOL contained programs which would fold a -    members might plausibly also be squeezed, there is a ten-
  103. so that it could be listed in two (TWCOL), three (THCOL)-    programs with the capability to work directly with these-
  104. columns. Many files, particularly assembly listings or t-    formats. In common with some other contributions to SIG/-
  105. occupy only a few lefthand columns on each page, which m-    parentheses to indicate indirect references, and as a so-
  106.  
  107. THCOL PRINT.DOC -8
  108.  
  109.                     Further space saving is possible-                    
  110. PRINT.LBR is a substantial exten-    at eight lines per inch rather t-    Then, the following lines give s-
  111. volume 206. ENCOL contained prog-    the programs TWFIL, THFIL, or FO-                    
  112. so that it could be listed in tw-    and FOCOL must take account of t-        PRINT A.ASM        -
  113. columns. Many files, particularl-    on each page in order to do thei-        PRINT A.AQM        -
  114.  
  115.  
  116. FOCOL PRINT.DOC -8
  117.  
  118.                 Experience has shown tha-    With the advent of squee-        PRINT [B] ((B:X)-
  119. PRINT.LBR is a substanti-    retain a significant por-    members might plausibly -        PRINT [8] (Y)    -
  120. volume 206. ENCOL contai-    of 16.5 characters per i-    programs with the capabi-                -
  121. so that it could be list-    This is particularly con-    formats. In common with -        PRINT (X),D.ASM    -
  122. columns. Many files, par-    purposes. If the comment-    parentheses to indicate -        PRINT (B:Y)    -
  123.  
  124. TWFIL 4.LIB=PRINT.DOC,PRINT.DOC
  125.  
  126. PRINT.LBR is a substantial extension to ENCOL.LBR, conta-    PRINT.LBR is a substantial extension to ENCOL.LBR, conta-
  127. volume 206. ENCOL contained programs which would fold a -    volume 206. ENCOL contained programs which would fold a -
  128. so that it could be listed in two (TWCOL), three (THCOL)-    so that it could be listed in two (TWCOL), three (THCOL)-
  129. columns. Many files, particularly assembly listings or t-    columns. Many files, particularly assembly listings or t-
  130. occupy only a few lefthand columns on each page, which m-    occupy only a few lefthand columns on each page, which m-
  131.  
  132. THFIL 5.LIB=PRINT.DOC,PRINT.DOC,PRINT.DOC
  133.  
  134. PRINT.LBR is a substantial exten-    PRINT.LBR is a substantial exten-    PRINT.LBR is a substantial exten-
  135. volume 206. ENCOL contained prog-    volume 206. ENCOL contained prog-    volume 206. ENCOL contained prog-
  136. so that it could be listed in tw-    so that it could be listed in tw-    so that it could be listed in tw-
  137. columns. Many files, particularl-    columns. Many files, particularl-    columns. Many files, particularl-
  138. occupy only a few lefthand colum-    occupy only a few lefthand colum-    occupy only a few lefthand colum-
  139.  
  140. FOFIL 6.LIB=PRINT.DOC,PRINT.DOC,PRINT.DOC,PRINT.DOC
  141.  
  142. PRINT.LBR is a substanti-    PRINT.LBR is a substanti-    PRINT.LBR is a substanti-    PRINT.LBR is a substanti-
  143. volume 206. ENCOL contai-    volume 206. ENCOL contai-    volume 206. ENCOL contai-    volume 206. ENCOL contai-
  144. so that it could be list-    so that it could be list-    so that it could be list-    so that it could be list-
  145. columns. Many files, par-    columns. Many files, par-    columns. Many files, par-    columns. Many files, par-
  146. occupy only a few leftha-    occupy only a few leftha-    occupy only a few leftha-    occupy only a few leftha-
  147.  
  148.         -------------------------------------------
  149.  
  150. PRINT.COM and PRINT.CMD <are> specialized for ports 0FAH and 0FBH, of the
  151. Godbout System Support, or equivalent ports on an Interfacer card. The
  152. port assignments are assembly parameters - <data> and <status>. The
  153. subroutine <lpw> in each program can be replaced by a BDOS call in a system
  154. for which a satisfactory printer BIOS is installed.
  155.  
  156.         -------------------------------------------
  157.  
  158.  
  159. [end]
  160. [Harold V. McIntosh, 27 December 1985]
  161.