home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / INFO / BATUTL / BAT204C.ZIP / README < prev    next >
Encoding:
Text File  |  1985-12-30  |  11.2 KB  |  259 lines
  1.  
  2.  
  3. pppppppppppppppppppp E R R A T A pppppppppppppppppppp (12/30/85)
  4.  
  5.     Program updates are made more often than the updates to the
  6. user's guide can keep up with.  In order to keep you better
  7. informed, this file contains information related to corrections
  8. or updates to the user's guide as well as notification of what
  9. problems were identified and fixed for the version of the program
  10. that is on this diskette.
  11.  
  12. Please refer to the users guide and the BATDOC.BAT file for
  13. information about Extended Batch Language commands and operation.
  14. For an example of the capabilities of 'EBL', execute the BATDEMO.BAT
  15. file by just typing "BATDEMO" at the DOS prompt.
  16.  
  17.  
  18.  
  19.  
  20. ====================================================================
  21. THE FOLLOWING LIST OF PROGRAM CORRECTIONS ARE FOR REFERENCE ONLY. The
  22. fundamental operation of the program has not changed. Please refer to
  23. the manual for examples of how Extended Batch Language can be used.
  24. ====================================================================
  25.  
  26. =='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='==
  27. PROGRAM CORRECTIONS/CHANGES (for version 2.00b of EBL)
  28. =='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='==
  29.  
  30.     1.    TO REDUCE THE SIZE OF THE INITIAL LOGO:  If the special
  31. SIZE option is used when BAT is first invoked, it will also
  32. signal the initial logo screen to be reduced in size.  This
  33. initial logo screen is used to present the user supported
  34. concept.  In addition, it will not wait for a key-press to
  35. continue.  The SIZE option is created by making the first
  36. executed BAT statement:
  37.  
  38.     BAT * [decimal size] [comment]
  39.  
  40.     The [decimal size] is a number representing the amount of
  41. space to reserve for a keyboard stack area.  The default is 512
  42. bytes.    This is described further in section 4.1 on page 8 of the
  43. users guide.  For example use:
  44.  
  45.     BAT * 512 = stack size & reduces logo size.
  46.  
  47.     2.    The initial logo screen describing the user supported
  48. concept had a 'Press any key to continue...'.  If a key was
  49. pressed to advance past this screen, the key was sensed only and
  50. not actually read in.  Therefore, the key remained in the
  51. keyboard buffer and sometimes interfered with programs following
  52. BAT in an AUTOEXEC.BAT file.  If a key is pressed, it is actually
  53. removed from the keyboard buffer now.
  54.  
  55.     3.    The stack status variable %Q gave incorrect information
  56. as to the source of the next character.  Previously, information
  57. was said to come from the stack if the stack was not empty.  No
  58. attention was paid however to see if the stack was enabled
  59. (STACK.ON).  Now, information is said to come from the stack if
  60. both the stack is not empty and the stack is enabled.  This will
  61. now correctly represent the status of the SOURCE of the next
  62. keyboard character.
  63.  
  64.     4.    The READ function did not echo the keyboard characters to
  65. the screen if the stack was not empty and the STACK.OFF command
  66. was used.  This is no longer the case.    In all cases when the
  67. READ command reads characters from the keyboard, they will be
  68. echoed to the display.    Note that the echo will still be
  69. suppressed if characters are read from the keyboard stack
  70. instead.
  71.  
  72.  
  73.  
  74. =='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='==
  75. PROGRAM CORRECTIONS/CHANGES (for version 2.01 of EBL)
  76. =='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='==
  77.  
  78.  1.    Added code to speed up CALL/GOTO for large files.
  79.  
  80.  2.    Changed stack interface to BIOS to fix bug with multimate/filecmd.
  81.  
  82.  3.    Fixed CLS so won't erase background color with ANSI.SYS installed.
  83.  
  84.  4.    Made character I/O go to directly to BIOS (not DOS) to allow attributes
  85.            in spite of the way ANSI.SYS device driver traps and removes
  86.            prewritten screen attributes.
  87.  
  88.  5.    'Eagle' DOS 1.25 compatible now.
  89.  
  90.  6.    Pressing Ctrl-break will now make the stack pointer for CALL and RETURN
  91.            commands into an empty stack condition.
  92.  
  93.  7.    Added attributes to help messages.
  94.  
  95.  8.    Fixed bug in CALL commands immediately after a DOS command in order
  96.            to properly save the code location for a RETURN command.
  97.  
  98.  9.    When in TRACE.ON mode, the trace messages on a color display are
  99.            green. Messages from program are white. Users with a monochrome
  100.            monitor will not see any difference.
  101.  
  102. 10.    Message space has been optimized so that overall code size is smaller.
  103.  
  104. 11.    Fixed bug in stacking an F1 key by itself.
  105.  
  106. 12.    Protected stack further from invalid function key codes or time delay
  107.            codes.
  108.  
  109. 13.    When putting screen attributes within the text under a BEGTYPE
  110.            command, the use of ESC characters (used with ANSI.SYS) in
  111.            the text are exclusive of the built in \0F style attribute
  112.            codes! Do not mix, use only one.
  113.  
  114. 14.    Changed values of extended INT16 (kbd) functions so won't
  115.            interfere with PROKEY. Prokey will now coexist with
  116.            Extended Batch Language as long as the following patch
  117.            is applied to Prokey. The following text describes the
  118.            necessary changes.
  119.  
  120.  
  121.  
  122. =='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='==
  123. PROKEY PATCH for versions 2.12 or 2.13 of PROKEY.
  124. =='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='==
  125.  
  126. IF YOU ARE USING PROKEY *BEFORE* VERSION 3.0, it must be patched to
  127. work with Extended Batch Language. Prokey verion 3.0 and higher DO NOT
  128. need patching and will co-exist with EBL without modification.
  129.  
  130. Early versions of Prokey were written without regard for allowing
  131. other software to access the keyboard interrupt chain (INT16).    EBL
  132. uses it for the stack, and Prokey uses it to simulate keystrokes.  The
  133. following patch will trick Prokey into thinking that no other software
  134. is using the interrupt chain.  As always, keep a copy of the original
  135. before patching.  If you don't understand how to use Debug, find a
  136. friend (maybe someone at your local PC Club) who does.
  137.  
  138. <<<For PROKEY Version 2.12>>>        <<<For PROKEY Version 2.13>>>
  139.  
  140. A>RENAME PROKEY.EXE PROKEY.E        A>RENAME PROKEY.EXE PROKEY.E
  141. A>DEBUG PROKEY.E            A>DEBUG PROKEY.E
  142. -E 2A60                 -E 2DC0
  143. xxxx:2A60  5A.26            xxxx:2DC0  5A.26
  144. -W                    -W
  145. Writing 3280 bytes            Writing 3600 bytes
  146. -q                    -q
  147. A>RENAME PROKEY.E PROKEY.EXE        A>RENAME PROKEY.E PROKEY.EXE
  148. A>                    A>
  149.  
  150. PLEASE NOTE:  You must also use EBL version 2.01 or better.  Also,
  151.   initially as your system starts up, you MUST have EBL loaded FIRST and
  152.   Prokey loaded SECOND in your AUTOEXEC.BAT.  The following is OK:
  153.  
  154.      BAT * 512
  155.      PROKEY /I
  156.  
  157. =='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='==
  158. PROGRAM CORRECTIONS/CHANGES (for version 2.02 and 2.03 of EBL)
  159. =='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='==
  160.  
  161. 1. A bug was found in the interface between EBL and DOS. When
  162.    EBL transfers control back to DOS, it also passes any
  163.    variables that have been modified (%0 to %9). The
  164.    problem found with this interface is seen only on
  165.    certain configurations of systems. The symptoms seen
  166.    in the system are completely unrelated to EBL and may
  167.    even show up as random errors with OTHER programs!
  168.    If you suspect problems with another program, you may wish
  169.    to switch to this new 2.03 version of EBL which removes this
  170.    rare and random problem with DOS.
  171.  
  172. 2. Because of problems with INT25 in DOS (disk read) which will
  173.    not work in some networks and when the DOS 'ASSIGN'
  174.    command is used, there is now a way to avoid this
  175.    interrupt. This interrupt is only used in the STATEOF
  176.    command. The new format for this command is:
  177.  
  178.    STATEOF [filename] [drive.list]
  179.  
  180.    The [drive.list] option is new. This token is a list of
  181.    diskette drive letters which are to be searched for the
  182.    specified [filename]. For example, a [drive.list] of
  183.    ACD will search disk drives A:, C:, and D: in that order.
  184.    If a diskette is not in drive A:, DOS will request that
  185.    the user insert one and say "Abort, Retry, Ignore".
  186.  
  187.    That is, only the drive letters listed in [drive.list]
  188.    will be searched and ALL MUST BE INSERTED AND READY.
  189.  
  190.    If the [drive.list] option is not used, the old method
  191.    of searching drives A:, B:, C:, and D: will be used and
  192.    if a diskette is not inserted or ready, it will be
  193.    ignored. Do not omit this option if you are using the
  194.    STATEOF command with the DOS 'ASSIGN' statement or in a
  195.    network environment.
  196.  
  197.    All errors and return codes for the STATEOF command are
  198.    the same. Note that now the STATEOF command can also
  199.    search expanded drive lettering (E:, F:, etc...) by using
  200.    the [drive.list] option with these respective letters.
  201.  
  202. 3. The new version of DOS 3.0 is also supported with this and
  203.    all future levels of EBL (ver 2.02 and higher). Please
  204.    note that this early version of EBL does not support
  205.    nested batch files under DOS 3.0 as it is in 2.0. In
  206.    other words, a second level of command processor cannot
  207.    be loaded to run another (nested) level of batch files.
  208.    I am currently looking at ways to fix this limitation
  209.    within DOS 3.0 and will notify everyone when I have a
  210.    version which allows nesting under DOS 3.0.
  211.  
  212. 4. The version 2.03 of EBL contains all the changes that were in effect
  213.    for earlier versions with one exception.  The keystrokes that are
  214.    emitted during a stacking operation are now much more complete.
  215.    Specifically, the scan codes for all ASCII characters are included
  216.    with the keystroke.    This change was made because some programs were
  217.    found to be looking for specific scan code values from the IBM-PC
  218.    instead of true ASCII values.
  219.  
  220.    The effect of this change is to allow STACK and BEGSTACK statements to
  221.    be used with a wider range of programs.  Multi-mate is an example of a
  222.    program that will now work properly with these EBL statements.  It is
  223.    expected that there may be other programs which will now work with the
  224.    keyboard stack within EBL.
  225.  
  226. =='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='==
  227. PROGRAM CORRECTIONS/CHANGES (for version 2.04b of EBL)
  228. =='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='==
  229.  
  230. 1. The STACK.OFF and STACK.ON statements did not operate properly with
  231.    DOS 3.1. Earlier versions of DOS and EBL work properly togeather.
  232.  
  233. =='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='==
  234. GENERAL INFORMATION .........
  235. =='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='=='==
  236.  
  237. A bug in DOS version 2.0 and 2.1 has been identified which can cause
  238. problems if you try to use the variables %0 to %9 in an AUTOEXEC.BAT
  239.  
  240. The following AUTOEXEC.BAT file will give bad results or bomb:
  241.   BAT * 512
  242.   BAT %1 = ABC
  243.   REM ABC CHARACTERS COME OUT LIKE %1
  244.  
  245. By restarting the file by hand, there won't be a problem. As a fix, you
  246. can have EBL restart it automatically by doing the following:
  247.   BAT * 512
  248.   BAT IF %Q = K STACK AUTOEXEC | STACK | EXIT
  249.   BAT STACK.PURGE
  250.   BAT %1 = ABC
  251.   REM ABC CHARACTERS COME OUT LIKE %1
  252.  
  253. It turns out that DOS version 2 supplies invalid pointers to EBL for the
  254. %0-%9 variables only during an AUTOEXEC. The locations DOS supplies
  255. get overwritten by DOS during it's execution. In some systems, it will
  256. hang. Hopefully, next versions of DOS won't have this problem.
  257.  
  258.  
  259.