home *** CD-ROM | disk | FTP | other *** search
/ World of Shareware - Software Farm 2 / wosw_2.zip / wosw_2 / DATABASE / DBAT110.ZIP / DBAT110.DOC < prev    next >
Text File  |  1992-01-10  |  10KB  |  230 lines
  1. ┌──────────────────────────────────────────────────────────────────────────────┐
  2. │         dBAT.EXE - *** The dBASE/Batch file programming language ***         │
  3. └──────────────────────────────────────────────────────────────────────────────┘
  4.                ┌───────────────────────────────────────────────┐
  5.                │    Documentation for dBAT.EXE version 1.10    │
  6.                └───────────────────────────────────────────────┘
  7.             (c) 1991,1992 ClipCode Associates, All rights reserved.
  8.  
  9.   dBAT COMMAND SUMMARY:             PURPOSE:
  10.   ─────────────────────             ────────
  11. |   * comment                         │ 1st char on line, all text is ignored
  12.     && comment                        │ all text following the && is ignored
  13.     ? "LiteralTextString"             │ line feed, then display string
  14.     ?? "LiteralTextString"            │ display string at current position
  15.     @ r#,c#                           │ position the cursor
  16.     @ r#,c# SAY "LiteralTextString"   │ position the cursor & display string
  17.     @ r#,c# ?? "LiteralTextString"    │ "                                  "
  18.     @ r#,c# CLEAR TO r#,c#            │ clear area with current color
  19. |   @ r#,c# PROMPT "LiteralTextString"│ display a menu item (use with MENU TO)
  20.     @ r#,c# TO r#,c#                  │ draw single line box
  21.     @ r#,c# TO r#,c# DOUBLE           │ draw double line box
  22.     CLEAR                             │ clear entire screen w/ current color
  23. |   MENU TO                           │ light-bar menu, set errorlevel, exit
  24.     QUIT                              │ exit the dBAT reading of the batch file
  25.     SET COLOR TO                      │ restore color to system default
  26.     SET COLOR TO #                    │ set default color to color number
  27. |   SET ICOLOR TO #                   │ set default inverse color to color nbr
  28.     SET CURSOR OFF                    │ turn system cursor off
  29.     SET CURSOR ON                     │ turn system cursor on
  30. |   SET SCREENIO TO BIOS              │ use BIOS to write to screen
  31. |   SET SCREENIO TO DIRECT            │ write directly to screen (default)
  32. |   SET SCREENIO TO DOS               │ use DOS to write to screen(for redirect)
  33.                              (| = new)
  34.  
  35.   QUICK START!!!  (see example .BAT files)
  36.   ──────────────
  37.   1. set echo off
  38.   2. run dBAT with the batch files path\name
  39.   3. jump over the dBAT portion of the batch file with a GOTO LABEL ──┐
  40.   4. PROC dBAT (starts the dBAT code)                                 │
  41.   5. QUIT      (ends the dBAT code)                                   │
  42.   6. LABEL                                               <────────────┘
  43.   7. if errorlevel 2 goto LABEL (always high before low number)
  44.   8. if errorlevel 1 goto LABEL
  45.   9. LABEL, etc...
  46.  
  47.   CONCEPT:
  48.   ────────
  49.     Quick text screen drawing by a batch file, using the power and
  50.     simplicity of dBASE type commands...
  51.  
  52.     Problem  - Batch files are slow in executing even with the fastest PCs.
  53.                Batch files are also limited in screen drawing and color
  54.                capablity.  Many batch file enhancement programs exist, but
  55.                they either require learning yet another proprietary command
  56.                set or they use a second proprietary screen definition file.
  57.  
  58.     Solution - dBAT.EXE is run from the controlling batch file and then
  59.                rereads the same batch file for embedded dBAT commands!
  60.                It is very quick, fully self contained in the same batch file,
  61.                and easily maintained / modified by the user.
  62.  
  63.                No compiler!
  64.                No second screen definition file!
  65.                No unfamiliar commands!
  66.                No slow, plodding execution!
  67.  
  68.                dBAT.EXE is Fast! Convenient! Familiar!
  69.  
  70.   dBAT.EXE COMMAND DETAILS:
  71.   ─────────────────────────
  72. | Command....: *
  73.   Description: Comment Line: should be first char on line, all text is ignored
  74.   Purpose....: Allows comments lines
  75.   Example....: *** This is an example comment line
  76.   ───
  77.   Command....: &&
  78.   Description: All text following the && is ignored
  79.   Purpose....: Allows comments to be placed on a command line
  80.   Example....: SET COLOR TO 31     && Bright white on blue
  81.   ───
  82.   Command....: ?
  83.   Description: Displays a specified expression on the next line of the screen
  84.   Purpose....: Causes a line feed to occur before the text string is displayed
  85.   Note.......: A ? without a text string moves the cursor to the beginning of
  86.                the next line without displaying any text
  87.   Caution....: Use only quoted strings, does not evaluate any expressions
  88.   Example....: ? " 1. First Menu Option "
  89.                ? " 2. Second Menu Option "
  90.   ───
  91.   Command....: ??
  92.   Description: Displays a string starting at the current cursor position
  93.   Purpose....: Allows one string after another to be displayed, which is
  94.                useful in creating colorful screens
  95.   Caution....: Use only quoted strings, does not evaluate any expressions
  96.   Example....: SET COLOR TO 159         && blinking => 31 + 128 = 159
  97.                @ 24,01 ?? "Press"
  98.                SET COLOR TO 31
  99.                @ 24,07 ?? "any key to continue..."
  100.   ───
  101.   Command....: @ r#,c#
  102.   Description: Position the cursor at a specified row & column
  103.   Example....: @ 10,20
  104.   ───
  105.   Command....: @ r#,c# ?? "LiteralTextString"
  106.   Description: Position the cursor at a specified row & column, and then
  107.                display the quoted string
  108.   Caution....: Use only quoted strings, does not evaluate any expressions
  109.   Example....: @ 10,20 ?? "1. First Menu Option"
  110.                @ 11,20 ?? "2. Second Menu Option"
  111.   ───
  112.   Command....: @ r#,c# CLEAR TO r#,c#
  113.   Description: Clear the specified area with current color
  114.   Example....: @ 01,02 CLEAR TO 22,78
  115.   ───
  116. | Command....: @ r#,c# PROMPT "LiteralTextString"
  117.   Description: display a menu item
  118.   Purpose....: create light-bar menus, use with MENU TO
  119.   Example....: @ 10,20 PROMPT "General Ledger"
  120.   ───
  121.   Command....: @ r#,c# TO r#,c#
  122.   Description: Draw a single line box
  123.   Example....: @ 00,01 TO 23,79              && draw the box
  124.                @ 01,02 CLEAR TO 22,78        && clear the box insides
  125.   ───
  126.   Command....: @ r#,c# TO r#,c# DOUBLE
  127.   Description: Draw a double line box
  128.   Example....: @ 00,01 TO 23,79 DOUBLE       && draw the box
  129.                @ 01,02 CLEAR TO 22,78        && clear the box insides
  130.   ───
  131.   Command....: CLEAR
  132.   Description: Clear the entire screen with the current color
  133.   Example....: CLEAR
  134.   ───
  135. | Command....: MENU TO
  136.   Description: light-bar menu command
  137.   Purpose....: activates the light-bar menu, sets errorlevel, and exits dBAT
  138.   Example....: MENU TO
  139.   ───
  140.   Command....: QUIT
  141.   Description: Exit the dBAT reading of the batch file
  142.   Purpose....: Speeds execution of dBAT by terminating the .BAT reading process
  143.                without reading top the end of the .BAT file
  144.   Example....: QUIT
  145.   ───
  146.   Command....: SET COLOR TO
  147.   Description: Restore color to system default
  148.   Example....: SET COLOR TO
  149.   ───
  150.   Command....: SET COLOR TO #
  151.   Description: Set default color to a color number
  152.   Note.......: Using Color Numbers greatly increases execution speed
  153.                run COLOR.COM or view COLOR.DOC
  154.   Example....: SET COLOR TO 116    && red on white
  155.                ? " U "
  156.                SET COLOR TO 127    && bright white on white
  157.                ?? " S "
  158.                SET COLOR TO 113    && blue on white
  159.                ?? " A "
  160.                * result    " U  S  A "  in red, white, & blue color
  161.   ───
  162. | Command....: SET ICOLOR TO #
  163.   Description: Set default enhanced / inverse color to a color number
  164.   Purpose....: control the color of the selected menu option
  165.   Note.......: Using Color Numbers greatly increases execution speed
  166.                run COLOR.COM or view COLOR.DOC
  167.   Example....: SET ICOLOR TO 116    && red on white
  168.   ───
  169.   Command....: SET CURSOR OFF
  170.   Description: Turn the system cursor off
  171.   Example....: SET CURSOR OFF
  172.   ───
  173.   Command....: SET CURSOR ON
  174.   Description: Turn the system cursor on
  175.   Example....: SET CURSOR ON
  176.   ───
  177. | Command....: SET SCREENIO TO BIOS
  178.   Description: use BIOS to write to screen
  179.   Purpose....: sends dBAT screen output through the PC's BIOS calls
  180.   Note.......: use for compatiblity problems
  181.   Example....: SET SCREENIO TO BIOS
  182.   ───
  183. | Command....: SET SCREENIO TO DIRECT
  184.   Description: write directly to screen (default)
  185.   Purpose....: sends dBAT screen output directly to the screen memory area
  186.   Note.......: this is the default, use only to reset
  187.   Example....: SET SCREENIO TO DIRECT
  188.   ───
  189. | Command....: SET SCREENIO TO DOS
  190.   Description: use DOS to write to screen (for redirection & piping)
  191.   Purpose....: sends dBAT screen output through the DOS's I/O system
  192.   Note.......: allows redirection: dBAT file.dat > device
  193.   Example....: SET SCREENIO TO DOS
  194.  
  195.   REGISTRATION:
  196.   ─────────────
  197.     See DBAT110.LIC for license information.
  198.  
  199.     To purchase (register) dBAT.EXE version 1.10, please make a check for
  200.     (USA) $25.00 payable to:
  201.  
  202.     Robert Stribling
  203.     ClipCode Associates
  204.     PO Box 26675
  205.     Greenville, SC 29616
  206.  
  207.   CLIPCODE ASSOCIATES TECH SUPPORT:
  208.   ─────────────────────────────────
  209.     Home BBS   - CyberTech #: (803) 242-3766  (public line)
  210.     CompuServe - CIS account #: 73357,1120
  211.     Voice #:     (803) 848-4707
  212.  
  213.   CLIPCODE SHAREWARE UPLOAD BBS:
  214.   ──────────────────────────────
  215.     Board:                             Line:           Sysop:
  216.     CyberTech Information Systems, SC  (803) 242-3766  Philip Yanov
  217.     Computer Connections, DC           (202) 547-2008  Robert Blacher
  218.     Data-Base BBS                      (908) 735-2180  Michael Walter
  219.     The Atlanta Exchange, GA           (404) 921-4395  Ken Cherry
  220.     VOR BBS, CA                        (707) 778-8944  Vern Buerg
  221.     The File Bank, CA                  (619) 728-4318  Bob Laszko
  222.     CompuServe (see IBMFF)
  223.  
  224.   OTHER CLIPCODE PRODUCTS:                                 Current Version:
  225.   ────────────────────────
  226.     CC.LIB  - a Clipper Function Library                   CC106.ZIP
  227.     PDM Sys - a Clipper SAA/CUA Pull Down Menu System      PDM105.ZIP
  228.  
  229.   *<eof>
  230.