home *** CD-ROM | disk | FTP | other *** search
/ Loadstar 128 #29 / q29.d81 / t.list tamer < prev    next >
Encoding:
Text File  |  1992-01-01  |  4.9 KB  |  103 lines
  1.  
  2.  
  3.                 Z E R O   P A G E:  LOADSTAR'S LISTING TAMER
  4.                                       
  5.                       Program and Text by Bob Markland
  6.  
  7.  
  8.     Programmers' utilities are born of absolute necessity or just to handle
  9. a particular task more efficiently.  LISTING TAMER is a convenience utility
  10. designed to create more managable hard copies of BASIC program listings.
  11.  
  12.     Sure, you can use BASIC's CMD4:LIST routines, but the results are less
  13. than ideal.  If your paper isn't precisely aligned, text is printed over
  14. page perforations.  Flex the perforations a couple of times and the pages
  15. begin falling apart.  And if you've made any changes to a program
  16. differentiating one listing from another is a factor.
  17.  
  18.     LISTING TAMER solves all these problems.  It prints an identifying
  19. header and page number at the top of each page, lists a uniform number of
  20. program lines, then skips over page perforations.  With many printers you
  21. can also use single sheet paper if you prefer.
  22.  
  23.  
  24.  COMPATIBILITY
  25.  -------------
  26.  
  27.     LISTING TAMER is a BASIC utility for the 128.  Because of hardware
  28. differences it won't work in 64 mode.  However, even though a BASIC program
  29. written for the 64 may not run in 128 mode, it can nonetheless be loaded
  30. and listed successfully.
  31.  
  32.     The utility will work with any printer/interface combination that
  33. responds to OPEN4,4,0:CMD4:LIST and recognizes a one byte FORM FEED
  34. [CHR$(12)].  You may have to flip your interface's DIP switch for LINEFEED
  35. ON/OFF, depending upon your hardware configuration.  Also, if you prefer
  36. your printout to be in lowercase, use OPEN4,4,7:CMD4:LIST.
  37.  
  38.  
  39.  USING LISTING TAMER
  40.  -------------------
  41.  
  42.     LISTING TAMER works equally well from both the 40- and 80-column
  43. screens.  The differences are sensed automatically and no intervention is
  44. required.
  45.  
  46.     To produce a hard copy of a BASIC program in memory.  BOOT"LISTING
  47. TAMER" from disk each time you wish to print a listing.  Or you can use
  48. BLOAD or the JiffyDOS (%) command then SYS5888.  If the program you are
  49. working with is written entirely in BASIC and does not make any use of the
  50. free RAM at 5888-7167 ($1700-$1BFF) you may not have to BOOT"LISTING TAMER"
  51. each time you print a listing.  A simple SYS5888 will do once it's in
  52. memory.
  53.  
  54.     The first prompt asks how many program lines to print on each page.  To
  55. accept the default (40) press RETURN on the blank line.  Two factors will
  56. affect your choice:  If you utilize the full 160 character line capability
  57. of the 128, each program line will require two printer lines to list,
  58. limiting you to as few as 20-25 program lines per page.  On the other hand,
  59. if your program lines occupy a single line on the 80 column screen and
  60. don't contain a large number of color and cursor control characters, 50
  61. program lines per page is appropriate.
  62.  
  63.     Unfortunately, there are no absolutes when listing a program.  Upon
  64. encountering cursor control or color symbols some interfaces automatically
  65. convert them into words (e.g. [UP], [DOWN], [BLUE], etc.).  An 80 character
  66. BASIC program line may thus require more than one printer line.  By
  67. printing 40 or fewer program lines then sending a FORM FEED proper page
  68. formatting is retained.
  69.  
  70.     On rare occasions a program may contain a series of lines packed with
  71. control characters which, when expanded will corrupt the page formatting.
  72. Good programming techniques go a long way toward eliminating many such
  73. problems.  Replace a line containing 17 cursor DOWN and 15 cursor RIGHT
  74. characters with CHAR,15,17:.  If you can set your interface to print
  75. Commodore characters instead of words, you may want to do so, thus
  76. minimizing potential problems.  Otherwise, you may have to select fewer
  77. lines per page and print the listing again.
  78.  
  79.     The second prompt asks for the page header information.  Enter 1 to 38
  80. characters with a CHR$ value in the range of 32 to 95 and press RETURN.
  81.  
  82.     Check your printer and paper supply then press RETURN again to begin
  83. printing.  During printing, hold down the RUN/STOP key to abort.  Keep in
  84. mind that an entire page may already be in the printer's buffer, so
  85. printing may not stop immediately.
  86.  
  87.     In the interests of simplicity and compactness, LISTING TAMER assumes
  88. two things:  1) That there is a BASIC program currently in memory.  2) That
  89. a printer is connected, on line, and loaded with paper.  Failing this,
  90. LISTING TAMER may crash and/or lock up the keyboard.
  91.  
  92.     LISTING TAMER lists the entire program from beginning to end.  When
  93. listing only a portion of a program formatting is unnecessary.  A range of
  94. lines may be specified using the standard CMD4:LISTxxxx-xxxx commands.
  95.  
  96.     Because this is a programmers' utility, intended for use with a program
  97. of your own, it should be stored on your favorite utility disk for ease of
  98. use while you are programming.  The program isn't called from LOADSTAR and
  99. doesn't return to LOADSTAR.
  100.  
  101.                      \\\\\ RETURN - Menu \\\\\
  102.                                                                            
  103.