home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PASCAL / MADTRB20.ZIP / PGM-AIDE.DOC < prev    next >
Encoding:
Text File  |  1985-10-10  |  7.1 KB  |  143 lines
  1.                  DOCUMENTATION FOR PROGRAM AIDE
  2.                          by Lynn Canning
  3.                      
  4. Credits:
  5.   Program Aide utilizes a number of modules that were written
  6.   by several people and then placed in the public domain.  Please note
  7.   the copyright and use information at the beginning of the modules.
  8.  
  9.   STAYRES.332 is a skeleton program from which the memory resident version
  10.   of Program Aide was created.  It was written by Lane Ferris, 4268 26th St,
  11.                                                   San Francisco, Ca 94131.
  12.  
  13.   StayXit.320 was written by Lane Ferris.
  14.   
  15.   WINDO.INC was originally written by Michael A. Covington, address unknown.
  16.   It was modified by Lane Ferris for use in the STAYRES demo program.  It
  17.   was further modified by Lynn Canning to add additional features.  It can
  18.   now be included in any application requiring windows.
  19.   (See the documentation at the beginning of the module).
  20.  
  21.   SC.INC and PGM-AIDE.COM were written by Lynn Canning, 9107 Grandview,
  22.                                           Overland Park, Ks. 66212
  23.                                           913-649-7334.
  24.  
  25.   EP.INC was written by Lynn Canning and Karson W. Morrison
  26.                                          RD 1, Box 531
  27.                                          Ringoes, NJ 08551
  28.  
  29. This program was distributed in a library type file which should have
  30. included the following modules:
  31.  
  32. PGM-AIDE.COM  -  The memory resident version of Program Aide.
  33. PGM-AIDE.PAS  -  Turbo Pascal source code for the above.
  34. PGM-AIDE.DVR  -  Include file for the PGM_AIDE driver.
  35. SC.INC        -  Include file for Screen Counter.
  36. WINDO.INC     -  Include file for window routines.
  37. EP.INC        -  Include file for Epson Printer.
  38. PGM_AIDE.DOC  -  Documentation file for the above.
  39. STAYXIT.320   -  Include file to remove memory resident program.
  40.  
  41. Installation:
  42.  
  43. Program Aide can be executed from DOS and will become memory resident.
  44. It can then be popped up when executing most programs.  Problems may 
  45. result if other memory resident programs have previously been called.  
  46. It is therefore suggested that Program Aide be called before other 
  47. memory resident programs.  This seems to eliminate the problem.  I have 
  48. popped up a memory resident program and then popped Program Aide right 
  49. over the top of it with no problems.  Program Aide is popped up by 
  50. typing Alt-F1 after it is installed.
  51.  
  52. SC.INC is the include module for SCREEN COUNTER.  A stand alone version 
  53. of SCREEN COUNTER can be compiled from SC.INC by changing the last (end;) 
  54. in the source to (end.) and inserting the line {$I WINDO.INC } on the 
  55. first line.  The constant MaxWin = 1 must be inserted into the constant
  56. section.  Rename SC.INC to SC.PAS.
  57.  
  58.  
  59. EP.INC is the include module for EPSON PRINTER.  A stand alone version 
  60. of EPSON PRINTER can be compiled from EP.INC by changing the last (end;) 
  61. in the source to (end.) and inserting the line {$I WINDO.INC } on the 
  62. first line.  The constant MaxWin = 3 must be inserted into the constant
  63. section.  Rename EP.INC to EP.PAS.
  64.  
  65.  
  66.  
  67. Program Documentation:
  68.  
  69. I am not particularly familiar with the code in the resident module or
  70. StayXit.320.  I therefore refer you to the documentation included in the 
  71. modules source code.  This was written by the original author and will have 
  72. to stand on its own.
  73.  
  74. Program Documentation for SC.INC:
  75.  
  76. Screen Counter was written to count screen positions.  When Screen Counter
  77. is activated you will notice four counters on the last line of the screen.
  78. The line counter obviously tells you what line you are on and correspondingly
  79. the column counter gives you the column or your position on the line.  The
  80. trip counters is used to determine the horizontal and vertical distance
  81. between two points on the screen.  Note that the column and line counters
  82. correspond to the X and Y screen coordinates respectively.  These counters can
  83. therefore be used to determine the screen coordinates when needed in a program
  84. such as dBaseII or when writing window programs.
  85.  
  86. To use the trip counters, place the cursor on the leftmost point of
  87. where you wish to begin counting.  Hit the F2 key to reset the counters to 1.
  88. Move the cursor to the rightmost point.  The htrip counter now contains the
  89. horizontal distance between the two points including the starting and ending
  90. positions.  The vtrip counter can be used to count lines or vertical distance.
  91.  
  92. There are of course limitations on the use of the trip counters.  The
  93. counters reset to the value of the column and line counters if you attempt to
  94. drive them to a negative value by moving left or up.  The counters count
  95. from left to right and top to bottom.  If you overshoot your target position,
  96. you can move the cursor to the right or up and the counters will decrement.
  97.  
  98. Cursor movement is controlled by the number pad keys.  For details, see the
  99. on-screen help menu by pressing the F1 key when in the program.  The cursor
  100. will screen wrap except when attempting to go left at line 1 column 1 or
  101. right at line 24 column 80.
  102.  
  103. Program Documentation for EP.INC:
  104.  
  105. This program is mostly self explanatory.  Various print options for an
  106. Epson printer are turned on an off through the use of a menu.  When the
  107. program is called, the printer is reset to its power up state.  Various
  108. options can then be set by hitting the corresponding number or letter.
  109. Options previouly set can be turned off by hitting the number or letter
  110. key again.  Some options are incompatible with other options (see the 
  111. printer manual for Elite mode).  After the options are set, you can see
  112. the results by printing a test pattern.  This pattern also specifies the
  113. options set.  Try option "K" for printing program listings.
  114.  
  115. Program Documentation for WINDO.INC:
  116.  
  117. This program creates windows by utilizing user specified parameters.  The
  118. options include setting foreground and background colors and the type of
  119. borders desired.  Complete documentation for this program is included in
  120. the module.  This module is completely transportable and can be utilizied
  121. in other programs requiring windows.  A time delay procedure is included
  122. which will suspend program operation for a specified number of seconds.
  123. Use of this routine instead of the Turbo delay command will allow your
  124. program to be transportable between systems with different clock speeds
  125. while still maintaining the same delay interval.
  126.  
  127.  
  128. Misc Documemtation:
  129.  
  130. The resident program will work with a color graphics card or a 
  131. momochrome monitor.  If you are using a composite monochrome monitor
  132. such as is found on the Compac and IBM portables or you are not using
  133. a color monitor with a color graphics card it may be necessary to change
  134. the color combinations within the source code to the monochrome values
  135. in order to see things better.
  136.  
  137. Additional utilities can be included by modifying PGM-AIDE.DVR as 
  138. appropriate and including the module in PGM-AIDE.PAS.  It is suggested
  139. that the additional module be tested as stand-alone then made it into an
  140. include file when it is completed.  This approach  will speed testing
  141. considerably.  Keep in mind that include files cannot be nested.
  142.  
  143.