home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / demon / amstrad / check5.arc / CHECK5.DOC next >
Encoding:
Text File  |  1994-02-19  |  4.3 KB  |  124 lines
  1. CHECK5                                              J. Elliott, 18 February 1994
  2. ================================================================================
  3.  
  4. Overview:
  5. ---------
  6.  
  7.   Readers of PCW Plus Magazine will know of the program CHECK3.BAS, a program
  8. for checking whether a listing has been typed correctly. CHECK3 requires a
  9. rather long-winded procedure to be gone through: Save program to check as
  10. ASCII, run CHECK3 to produce a "checked" listing, reload first program, fix
  11. errors, go back to CHECK3, etc etc etc......
  12.  
  13.   CHECK5.RSX is a replacement for CHECK3.BAS. It is easier to use, since it is a
  14. memory-resident program and only has to be set up once. The program being
  15. checked does not need to be saved for checking to take place. Listings may be
  16. sent to the screen, the printer or a disc file.
  17.  
  18. Setting up:
  19. -----------
  20.  
  21.   Using PIP, copy the files CHECK5,RSX, BASIC.COM and GENCOM.COM to the RAMdisc.
  22.   Type:
  23.         M:  [RETURN]
  24.         REN CHKBASIC.COM=BASIC.COM  [RETURN]
  25.         GENCOM CHKBASIC CHECK5  [RETURN]
  26.  
  27.   Then copy the file CHKBASIC.COM to your BASIC work disc. You will only need to
  28. use CHECK5.RSX again if you want to use a different version of BASIC.COM.
  29.  
  30. Loading:
  31. --------
  32.  
  33.   To use CHECK5, type
  34.  
  35.    CHKBASIC
  36.  
  37. at the CP/M prompt. CHECK5 will announce its presence; BASIC will then sign on
  38. and start normally. CHECK5 uses 1280 bytes at the top of the BASIC programming
  39. area, so some BASIC language extensions and machine-code programs may not work.
  40. You can add the normal command extensions if you want; CHKBASIC MENU etc.
  41.   As a bonus, CHKBASIC will not return to CP/M if there is a CP/M error such as
  42. "Invalid drive".
  43.  
  44. Checking a program:
  45. -------------------
  46.  
  47.   To produce a checked listing on screen, type:
  48.  
  49.     LIST*    [RETURN]
  50.  
  51. You can add line-numbers, e. g.
  52.  
  53.     LIST* 100-220
  54. or  LIST* 1000-
  55. or  LIST*90
  56.  
  57. The listing will appear as normal, except that the "check" numbers will be
  58. printed in a column down the right-hand side of the screen. The "check" numbers
  59. are in inverse video (to make them stand out).
  60.  
  61.   The numbers will come out the same as those produced by the PCW Plus CHECK3
  62. program.
  63.  
  64.   A checked listing can be paused using ^S [f5] and restarted with ^Q [f3], but
  65. you cannot stop it with ^C [STOP].
  66.  
  67. Printed listings
  68. ----------------
  69.  
  70.   If you want a printed copy of your checked listing, use LLIST* instead of
  71. LIST*. The "check" numbers will appear at the right of the paper.
  72.  
  73.   The cursor will flash while a printed listing is being made. This is nothing
  74. to worry about.
  75.  
  76. Listings to a disc file
  77. -----------------------
  78.  
  79.   To make a disc file containing the checked listing, type
  80.  
  81. SAVE "filename",C
  82.  
  83. where "filename" is the name you want to use for your listfile. The listfile
  84. will be in a similar format to the printer output.
  85.  
  86. Command Summary:
  87. ----------------
  88.  
  89. To get a checked listing on the screen, use LIST* instead of LIST.
  90. To get a checked listing on the printer, use LLIST* instead of LLIST.
  91. To get a checked listing on disc, use SAVE "listfile",C.
  92. ________________________________________________________________________________
  93.  
  94. Troubleshooting:
  95. ----------------
  96.  
  97. Problem: A message appears: "CHECK5 error: Unknown BASIC version."
  98. Cause:   CHECK5 only works with Mallard BASIC versions:
  99.             1.29, 1.39, 1.44, 1.47, 1.48.
  100.             If you have a different version, you will have to use CHECK3.
  101.  
  102. Problem: LLIST was typed and nothing happened, and the cursor isn't flashing.
  103. Cause:   1. You may have pressed [f5] by mistake. Try pressing [f3] and seeing
  104.             if that cures the problem.
  105.          2. Check that the printer is online and ready.
  106.  
  107. Problem: Program X crashes when CHKBASIC is used.
  108. Cause:   Program X doesn't check that high memory is available before using it.
  109.          The only thing to do is complain to the programmer.
  110. ________________________________________________________________________________
  111.  
  112. Compatibility with GSX:
  113. -----------------------
  114.  
  115.   CHECK5 is fully compatible with the CP/M graphics system GSX, provided that
  116. GENGRAF is used on BASIC.COM *before* GENCOM is, ie:
  117.  
  118. GENGRAF BASIC
  119. GENCOM BASIC CHECK5
  120.  
  121. in that order.
  122. ________________________________________________________________________________
  123.  
  124.