home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / ibm1 / do101j1.arj / HISTORY.SCR < prev    next >
Text File  |  1992-03-15  |  7KB  |  215 lines
  1. * SCRIPT: HISTORY.SCR -- A history of the DO script processor
  2. /STOP TOC
  3. /DOCUMENT ON
  4. /SET t "c 14 1"
  5. :TOC
  6. .clr
  7. /GOSUB DispTitle "A History of the DO script processor"
  8. /VERSION
  9. »ye«1»gy«.»wh«  In the Beginning . . .
  10. »ye«2»gy«.»wh«  Description of Version Numbers
  11. »ye«3»gy«.»wh«  Version History
  12.     »ye«3.1»wh«   Version Index
  13. »ye«4»gy«.»wh«  About this script
  14. »re«0»gy«.»wh«  Exit
  15. »#«
  16. /SET Default 0
  17. /GETS Chapter Default "    »gr«Selection»gy«:»#«"
  18. /SET Default OOPS
  19. /GOTO %Chapter %Default
  20. :1
  21. /GOSUB DispTitle "In the Beginning . . ."
  22. The »%t«DO»ye« script processor»#« has evolved over many years of personal
  23. use.  Although the first public version has a version number of
  24. »re«1.00»#«, the »%t«DO»ye« script processor»#« has actually gone through »+gr«7»#« major
  25. revisions in private use.
  26.  
  27. .pg clr
  28. The »%t«DO»ye« script processor»#« started out to meet three needs.
  29.  
  30. »cy«1»gy«.»#«  To be used as an automated tutor and display of features
  31.     for other products.
  32.  
  33. »cy«2»gy«.»#«  To provide an extension to DOS' BATch capatilities.
  34.  
  35. »cy«3»gy«.»#«  To automate utility functions which were too complex to
  36.     automate with BATch files and yet, too simplistic to need a
  37.     complete program written in a higher-level language such as
  38.     PASCAL or C.
  39.  
  40. As you can see from the current release, it has evolved well
  41. beyond these beginnings as requirements dictated.
  42. .pg
  43. :2
  44. /GOSUB DispTitle "Description of Version Numbers"
  45. »%t«DO»#« version numbers are displayed using the »%t«/VERSION»#« command. You
  46. can see the current version number in the line at the bottom of
  47. the screen.
  48.  
  49. /SET B 15
  50. /LOOK 25 17 1
  51. /IF %Found EQ : 2.1
  52. /SET B 19
  53. :2.1
  54. .pg clr
  55. /GOSUB Arrow %B
  56.     The »ye«version number»#« is composed of three parts:
  57.  
  58.     »gr«MAJOR VERSION»gy«:»#«  This number indicates a major revision to the
  59.                     »%t«DO»ye« script processor»#«'s capabilities
  60.  
  61. .pg
  62. /GOSUB Arrow @math(%B+2)
  63.     »gr«MINOR VERSION»gy«:»#«  These are incremental enhancements to the
  64.                     capabilities
  65.  
  66. .pg
  67. /GOSUB Arrow @math(%B+4)
  68.     »gr«REVISION»gy«:»#«       A letter here indicates an error correction or
  69.                     revision to the internal workings without
  70.                     changes to the »%t«DO»#« capabilities
  71.  
  72. .pg clr
  73. /GOSUB Arrow @math(%B+10)
  74.     The »wh«date»#« shows the date on which this version was produced.
  75.  
  76. .pg
  77. :3
  78. /GOSUB DispTitle "Version History"
  79. Rather than bore you with the years of evolution of the »%t«DO»ye« script
  80. processor»#«, this history starts with the first public release of
  81. »%t«DO»#«. »wh«Enter the release number about which you are interested to
  82. see a description of its capabilities.»#« Enter any portion of the
  83. number to see information about all releases (e.g. "»re«1»#«" shows
  84. information about major release 1, "»re«1.2»#«" shows information about
  85. information about minor releases until "»re«1.3»#«").
  86.  
  87. »bl«NOTE»gr«:»re« 1.00»#« will show information about version 1.00 only.  It
  88.       will stop at version »ye«1.01»#«. Enter »re«1»#« to see a complete history
  89.       of version 1.
  90.  
  91. »wh«Only major versions and significant bug fixes are displayed.»#«
  92. The revision letter is placed before the change if applicable.
  93.  
  94. .pg
  95. The index starts on the next page. You will be returned to the
  96. main menu after viewing this feature. Enter "»gr«3.1»#«" to return to
  97. the version index and select another version.
  98.  
  99. .pg
  100. :3.1
  101. /GOSUB DispTitle "Version History Index"
  102.  
  103. Released versions:
  104.  
  105.     »re«1.00 »gy« -»ye« First Public Release
  106.     »re«1.01 »gy« -»ye« Modified »%t«DoIt»ye« Command
  107. /SET Default 1.00
  108. .go 1 19
  109. /GETS Chapter Default "    »wh«Revision (»re«Q»wh« to Quit)?»#«"
  110. /SET Default 3.OOPS
  111. /GOTO %Chapter %Default
  112. :1
  113. :1.00
  114. /GOSUB DispTitle "DO script processor version 1.00"
  115.     »cy«-»#« Created Runtime version and Shareware version
  116.     »cy«-»#« Added date and time functions
  117.     »cy«-»#« Added string functions
  118.     »cy«-»#« Added math functions
  119.     »cy«-»#« Created Tutorial
  120. .pg
  121.     »cy«a»#« Corrected problem in display routines.
  122.     »cy«a»#« Added »%t«/LISTVARS»#« command for debuging
  123. .pg
  124.     »cy«b»#« Corrected obscure error which would have evaluated "A1" as a
  125.       formula in a »%t«/MATH»#« function
  126.  
  127. .pg
  128. :1.01
  129. /GOSUB DispTitle "DO script processor version 1.01"
  130.  
  131.     »cy«-»#« Modified »%t«DoIt»#« command to only run a command shell if the
  132.       user forces one or the user selects a batch file.  This
  133.       allows the DoIt command to return the error code from the
  134.       program through the variable »ye«ERRORLEVEL»#«.
  135.       The window is »re«NOT»#« reset after a »%t«DoIt»#« command is executed.
  136.       This cleans up cursor positioning.
  137. .pg
  138.     »cy«b»#« Added page pause to »%t«/LISTVARS»#« command
  139.     »cy«b»#« Modified minor problem with »%t«/SIZE»#« command
  140.     »cy«b»#« Correct bug in »%t«DoIt»#« command when no parameters entered
  141.     »cy«b»#« Modified »%t«/FREE»#« to allow »re«NULL»#« drive and branch
  142. .pg
  143.     »cy«c»#« Added »%t«~064pad()»#« function
  144. .pg
  145.     »cy«d»#« Added »ma«Turbo Async Professional»#« communications routines
  146.       (TurboPower software).  This will allow additional
  147.       communications features to be added.
  148. .pg
  149.     »cy«i»#« Modified the »%t«~064trim()»#« function to accept only the string
  150.       and default to removing spaces from both ends.
  151. .pg
  152. :Q
  153. * Will be returned to TOC because of DOCUMENT Mode
  154. :3.OOPS
  155. .bell clr
  156. Invalid version number %chapter
  157.  
  158. .pg
  159. /goto 3.1
  160. :4
  161. /GOSUB DispTitle "About this Script . . ."
  162. This history of the »%t«DO»ye« script processor»#« is implemented as a »%t«DO»#«
  163. script.  It shows just a small portion of the power of the DO
  164. script processor.  You might want to examine the script using
  165. your favorite text editor or »%t«DO»#«'s built in text editor.
  166.  
  167. To examine this script using the »%t«DO»#« full-screen editor, enter the
  168. command:
  169.  
  170.     »%t«DO»cy« history /E»#«
  171.  
  172. from the DOS command line.
  173.  
  174. Press »bo«<alt-x>»#« or »bo«<F10>»#« to exit the script when you are finished.
  175. The DO editor responds to wordstar like commands.  See the file
  176. »ye«EDITOR.CMD»#« for a set of commands available in the full-screen
  177. editor.
  178.  
  179. .pg 0
  180. :0
  181. /DOCUMENT OFF
  182. /GOTO End
  183. :OOPS
  184. .bell
  185. »ye«Invalid Chapter»gy«: »+re«%Chapter»#«
  186. .pg -20
  187. :DispTitle
  188. .wi full clr
  189. /SET title %DispTitle01
  190. »re«
  191. %title(C80)
  192. »#«
  193. /BOX 1 1 80 3 14 14 ""
  194. /VERSION
  195. .wi 4 5 80 23
  196. /return
  197. :Arrow
  198. /SET Y {Y}
  199. .wi full
  200. /SET title " "
  201. .go 1 23
  202. %title(L79)
  203. %title(L79)
  204. .go %Arrow01 23 ye
  205. │
  206. .go %Arrow01 24
  207. V
  208. .# wi 4 5 80 22
  209. .go 1 %Y
  210. /RETURN
  211. :End
  212. .wi full clr
  213. /DOCUMENT OFF
  214. /ENDEXEC CLEAR
  215.