home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1997 November / PCO1197.ISO / FilesBBS / DOS / AM205.EXE / AMFILES.EXE / README.TBU < prev    next >
Encoding:
Text File  |  1996-11-04  |  14.4 KB  |  324 lines

  1. !changes
  2. !new
  3.  
  4. tbu v3.3.1 - The Batch Utility - Release Notes - 04 Apr 95
  5. ----------------------------------------------------------
  6. Fixed a rollover problem with the -w While Increment Loop.  For example,
  7. when rolling in the range of 1 to 999, tBU would go to 1000 then to 1
  8. without ending the loop with errorlevel 1 or clearing the increment
  9. symbol.
  10.  
  11. Note: It has come to my attention that tBU v3.3 will not work correctly
  12. in a DOS window in Windows/NT from Microsoft.  As I do not have NT
  13. available yet I have not done a port to that operating system.  As soon
  14. as one becomes available I will attempt to get tBU running in the
  15. NT environment.
  16.  
  17. tbu v3.3 - The Batch Utility - Release Notes - 15 Jan 94
  18. --------------------------------------------------------
  19. Fixed a couple of minor bugs and added the -Z get string size function.
  20. See the updated TBU.DOC.
  21.  
  22. tBU v3.2.3 - The Batch Utility - Release Notes - 12 Aug 92
  23. ----------------------------------------------------------
  24. Fixed a minor bug in the -C convert_base routine that was not trapping
  25. errors in the input strings.
  26.  
  27. tBU v3.2.2 - The Batch Utility - Release Notes - 18 May 92
  28. ----------------------------------------------------------
  29. Changed the way -c input_character and -s input_string work.  A beep was
  30. always sounded if the timeout option was used, AND the input did timeout.
  31. In 3.2.2 the beep is optional.  Add a final argument 'B' to enable a beep
  32. (in either uppercase or lowercase).  The TBU.DOC file has been updated
  33. accordingly.
  34.  
  35.     Example:  tbu -c c "What next? " ABC 10
  36.  
  37. If a timeout occurs no beep will be sounded.  However ...
  38.  
  39.     Example:  tbu -c c "What next? " ABC 10 b
  40.  
  41. Will cause a beep on timeout, like the prior versions.
  42.  
  43. NOTE ! There is one known qwirk when using timeouts.  Because the input
  44.        functions have been written to allow reading redirected input from
  45.        files, a timeout represents an end-of-file condition.  Any
  46.        subsequent input commands (on the same command line) fail with
  47.        an eof-of-file condition.
  48.  
  49.        SO, if you're doing multiple inputs with timeouts, they must be
  50.        done on separate command lines.
  51.  
  52.  
  53. tBU v3.2.1 - The Batch Utility - Release Notes - 14 Apr 92
  54. ----------------------------------------------------------
  55. Oops ... this one's a bug fixer.
  56.  
  57. Fixed the -S substitute so characters within the replacement string
  58. are not themselves replaced.  This was a design decision, but we feel
  59. that it's more useful then having recursive replacements.
  60.  
  61. Fixed the -r read file so it actually reads up to 128 characters for a
  62. line, and sets the offset-symbol to account for the CR/LF line
  63. terminating characters in DOS.  If a line is longer than 128 characters
  64. the first pass returns the first 128, the next returns the next 128,
  65. and so on.  Line termination characters are not counted in the 128
  66. characters.
  67.  
  68. Fixed a weird bug in -Q qualify path when handling a nonexistent file
  69. or directory in the root of a drive only when using backslashes (\)
  70. and not forward slashes.  Anyway, -Q should work 100% now for any
  71. legal path specification with either type of slash.
  72.  
  73.  
  74. tBU v3.2 - The Batch Utility - Release Notes - 27 Mar 92
  75. --------------------------------------------------------
  76. With this release we're up to 40 functions in tBU !!!!!!
  77.  
  78. *** Added a NEW 'get path from symbol;path' function:
  79.  
  80. -g  Get path from symbol;path
  81.     Arguments:  <sym> <filespec> <path-sym>
  82.     Symbol:     Sets symbol to the fully qualified pathname of filespec
  83.                 if found in one of the directories found in symbol path-sym.
  84.                 Path-sym contains a semi-colon separated list of directories,
  85.                 the same as the PATH symbol.  The value is uppercased.
  86.     Errorlevel: Length of resulting string.
  87.     Example:    tbu -g p tbu.exe path   Sets P to C:\TBU.EXE
  88.     See also:   -Q, -T, -Y, drive, letter, directory
  89.  
  90.  
  91. *** Added a NEW 'qualify path' function:
  92.  
  93. -Q  Qualify path
  94.     Arguments:  <sym> <path>
  95.     Symbol:     Sets sym to the fully qualified path.
  96.     Errorlevel: Length of resulting string.
  97.     Example:    tbu -Q s1 ..            Sets S1 to the full parent path
  98.     Notes:      Does not detect whether the last path segment specified
  99.                 actually exists, which allows qualifying new files/dirs.
  100.                 The root is returned as drive:\
  101.     See also:   -T, -Y, drive, letter, directory
  102.  
  103. Very handy for commands where fully qualified paths need to be derived from
  104. possibly relative specifications.
  105.  
  106.  
  107. *** Added a timeout option to the 'input string' function, due to popular
  108. demand.  It now is:
  109.  
  110. -s  Input string
  111.     Arguments:  <sym> [prompt] [timeout]
  112.     Symbol:     Sets symbol to the string entered.  Prompt is optional.
  113.                 Input may be redirected to read a string from a file.
  114.                 Optional timeout is in seconds.
  115.     Errorlevel: Length of string entered. 0 = timeout.
  116.     Example:    tbu -s s "Your name:"   Prompts and sets S to entered string
  117.                 tbu -s s "Select: " 10  Prompts with 10 second timeout
  118.     See also:   -c -r redirection
  119.  
  120.  
  121. *** Added a count option to the 'substitute strings' function.  It now is:
  122.  
  123. -S  Substitute strings
  124.     Arguments:  <sym> <patt> <data> <string> [count]
  125.     Symbol:     Sets symbol to the newly replaced string, count times.
  126.     Errorlevel: Length of resulting string.
  127.     Example:    tbu -S s "old" "new" "This is old"   Sets S to This is new
  128.                 tbu -S p // \ %PATH% 99              Changes all /'s to \'s
  129.  
  130. So replacing all forward slashes (/) with backslashes (\) is easy:
  131.  
  132.     set D=c:/aa/bb/cc/dd
  133.     tbu -U d %D% -S d // \ $D 99
  134.  
  135. will upper-case the pathname in symbol D, then replace the slashes so DOS
  136. likes the path better.  tBU will perform 'n' substitutions, or until there
  137. are no more possible substutitions.  This particular substition is handy
  138. for making commands that can use either slash in pathnames. (The doubled
  139. forward- slashes are necessary because a forward slash can be used as an
  140. option prefix).  When used with a utility like 'sd', which will change
  141. the drive and/or directory in one command, environment symbols can be
  142. used instead of hardcoding paths in commands.
  143.  
  144.  
  145.  
  146. tBU v3.1 - The Batch Utility - Release Notes - 14 Jul 91
  147. --------------------------------------------------------
  148. Version 3.1 adds 2 new functions folks have been asking for ...
  149.  
  150. -P  Parse string
  151.     Arguments:  <sym> <string> <fieldnum> <delimiters> [compress]
  152.     Symbol:     Sets symbol to the field specified by fieldnum.  Fieldnum
  153.                 starts at 1.  Fields are parsed on any delimiter found.
  154.                 Optional compressed is Y or N (default N) will compress
  155.                 multiple delimiters without incrementing the field count.
  156.                 Delimiters should be enclosed in "double quotes" and may
  157.                 be multiple characters.
  158.     Errorlevel: Length of field.
  159.     Example:    tbu -P s ":tbu::X" 1 ":" N      Clears S, field 1 is empty
  160.                 tbu -P s ":tbu::X" 1 ":" Y      Sets S to tbu
  161.                 tbu -P s ":tbu,,X" 4 ":," N     Sets S to X
  162.                 tbu -P s ":tbu,,X" 2 ":," Y     Sets S to X
  163.     See also:   -m -p -s string
  164.  
  165. -r  Read file line
  166.     Arguments:  <sym> <filename> <offset-symbol>
  167.     Symbol:     Sets symbol to the line read from filename at offset.
  168.                 Offset-symbol contains the offset, and is set to the
  169.                 new offset, or "-1" if end-of-file is encountered.
  170.                 Offset is assumed to be 0 if offset-symbol is not set.
  171.     Errorlevel: Length of line read, without newline, or 0.
  172.     See also:   -c -s -P -p string
  173.     Notes:      By using the -r option in a loop an entire file may
  174.                 be read.  The maximum line length is 128 characters.
  175.  
  176.  
  177.  
  178. tBU v3.0 - The Batch Utility - Release Notes - 19 Apr 90
  179. --------------------------------------------------------
  180. This new version of tBU is a major enhancement over the prior version.
  181. It has expanded from 12 to 35 functions, while only growing about 4K in
  182. size!  Many new capabilities are included, and a few option letters
  183. have been changed.  The highlights and changes are listed below.
  184. !help
  185.  
  186. -- GETTING HELP --
  187. tBU v3.0 has a new help facility which may be used for documentation
  188. other than just itself.  To get full documentation or detailed help:
  189.  
  190.     tbu -h            Display the entire help file, one screen at a time.
  191.     tbu -h keyword    Get help on a specific function or topic.
  192.     tbu -h >prn       Print help on the printer (no pauses or !keywords).
  193.     tbu -h h          Get help on using -h with other documentation.
  194.  
  195. Or any combination of the above.  NOTE!  The keyword may be a tBU case-
  196. specific option letter WITHOUT the dash or slash option prefix.  The
  197. file TBU.DOC must be in the current directory or in a directory defined
  198. in the PATH environment symbol.  Redirecting the output to a file will
  199. cause the pagination (pausing) to be disabled.
  200. !keywords
  201.  
  202. Keywords for TBU.DOC other than option letters.  Partial words are allowed:
  203.     =               entering        keyboard        short
  204.     ?               environment     letter          size
  205.     ansi            equate          list            smileware
  206.     authors         exists          loop            sound
  207.     bases           extended        lowercase       space
  208.     batchmaster     extension       match           speaker
  209.     bbs             extention       memory          string
  210.     beep            file            multitasker     substitute
  211.     boolean         filename        name            substr
  212.     case            filesize        options         symbols
  213.     character       find            parse           timestamp
  214.     compare         format          path            topview
  215.     comparison      free            portion         tricks
  216.     convert         functions       qualify         uppercase
  217.     date            help            quick           usage
  218.     desqview        hints           redirection     use
  219.     directory       if              read            values
  220.     disk            increment       replace         version
  221.     dos             indirection     revision        warnings
  222.     drive           input           set             while
  223. !readmekeywords
  224.  
  225. Keywords for README.TBU.  Partial words are allowed:
  226.  
  227. changes             highlights      library         warranty
  228. dos                 keywords        new
  229. help                license         problems
  230. !highlights
  231.  
  232. -- HIGHLIGHTS --
  233. tBU v3.0 has all sorts of goodies built in.  Listed here are the options
  234. available.  All options are now case-sensitive (we were running out of
  235. letters!)
  236.  
  237.     O  DESCRIPTION                    O  DESCRIPTION
  238.     -  -------------------------      -  -------------------------
  239.     ?  Print tBU information          m  Match string in string
  240.     A  ANSI loaded check              n  Parse filename only
  241.     b  Beep the speaker               o  Lowercase string
  242.     C  Convert numeric base           p  Portion of string
  243.     c  Input single character         q  Equate sym to sym2
  244.     D  System date/time               R  DOS major/minor revision
  245.     d  Date of file                   S  Substitute strings
  246.     E  Maximum environment size       s  Input string
  247.     e  Free environment space         T  Test if file/dir exists
  248.     F  Format a timestamp             t  Extended keyboard check
  249.     f  Parse filename.extension       U  Uppercase string
  250.     h  Print help                     V  DesqView/Topview check
  251.     I  If comparison                  W  while v's loop
  252.     K  Get disk space                 w  while increment loop
  253.     k  Check disk space               x  Parse extension only
  254.     L  Get current drive letter       Y  Get current directory
  255.     l  Parse drive letter only        y  Parse directory
  256.     M  Get free memory in bytes       z  Get file size
  257.  
  258. To allow some tBU functions to be used where the environment space is
  259. too small, we've added the '=' option.  An equal sign may be used in
  260. place of the target environment symbol name to disable setting a new
  261. variable.  Some functions are only useful when the environment can
  262. be set with the result.
  263.  
  264. For debugging and simply printing things out, the '?' character may be
  265. prepended to any target environment symbol.
  266.  
  267. Also, a dollar sign '$' may be prepended to any environment symbol to
  268. allow one level of indirection.  This allows a symbol's value to be
  269. used as a new symbol name.  If used, the dollar sign MUST appear first
  270. in the symbol name.
  271.  
  272. -- CHANGES --
  273. We changed a few of the option letters from the previous version so
  274. things would make more sense.  ! BE SURE !  to modify your batch files
  275. when you install this new version.
  276.  
  277.    OLD OPTION:                        NEW LETTER:
  278.    ---------------------------------  ---------------------------------
  279.    -r  DOS revision ................  -R
  280.    -d  Get system date .............  -D
  281.    -t  Get system time .............  Gone, combined in new -D
  282.    -b  Substitute pattern for data .  -S
  283.    -u  Upper-case string ...........  -U
  284.    -w  Lower-case string ...........  -o
  285. !problems
  286. !DOS
  287.  
  288. Since tBU 3.0 was released in 1990 it has been discovered that there's
  289. a problem operating under MS-DOS and PC-DOS 3.2.  tBU seems to run
  290. correctly, but the environment symbols are never set or altered.  It
  291. doesn't seem to cause any problems or crashes, it just doesn't do what
  292. it's supposed to do.  We've not been able to find this problem, but
  293. we hope most folks are running MS/PC-DOS 3.3 or better.
  294.  
  295. ALSO!  This version has been tested under DOS 4.0 -AND- DOS 5.0 and
  296. it works great!
  297. !license
  298.  
  299. -- LICENSE --
  300. tBU may be used by private individuals or educational institutions free of
  301. charge.  Use by commercial organizations, companies, or any governmental
  302. agency requires a commercial license.  Commercial licenses are available for
  303. $20.00 per computer.  Sites licenses are negotiable.
  304. !warranty
  305.  
  306. -- WARRANTY --
  307. tBU has been tested extensively.  However, no warranty or guarantee is
  308. either expressed or implied, including but not limited to merchantability
  309. or fitness for any particular use.  In someone's famous words "if you
  310. break it, you own both parts".  The authors accept no liability for the
  311. use or misuse of this software.
  312.  
  313. As with any software, care must be taken to guard against Trojans and
  314. virus infection.  The original release of this software is available
  315. from the Fidonet bulletin boards listed in the documentation.
  316.  
  317. Todd Hill can be contacted at:
  318.  
  319. thill@monkeyboy.com
  320.  
  321. Todd Hill
  322. 13034 King Cir.
  323. Broomfield, CO 80020
  324.