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