home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-386-Vol-2of3.iso / b / benv302.zip / BENEDIT.HLP (.txt) < prev    next >
Borland Turbo Vision Help  |  1992-09-23  |  53KB  |  1,154 lines

  1. FBHF-
  2.  BENEdit 
  3. Welcome to BENEdit. This is a text editor that allows you to create and edit batch files quickly and easily. 
  4. BENEdit and BEN (the Batch ENhancer) work together to provide you with the perfect environment to do all your batch works. Now, you can use all your time to productive means by accessing all the features of BEN inside BENEdit. Just select any BEN function under the "BEN Functions" menu and answer a few questions. BENEdit will instantly create the necessary batch program lines for you. Creating batch files is never so easy before! 
  5.  menu is accessed by pressing Alt-Space.  All the other menus are accessed by pressing Alt-Z, where Z is the first letter of the menu. For example, the "File" menu is pulled down by Alt-F, and the "BEN Functions" menu is pulled down by Alt-B. H
  6.   For More Information
  7. Choose one of these for more information: 
  8.  Alphabetical
  9. listing
  10. functions
  11.  Borderstyle
  12.  Color
  13.  Using
  14. editor
  15.  Registration
  16.  Find
  17. dialog
  18. (text
  19. search)
  20.  Replace
  21. dialog
  22.  Edit
  23.  File
  24. command
  25.  File
  26. command
  27. Press ESC to put this help screen away. 
  28.  The Editor
  29. There are many ways to get into an open Edit window (make it active): 
  30.  1)  Click it.
  31.  2)  Press Alt-# (where # is that Edit
  32.      window's number).
  33.  3)  Choose the window from the Window
  34.      dialog box.
  35.  4)  Press (or click) F6 to cycle through the
  36.      open windows.
  37. To close the active Edit window, choose Window
  38. Close. Q
  39. Once in the Edit window, you enter text just as if you were using a typewriter. P
  40.  When you want to end a line, press Enter.
  41.  To exit the editor, press F10.
  42. See also: E
  43.  Cursor
  44. Movement
  45. Commands
  46.  Insert
  47. Delete
  48. Commands
  49.  Block
  50. Commands
  51.  How to run BEN:
  52. Format:   [d:][pathname] BEN function [params] [functions 
  53.           [params]...]
  54. Entering the command "BEN" alone in DOS gives you an online help of BEN's functions. Make sure that the file BEN.HLP is in the same directory as BEN.EXE. Otherwise, the online help wouldn't work. 
  55. To access a BEN function, you must enter the command "BEN" followed by the name of the function. Some functions doesn't require any parameter. An example of this is the BEEP function. You can use it by entering this command into your batch file: 
  56. BEN BEEP 
  57. Other functions of BEN require one or more parameters. For example, you can clear the screen with the color blue by entering this command into your batch file: 
  58. BEN CLS BLUE 
  59. BEN functions can be "stacked" one after another in a command line. For example, you can group the BEEP function and the CLS function together, one after another. In this case, BEN will first create a beep, then it will clear the screen with the color blue: 
  60. BEN BEEP CLS BLUE 
  61. When you stack functions together, you may use the "/" separators if you want. This is not mandatory, but it helps to increase the readability of your batch file. For example: 
  62. BEN BEEP / CLS BLUE 
  63.  Cursor Movement Commands
  64.   Character left  
  65.  Ctrl-S or Left arrow
  66.   Character right 
  67.  Ctrl-D or Right arrow
  68.   Word left       
  69.  Ctrl-A or Ctrl-Left arrow
  70.   Word right      
  71.  Ctrl-F or Ctrl-Right arrow
  72.   Line up         
  73.  Ctrl-E or Up arrow
  74.   Line down       
  75.  Ctrl-X or Down arrow
  76.   Scroll up       
  77.  Ctrl-W
  78.   Scroll down     
  79.  Ctrl-Z
  80.   Page up         
  81.  Ctrl-R or PgUp
  82.   Page down       
  83.  Ctrl-C or PgDn
  84.  Insert & Delete Commands
  85.   Insert mode on/off   
  86.  Ctrl-V or Ins
  87.   Insert line          
  88.  Ctrl-N
  89.   Delete line          
  90.  Ctrl-Y
  91.   Delete to end of line
  92.  Ctrl-Q Y
  93.   Delete character left
  94.  Ctrl-H or Backspace
  95.   Delete character     
  96.  Ctrl-G or Del
  97.   Delete word right    
  98.  Ctrl-T
  99.  Block Commands
  100.   Mark block begin     
  101.  Ctrl-K B
  102.   Mark block end       
  103.  Ctrl-K K
  104.   Copy block           
  105.  Ctrl-K C
  106.   Move block           
  107.  Ctrl-K V
  108.   Delete block         
  109.  Ctrl-K Y
  110.   Hide/display block   
  111.  Ctrl-K H
  112.  Alphabetical listing to all BEN functions 
  113.  BEEP
  114.  CLEANUP
  115.  COLOR
  116.  CURSOR
  117.  DELAY
  118.  DIRDISP
  119.  DIRDISPA
  120.  ECHO
  121.  EGAVGA
  122.  EXTRACT
  123.  FLUSH
  124.  GETCD
  125.  GETKEY
  126.  GETKEYL
  127.  GETKEYU
  128.  GETLINE
  129.  GETLINEL
  130.  GETLINEU
  131.  GETVIDEO
  132.  GROWFILLEDBOX
  133.  LIST
  134.  LOCATE
  135.  MENU
  136.  MENULCD
  137.  MESSAGE
  138.  PAUSE
  139.  PLAY
  140.  SAVEPATH
  141.  SCROLL
  142.  SHADFILLEDBOX
  143.  SHELL
  144.  SOUND
  145.  TITLEDBOX
  146.  TRANSPARENTBOX
  147.  WRITE
  148.  WRITEC
  149.  WRITEV
  150.  (System) menu 
  151.     (Alt-Spacebar)
  152. The System menu appears on the far left of the menu bar and is represented by the 
  153.  symbol. (
  154. When you pull down the 
  155.  menu, you see /
  156.   About
  157.   Ascii
  158. Table
  159.   Calculator
  160.   Register
  161. About 
  162. When you choose the About command from the 
  163.  (System) menu, a dialog box appears, showing copyright and version information. G
  164. To close the box, press Esc, Space, or Enter, or click the OK button. 
  165. ASCII table 
  166. The ASCII menu items opens an ASCII
  167. Table that displays the IBM PC character set. 
  168. Calculator 
  169. When you choose Calculator, a four-function calculator is opened on the desktop. 
  170. Register (F4) 
  171. When you select the Register option under the menu bar or press F4 at anytime, you will enter the registration dialog box. To register, answer a few questions, and BENEdit will print a registration form for you automatically. All you need to do is to mail this form with the necessary payment. Quick and easy! 
  172. Why do you want to register? 
  173. You want to register because BEN and BENEdit are NOT free software. BEN and BENEdit are NOT public domain software. BEN and BENEdit are sharewares. You are expected to pay a registration fee to the author of this program if you find it useful. You are allowed to use BEN and BENEdit for free within a trial period of 60 days. After 60 days, if you continue to use BEN, you must register, or you will be violating the law. 
  174. When you register, you will get BENMOUSE for free. BENMOUSE is a a bonus version of BEN that has the ability to make use of mouses. BENMOUSE is unavailable anywhere except through registration. 9
  175. When you register, you will get free technical support. 3
  176. When you register, you will get a printed manual. J
  177. When you register, you will boost the economy of the shareware industry. '
  178. Register promptly! Be an honest user! =
  179. There are three editions of BEN available for registration: 
  180. A>   Personal Edition - $39 Z
  181.      With registration, you get the following:
  182.      -    Complete BEN package on a disk:
  183.           -    BEN.EXE with your specified registration name
  184.                encoded into the code.
  185.           -    BENMOUSE.EXE (a bonus version of BEN that has the
  186.                ability to make use of mouses) with your specified
  187.                registration name encoded into the code.
  188.           -    BENEDIT.EXE with your specified registration name
  189.                encoded into the code.
  190.           -    All other BEN-related files.
  191.      -    Next version of the complete BEN package on a disk free
  192.           of charge.
  193.      -    One printed manual that covers all aspects of BEN.
  194.      -    Free technical support.
  195. B>   Programmer's Edition - $99 Z
  196.      With registration, you get the following:
  197.      -    Complete BEN package on a disk:
  198.           -    BEN.EXE with your specified registration name
  199.                encoded into the code.
  200.           -    BENMOUSE.EXE (a bonus version of BEN that has the
  201.                ability to make use of mouses) with your specified
  202.                registration name encoded into the code.
  203.           -    BENEDIT.EXE with your specified registration name
  204.                encoded into the code.
  205.           -    All other BEN-related files.
  206.      -    Next version of the complete BEN package on a disk free
  207.           of charge.
  208.      -    One printed manual that covers all aspects of BEN.
  209.      -    A distribution license. With this license, you are
  210.           permitted to use BEN to create batch utilities that you
  211.           can distribute, royalty-free.
  212.      -    Free technical support.
  213. C>   Business Edition - $199 Z
  214.      With registration, you get the following:
  215.      -    Complete BEN package on a disk:
  216.           -    BEN.EXE with your specified registration name
  217.                encoded into the code.
  218.           -    BENMOUSE.EXE (a bonus version of BEN that has the
  219.                ability to make use of mouses) with your specified
  220.                registration name encoded into the code.
  221.           -    BENEDIT.EXE with your specified registration name
  222.                encoded into the code.
  223.           -    All other BEN-related files.
  224.      -    All future versions of the complete BEN package on a
  225.           disk free of charge.
  226.      -    Five sets of printed manuals that covers all aspects of
  227.           BEN.
  228.      -    A site license for unlimited number of users on a LAN.
  229.      -    A distribution license. With this license, you are
  230.           permitted to use BEN to create batch utilities that you
  231.           can distribute, royalty-free.
  232.      -    Free technical support.
  233.  File  (Alt-F) 
  234. The File menu offers choices for opening files, changing directories, and exiting the program. ?
  235.  Open
  236.  Save
  237.  Save
  238.  Change
  239.  Print
  240. Shell
  241.  Exit
  242.  File
  243. Open  (F3) 
  244. The Open command displays the Open a File dialog box. In this dialog box you select the text file you want to edit. &
  245. The Open
  246. File dialog box contains: 
  247.  an input
  248. box with a history list
  249.  a list
  250. box to browse the directory
  251.  the standard Cancel button
  252.  Open action button
  253.  an information panel that describes the
  254.    selected file
  255.  File
  256. New opens a new Edit window and automatically makes it active. 
  257.  File
  258. Save (F2) 
  259. Save saves the file that's in the active Edit window to disk. If the file is untitled, then a Save
  260. As dialog box opens so that you can name the file. 
  261.  File
  262. Save As... 
  263. Save As opens a dialog box where you can save the file in the active Edit window under a different name, in a different directory or on a different drive. 
  264.  File
  265. Change Dir...
  266. Change Dir brings up the Change
  267. Directory dialog box, in which you can change the current directory. 
  268.  File
  269. Print...
  270. Print command prints the contents of the active Edit Window. 
  271.  File
  272. DOS Shell 
  273. With the DOS Shell command, you can leave the program temporarily to perform a DOS command or run another program. 9
  274. To return to this program, type EXIT at the DOS prompt. 
  275.  File
  276. Exit 
  277.      (Alt-X)
  278. The Exit command terminates this program. 
  279.  Edit 
  280.     (Alt-E)
  281. The Edit menu provides commands to cut, copy and paste text in Edit Windows. You can also open a Clipboard Window to view or edit its contents. /
  282. You can choose from these Edit menu commands: 0
  283.  Undo
  284.  Copy
  285.  Paste
  286.  Show
  287. Clipboard
  288.  Clear
  289.  Edit
  290. Undo 
  291. This command takes back the last editing command you performed on a line. @
  292. It can also take back a CTRL-Y, or text typed on a blank line. 
  293.  Edit
  294. Cut (Shift-Del) 
  295. The Cut command removes the selected text from your document and places the text in the Clipboard. x
  296. You can then choose Edit
  297. Paste to paste the cut text into any other document (or somewhere else in the same document). [
  298. The text remains selected in the Clipboard so you can paste it as many times as you want. 
  299.  Edit
  300. Copy (Ctrl-Ins) 
  301. The Copy command leaves the selected text intact but places an exact copy of it in the Clipboard. x
  302. You can then choose Edit
  303. Paste to paste the cut text into any other document (or somewhere else in the same document). [
  304. The text remains selected in the Clipboard so you can paste it as many times as you want. 
  305.  Edit
  306. Paste (Shift-Ins) 
  307. The Paste command inserts the selected text from the Clipboard into the current window at the cursor position. 
  308.  Edit
  309. Show Clipboard 
  310. The Show Clipboard command opens the Clipboard window, which stores the text you cut and copy from other windows. Any text you cut or copy is appended to the end of the Clipboard. e
  311. The currently selected (highlighted) Clipboard text is the text BENEdit uses when you choose Paste. 
  312.  Edit
  313. Clear (Ctrl-Del) 
  314. The Clear command removes the selected text but does not put it into the Clipboard. Q
  315. This means you can't paste the text as you could if you had chosen Cut or Copy. &
  316. The cleared text is not retrievable. 
  317.  Search 
  318.     (Alt-S)
  319. The Search menu provides commands to search for text in your files. $
  320.   These are the available options:
  321.  Find
  322.  Replace
  323.  Search
  324. Again
  325.  Search
  326. Find... 
  327. The Find command displays the Find
  328. dialog
  329. box, where you type in the text you want to search for. t
  330. You can set several options in this dialog box that affect the search. (Ctrl-Q F is a shortcut to the dialog box.) 
  331.  Search
  332. Replace... 
  333. The Replace command displays the Replace
  334. dialog
  335. box, where you type in the text you want to search for and text you want to replace it with. 
  336.  Search
  337. Search Again 
  338. The Search Again command repeats the last Find or Replace command. ]
  339. All settings you made in the Find dialog box remain in effect when you choose Search Again. 
  340.  Window 
  341.     (Alt-W)
  342. The Window menu contains commands to close, move and perform other window-management commands. 
  343. Most of the windows in this program have all the standard window elements, including scroll bars, a close box, and zoom icons. >
  344. For more about windows and their elements, refer to windows. :
  345.  Window-management commands
  346.  Size/Move        Zoom
  347.  Tile             Cascade
  348.  Next             Previous
  349.  Close
  350.  Window
  351. Size/Move 
  352.      (Ctrl-F5)
  353. Choose this command to change the size or position of the active window. 
  354.   Size
  355. If you press Shift while you use the arrow keys, you can change the size of the active window. Once you've adjusted its size or position, press Enter. Q
  356. If a window has a Resize corner, you can drag that corner to resize the window. 
  357.   Move
  358. When you choose Window
  359. Size/Move, the active window moves in response to the arrow keys. Once you've moved the window to where you want it, press Enter. F
  360. You can also move a window by dragging its title bar with the mouse. 
  361.  Window
  362. Zoom 
  363.    (F5)
  364. Choose Zoom to resize the active window to the maximum size. If the window is already zoomed, you can choose this command to restore it to its previous size. {
  365. You can also double-click anywhere on the window's title bar (except where an icon appears) to zoom or unzoom the window. 
  366.  Window
  367. Tile 
  368. Choose Window
  369. Tile to tile all file viewers on the desktop. L
  370.                
  371.                
  372.                
  373.                
  374.                
  375.                
  376.                
  377.                
  378.                
  379.                
  380.                
  381.                
  382.                
  383.                
  384.                
  385.                
  386.              Tiled Windows
  387.  Window
  388. Cascade 
  389. Choose Window
  390. Cascade to stack all file viewers on the desktop. A
  391.                          
  392.                          
  393.                          
  394.                          
  395.                          
  396.         Cascaded Windows
  397.  Window
  398. Next 
  399. Choose Next to cycle forwards through the windows on the desktop. 
  400.  Window
  401. Previous 
  402. Choose Previous to cycle backwards through the windows on the desktop. 
  403.  Window
  404. Close 
  405.     (Alt-F3)
  406. Choose Close to close the active window. O
  407. You can also click the Close box in the upper right corner to close a window. 
  408.  BEN Functions 
  409.     (Alt-B)
  410. The BEN Functions menu consists of six submenus. Each of these submenus contain a different category of BEN functions that you can access. 
  411. When you select a BEN function inside any of these six submenus, you will only need to answer a few questions (or sometimes, no question at all) and BENEdit will automatically insert the correct BEN command line into the current editing window. 
  412. These submenus are: p
  413. Functions
  414.  Input
  415. Functions
  416.  Message
  417. Functions
  418.  Music
  419. Functions
  420.  Screen
  421. Functions
  422.  Miscellaneous
  423. Functions
  424.  Box Functions 
  425. The Box Functions menu is a submenu under the BEN
  426. Functions
  427. menu. All the functions under this menu can draw boxes on the screen: J
  428.  FilledBox
  429.  GrowFilledBox
  430.  ShadFilledBox
  431.  TitledBox
  432.  TransparentBox
  433.   BOX Function 
  434. Syntax: BOX x1 y1 x2 y2 foreground background borderstyle 
  435. This is a box
  436. function that draws an empty box on the screen with an upper-left corner of (x1,y1) and a lower-right corner of (x2,y2). o
  437.  Example
  438.  BEN BOX 1 1 80 25 WHITE BLUE 1
  439.  BEN BOX 10 10 20 20 YELLOW BLACK 3
  440.  BEN BOX 4 4 8 8 9 2 65
  441.   Borderstyle 
  442. Borderstyle can be one of the following: 
  443.      0    -    no border
  444.      1    -    single line box (
  445.      2    -    double line box (
  446.      3    -    double sides, single top and bottom
  447.      4    -    single sides, double top and bottom
  448.      5    -    single left and upper, double lower and right
  449.      6    -    menu box style
  450.      7+   -    the border is drawn using the ASCII character represented by
  451.                the style value.
  452.   Color 
  453. The "colors" available for use are BLACK, BLUE, GREEN, CYAN, RED, MAGENTA, BROWN, LIGHTGRAY, DARKGRAY, LIGHTBLUE, LIGHTGREEN, LIGHTCYAN, LIGHTRED, LIGHT MAGENTA, YELLOW, and WHITE. 
  454. You can also specify the colors with a number if you want. For example, instead of using the word "BLACK", you can use the number 0. Instead of using the word "BLUE", you can use the number 1. And so on. ?
  455. Here is a list of the colors and their corresponding numbers: G
  456.  BLACK:           0
  457.  BLUE:            1
  458.  GREEN:           2
  459.  CYAN:            3
  460.  RED:             4
  461.  MAGENTA:         5
  462.  BROWN:           6
  463.  LIGHTGRAY:       7
  464.  DARKGRAY:        8
  465.  LIGHTBLUE:       9
  466.  LIGHTGREEN:      10
  467.  LIGHTCYAN:       11
  468.  LIGHTRED:        12
  469.  LIGHT MAGENTA:   13
  470.  YELLOW:          14
  471.  WHITE:           15
  472.   FILLEDBOX Function 
  473. Syntax: FILLEDBOX x1 y1 x2 y2 foreground background borderstyle 
  474. This is a box
  475. function that draws a filled box on the screen with an upper-left corner of (x1,y1) and a lower-right corner of (x2,y2). 
  476.  Example
  477.  BEN FILLEDBOX 1 1 80 25 WHITE BLUE 1
  478.  BEN FILLEDBOX 10 10 20 20 YELLOW BLACK 3
  479.  BEN FILLEDBOX 4 4 8 8 9 9 2 65
  480.   GROWFILLEDBOX Function 
  481. Syntax: GROWFILLEDBOX x1 y1 x2 y2 foreground background borderstyle 
  482. This is a box
  483. function that draws a filled box onto the screen with an upper-left corner of (x1,y1) and a lower-right corner of (x2,y2). This filled box grows out onto the screen for a spectacular effect. 
  484.  Example
  485.  BEN GROWFILLEDBOX 1 1 80 25 WHITE BLUE 1
  486.  BEN GROWFILLEDBOX 10 10 20 20 YELLOW BLACK 3
  487.  BEN GROWFILLEDBOX 4 4 8 8 9 2 65
  488.   SHADFILLEDBOX Function 
  489. Syntax: SHADFILLEDBOX x1 y1 x2 y2 foreground background borderstyle 
  490. This is a box
  491. function that draws a filled box onto the screen with an upper-left corner of (x1,y1) and a lower-right corner of (x2,y2). This filled box has a shadow. 
  492.  Example
  493.  BEN SHADFILLEDBOX 1 1 80 25 WHITE BLUE 1
  494.  BEN SHADFILLEDBOX 10 10 20 20 YELLOW BLACK 3
  495.  BEN SHADFILLEDBOX 4 4 8 8 9 2 65
  496.   TITLEDBOX Function 
  497. Syntax: TITLEDBOX x1 y1 x2 y2 foreground background borderstyle title 
  498. This is a box
  499. function that draws a filled box onto the screen with an upper-left corner of (x1,y1) and a lower-right corner of (x2,y2). This filled box has a title. Please note that tildes (~) in the message are interpreted as spaces. 
  500.  Example
  501.  BEN TRANSPARENTBOX 1 1 80 25 WHITE BLUE 1 Good~box!
  502.  BEN TRANSPARENTBOX 10 10 20 20 YELLOW BLACK 3 Great~box!
  503.  BEN TRANSPARENTBOX 4 4 8 8 9 2 65 Best~box!
  504.   TRANSPARENTBOX Function 
  505. Syntax: TRANSPARENTBOX x1 y1 x2 y2 foreground background 
  506. This is a box
  507. function that paints the region specified by (x1,y1) - (x2,y2) with the specified foreground and background colors. Text that are originally on the screen are not erased; they are just painted with a new color. 
  508.  Example
  509.  BEN TRANSPARENTBOX 1 1 80 25 WHITE BLUE
  510.  BEN TRANSPARENTBOX 10 10 20 20 YELLOW BLACK
  511.  BEN TRANSPARENTBOX 4 4 8 8 9 2
  512.  Input Functions 
  513. The Input Functions menu is a submenu under the BEN
  514. Functions
  515. menu. All the functions under this menu can get input from the user: L
  516.  GetKey
  517.  GetKeyL
  518.  GetKeyU
  519.  GetLine
  520.  GetLineL
  521.  GetLineU
  522.  Menu
  523.  MenuLCD
  524.   ASK Function 
  525. Syntax: ASK options 
  526. This is an input
  527. function that waits for the user to press a key that is contained in the 'options' string. The option that the user selects is passed to the batch file as an errorlevel. 
  528. For instance, if the options string is ABCDE and the user presses the letter C on the keyboard, an errorlevel of 3 is returned (C is the third character of the string). 
  529.  Example
  530.  @ECHO OFF
  531.  BEN ECHO A. Format your hard drive.
  532.  BEN ECHO B. Diskcopy a disk.
  533.  BEN ECHO C. Run Windows.
  534.  BEN ECHO D. Run DOSShell.
  535.  BEN ECHO E. Play Sim City.
  536.  BEN ECHO ~
  537.  BEN ECHO Please make your selection.
  538.  BEN ASK ABCDE
  539.  IF ERRORLEVEL 5 IF NOT ERRORLEVEL 6 GOTO SIMCITY
  540.  IF ERRORLEVEL 4 IF NOT ERRORLEVEL 5 DOSSHELL
  541.  IF ERRORLEVEL 3 IF NOT ERRORLEVEL 4 C:\WIN\WIN
  542.  IF ERRORLEVEL 2 IF NOT ERRORLEVEL 3 DISKCOPY A: A:
  543.  IF ERRORLEVEL 1 IF NOT ERRORLEVEL 2 FORMAT C:
  544.  GOTO END
  545.  :SIMCITY
  546.  CD\SIMCITY
  547.  SIMCITY
  548.  :END
  549.   GETKEY Function 
  550. Syntax: GETKEY |
  551. This is an input
  552. function that waits for the user to enter a key. This key is returned via the environment
  553. variable
  554. %BEN%. G
  555.  Example
  556.  BEN GETKEY
  557.  BEN ECHO You've pressed the %BEN% key!
  558.   GETKEYL Function 
  559. Syntax: GETKEYL 
  560. This is an input
  561. function that waits for the user to enter a key. This key is converted into lowercase and returned via the environment
  562. variable
  563. %BEN%. H
  564.  Example
  565.  BEN GETKEYL
  566.  BEN ECHO You've pressed the %BEN% key!
  567.   GETKEYU Function 
  568. Syntax: GETKEYU 
  569. This is an input
  570. function that waits for the user to enter a key. This key is converted into uppercase and returned via the environment
  571. variable
  572. %BEN%. H
  573.  Example
  574.  BEN GETKEYU
  575.  BEN ECHO You've pressed the %BEN% key!
  576.   GETLINE Function 
  577. Syntax: GETLINE 
  578. This is an input
  579. function that waits for the user to enter a string. This string is returned via the environment
  580. variable
  581. %BEN%. ]
  582.  Example
  583.  BEN ECHO What's your name?
  584.  BEN GETLINE
  585.  BEN ECHO So your name is %BEN%!
  586.   GETLINEL Function 
  587. Syntax: GETLINEL 
  588. This is an input
  589. function that waits for the user to enter a string. This string is converted into lowercase and returned via the environment
  590. variable
  591. %BEN%. k
  592.  Example
  593.  BEN ECHO What's your name?
  594.  BEN GETLINEL
  595.  BEN ECHO So your name is %BEN% in lowercase!
  596.   GETLINEU Function 
  597. Syntax: GETLINEU 
  598. This is an input
  599. function that waits for the user to enter a string. This string is converted into uppercase and returned via the environment
  600. variable
  601. %BEN%. k
  602.  Example
  603.  BEN ECHO What's your name?
  604.  BEN GETLINEU
  605.  BEN ECHO So your name is %BEN% in uppercase!
  606.   MENU Function 
  607. Syntax: MENU title choice1 [choice2 choice3...] C
  608. This is an input
  609. function that displays a menu on the screen. The choice that is selected by the user is passed back to the batch file as an errorlevel. For instance, if the user chooses choice #3, an errorlevel of 3 is returned. On the other hand, if the user opts to choose nothing, then an errorlevel of 0 is returned. 
  610. Please note that tildes (~) are interpreted as spaces, and no other function can be stacked after the MENU function is used. Also, use a minus sign (-) to tell BEN to display a blank line. 
  611.  Example
  612.  @ECHO OFF
  613.  BEN MENU Please~make~a~selection: Format~your~hard~drive Diskcopy~a~disk Run~Windows Run~DOSShell Play~Simcity
  614.  IF ERRORLEVEL 5 GOTO SIMCITY
  615.  IF ERRORLEVEL 4 GOTO DOSSHELL
  616.  IF ERRORLEVEL 3 GOTO WINDOWS
  617.  IF ERRORLEVEL 2 GOTO DISKCOPY
  618.  IF ERRORLEVEL 1 GOTO FORMAT
  619.  BEN ECHO You didn't make a selection!
  620.  GOTO END
  621.  :FORMAT
  622.  FORMAT C:
  623.  GOTO END
  624.  :DISKCOPY
  625.  DISKCOPY A: A:
  626.  GOTO END
  627.  :WINDOWS
  628.  C:\WIN\WIN
  629.  GOTO END
  630.  :DOSSHELL
  631.  DOSSHELL
  632.  GOTO END
  633.  :SIMCITY
  634.  CD\SIMCITY
  635.  SIMCITY
  636.  :END
  637. Syntax: MENULCD title choice1 [choice2 choice3...] 
  638. This is an input
  639. function that works exactly like the menu
  640. function, except that it displays the menu in black and white for increased legibility on LCD screens. 
  641.  Message Functions 
  642. The Message Functions menu is a submenu under the BEN
  643. Functions
  644. menu. All the functions under this menu can display messages on the screen: -
  645.  Echo
  646.  List
  647.  Message
  648.  Write
  649.  WriteC
  650.  WriteV
  651.   ECHO Function 
  652. Syntax: ECHO message [message...] 
  653. This is a message
  654. function that works like the DOS ECHO function. Everything after the word ECHO is displayed using the current writing color. Thus, no other functions can be stacked after ECHO is used. T
  655. If you wish to display a blank line, use the command "BEN ECHO ~". If you wish to display more than one space between two words, use the tilde (~) as a separator instead. For example, if you want to display the words "Hello   World, this is the computer speaking.", use the command "BEN ECHO Hello~~~World, this is the computer speaking." 
  656.  Example
  657.  BEN ECHO Hello World!
  658.  BEN ECHO This is a test!
  659.  BEN ECHO ~
  660.  BEN ECHO Hello~~~World, this is the computer speaking.
  661.   LIST Function 
  662. Syntax: LIST filename title 
  663. This is a message
  664. function that acts as a file browser for the file specified by "filename". Tildes (~) in the title are interpreted as spaces. o
  665.  Example
  666.  BEN LIST C:\AUTOEXEC.BAT This~is~your~AUTOEXEC!
  667.  BEN LIST BEN.TXT You~are~reading~BEN.TXT!
  668.   MESSAGE Function 
  669. Syntax: MESSAGE line1 [line2 line3...] n
  670. This is a message
  671. function that pops up a message box onto the screen. Tildes (~) are interpreted as spaces. =
  672.  Example
  673.  BEN MESSAGE Hello~World! This~is~a~test!
  674.  This example will pop up this message box:
  675.           
  676.           
  677.                
  678.           
  679. Hello World!   
  680.           
  681. This is a test!
  682.           
  683.                
  684.           
  685.      OK  
  686.      
  687.           
  688.      
  689.           
  690.   WRITE Function 
  691. Syntax: WRITE foreground background message 
  692. This is a message
  693. function that writes a string onto the screen using the specified foreground and background colors. Tildes (~) in the message are interpreted as spaces, and a semi-colon (;) at the end of the message tells BEN not to wrap to the next line. 
  694.  Example
  695.  BEN WRITE LIGHTRED BLUE Hello~World!
  696.  BEN WRITE LIGHTGREEN BLACK This~is~a~test!;
  697.  BEN WRITE 7 1 Another~test!
  698.   WRITEC Function 
  699. Syntax: WRITEC foreground background message 
  700. This is a message
  701. function that is similar in function as WRITE, but the message is centered between the two sides of the monitor. 
  702.  Example
  703.  BEN WRITEC LIGHTRED BLUE Hello~World!
  704.  BEN WRITEC LIGHTGREEN BLACK This~is~a~test!;
  705.  BEN WRITEC 7 1 Another~test!
  706.   WRITEV Function 
  707. Syntax: WRITEV x y foreground background message 
  708. This is a message
  709. function that is similar in function as WRITE, but the message is written as a vertical column that starts from the position (x,y). 
  710.  Example
  711.  BEN WRITEV 1 1 YELLOW BLUE An~important~message
  712.  BEN WRITEV 40 10 LIGHTCYAN BLACK Hello!
  713.  BEN WRITEV 80 1 7 1 Great!!!
  714.  Music Functions 
  715. The Music Functions menu is a submenu under the BEN
  716. Functions
  717. menu. All the functions under this menu can create sound from the PC speaker: 
  718.  Beep
  719.  Play
  720.  Sound
  721.   BEEP Function 
  722. Syntax: BEEP <
  723. This is a music
  724. function that simply creates a beep sound. 
  725.  Example
  726.  BEN BEEP
  727.   PLAY Function 
  728. Syntax: PLAY playstring 
  729. This is a music
  730. function that plays music using the computer's speaker. The playstring is exactly the same in format as the BASIC PLAY statement. Here is a list of the music commands supported: 
  731.  ML:  legato (8/8 note length)
  732.  MN:  normal music (7/8 note length)
  733.  Ln:  length of notes (n=1-64; note length=1/n, eg. n=2 for
  734.       1/2 note)
  735.  Nn:  Note number (n=0-84; 0 is a rest)
  736.  On:  Octave (n=0-6, default 4)
  737.  Pn:  Pause (n=1-64; pause length=1/n, eg. n=4 for 1/4 note)
  738.  Tn:  Tempo (n=32-255, default 120; quarter notes per minute)
  739.   [:   Move down an octave (min 0)
  740.   ]:   Move up an octave (max 6)
  741. You can also use the actual letters of the notes (C, D, E, F, G, A, and B). These correspond to "do, re, mi, fa, so, la, ti". To play a scale, you should use "CDEFGAB]C". 
  742. The notes may be followed by dots, by note lengths, and by sharp or flat symbols (a '+' or '#' for a sharp, a '-' for a flat). For example, 'D-.' is a dotted D flat. The dot means that the note will play for half again its usual length. Dots can be repeated. 
  743. You can also use "<" for "[" and ">" for "]" in BEN data files that are read by BEN's T function. Don't use these in the command line however, because DOS will interpret them as redirection signs. If you use them, strange errors may occur. =
  744.  Example
  745.  BEN PLAY O5CDEFGFEDCP1CC
  746.  BEN PLAY ]EEEC
  747.   SOUND Function 
  748. Syntax: SOUND frequency duration 
  749. This is a music
  750. function that uses the computer's speaker and produces a tone with the specified frequency for the specified duration. Frequency is measured in hertz and duration is measured in milliseconds. <
  751.  Example
  752.  BEN SOUND 1000 1000
  753.  BEN SOUND 2000 100
  754.  Screen Functions 
  755. The Screen Functions menu is a submenu under the BEN
  756. Functions
  757. menu. All the functions under this menu can control the properties of the screen: 7
  758.  Color
  759.  Cursor
  760.  EGAVGA
  761.  GetVideo
  762.  Locate
  763.  Scroll
  764.   CLS Function 
  765. Syntax: CLS background W
  766. This is a screen
  767. function that clears the screen with the specified background color. N
  768.  Example
  769.  BEN COLOR YELLOW BLUE
  770.  BEN COLOR WHITE RED
  771.  BEN COLOR 7 1
  772.   COLOR Function 
  773. Syntax: COLOR foreground background y
  774. This is a screen
  775. function that changes the current writing color. ANSI.SYS must be loaded for this function to operate. N
  776.  Example
  777.  BEN COLOR YELLOW BLUE
  778.  BEN COLOR WHITE RED
  779.  BEN COLOR 7 1
  780.   CURSOR Function 
  781. Syntax: CURSOR ON/OFF/FULL/HALF 
  782. This is a screen
  783. function that changes the cursor shape. Use ON for a normal cursor (_), OFF for no cursor ( ), FULL for a block cursor (
  784. ) and HALF for a half-block cursor (
  785.  Example
  786.  BEN CURSOR OFF
  787.  BEN CURSOR FULL
  788.   EGAVGA Function 
  789. Syntax: EGAVGA ON/OFF 
  790. This is a screen
  791. function that switches the EGA 43 / VGA 50 line mode on or off. If the EGA 43 / VGA 50 line mode is switched on successfully, an errorlevel of 2 is passed back to the batch file. Otherwise, an errorlevel of 1 is returned. 
  792.  Example
  793.  @ECHO OFF
  794.  BEN EGAVGA ON
  795.  IF ERRORLEVEL 2 GOTO SUCCESS
  796.  BEN ECHO Sorry. Your computer cannot display in
  797.  BEN ECHO the EGA 43 or the VGA 50 line mode.
  798.  GOTO END
  799.  :SUCCESS
  800.  BEN CLS BLUE COLOR WHITE BLUE LOCATE 30 30
  801.  BEN ECHO See how big your screen is!
  802.  BEN LOCATE 30 33
  803.  PAUSE
  804.  BEN EGAVGA OFF
  805.  :END
  806.  BEN CLEANUP
  807.   GETVIDEO Function 
  808. Syntax: GETVIDEO 
  809. This is a screen
  810. function that finds out what kind of video system is installed. It returns the result in the environment
  811. variable
  812. %BEN%. :
  813. The possible values that can be returned are as follows: 
  814.  MONO:     The computer has a monochrome system.
  815.  CGA:      The computer has a CGA system.
  816.  EGA:      The computer has an EGA system.
  817.  MCGA:     The computer has a MCGA system.
  818.  VGA:      The computer has a VGA system.
  819.  Example
  820.  @ECHO OFF
  821.  BEN GETVIDEO
  822.  IF "%BEN%"=="MONO" GOLF /MONO
  823.  IF "%BEN%"=="CGA" GOLF /CGA
  824.  IF "%BEN%"=="EGA" GOLF /EGA
  825.  IF "%BEN%"=="MCGA" GOLF /MCGA
  826.  IF "%BEN%"=="VGA" GOLF /VGA
  827. This example shows a batch file that passes different parameters to the GOLF program (a game?) depending on what video system the computer has. 
  828.   LOCATE Function 
  829. Syntax: LOCATE x y O
  830. This is a screen
  831. function that moves the screen cursor to the position (x,y). 5
  832.  Example
  833.  BEN LOCATE 1 1
  834.  BEN LOCATE 10 15
  835.   SCROLL Function 
  836. Syntax: SCROLL x1 y1 x2 y2 direction 
  837. This is a screen
  838. function that scrolls the text enclosed in the (x1,y1)-(x2,y2) box. 'Direction' can be one of the following: UP, DOWN, LEFT, RIGHT. I
  839.  Example
  840.  BEN SCROLL 1 1 80 25 UP
  841.  BEN SCROLL 10 10 20 20 LEFT
  842.  Miscellaneous Functions 
  843. The Miscellaneous Functions menu is a submenu under the BEN
  844. Functions
  845. menu. All the functions under this menu are functions that do not belong to the other five menus: V
  846.  Cleanup
  847.  Delay
  848.  DirDisp
  849.  DirDispA
  850.  Extract
  851.  Flush
  852.  GetCD
  853.  Pause
  854.  Savepath
  855.  Shell
  856.   CLEANUP Function 
  857. Syntax: CLEANUP 9
  858. This is a miscellaneous
  859. function that does four things: 
  860.  1.   Changes the writing color to normal DOS color (same as
  861.       calling BEN COLOR
  862. LIGHTGRAY
  863. BLACK).
  864.  2.   Changes the cursor to a normal shape (same as calling
  865.       BEN CURSOR
  866.  3.   Erases all the environment
  867. variables that have been
  868.       created by BEN (IE. %BEN%, %BEN2%, %BEN3%, etc.)
  869.  4.   Restores the PATH if the SAVEPATH function had been
  870.       called previously. (Please refer to the discussion on
  871.       the SAVEPATH function.)
  872. CLEANUP should be called at the end of a batch file.  
  873.  Example
  874.  BEN CLEANUP
  875.   DELAY Function 
  876. Syntax: DELAY milliseconds 
  877. This is a miscellaneous
  878. function that pauses the computer for the specified number of milliseconds. (1000 milliseconds = 1 second) 3
  879.  Example
  880.  BEN DELAY 1000
  881.  BEN DELAY 5000
  882.   DIRDISP Function 
  883. Syntax: DIRDISP directory 
  884. This is a miscellaneous
  885. function that displays a file selection box and allows the user to select a file. The name of the selected file is stored into environment
  886. variable
  887. %BEN%. If the user presses ESC and opts not to choose any file, then %BEN% is set to contain nothing. 2
  888. To have a greater control, use DIRDISPA instead. 
  889.  Example
  890.  BEN DIRDISP C:\
  891.  IF "%BEN%"=="" GOTO CHOSE_NOTHING
  892.  BEN ECHO You've chosen %BEN%!
  893.  GOTO END
  894.  :CHOSE_NOTHING
  895.  BEN ECHO You didn't choose any file!
  896.  :END
  897.   DIRDISPA Function 
  898. Syntax: DIRDISPA directory filemask sortorder 
  899. This is a miscellaneous
  900. function that is an advanced version of DIRDISP. In addition to the starting directory, you can specify the file mask and the sorting order. %
  901. 'Filemask' specifies the types of file you want to display. For example, if you want to display only EXE files, you can use a filemask of "*.EXE". If you want to display both EXE and COM files, you can use a filemask of "*.EXE~*.COM" [different types of files are separated with tildes (~).] k
  902. 'Sortorder' specifies the order which DIRDISPA uses to display the files. It can be one of the following: [
  903.  NAME      -    Files sorted on names in ascending order.
  904.  EXTENSION -    Files sorted on extensions in ascending
  905.                 order.
  906.  TIME      -    Files sorted on time from the earliest to the
  907.                 latest.
  908.  SIZE      -    Files sorted on size from the smallest to the
  909.                 largest.
  910.  X         -    Files are unsorted.
  911. You can also specify only the first letter of the sortorder you want. For example, instead of "BEN DIRDISPA C:\ *.* NAME", you can use "BEN DIRDISPA C:\ *.* N". This is not suggested, however, because it decreases the legibility of your batch file. i
  912.  Example
  913.  BEN DIRDISPA C:\ *.BAT~*.SYS~*.EXE EXTENSION
  914.  BEN ECHO You've picked the file %BEN%!
  915.   EXTRACT Function 
  916. Syntax: EXTRACT source mask 
  917. This is a miscellaneous
  918. function that extracts a certain part of a fully qualified filename (eg. the result from DIRDISP or GETCD) and stores it into %BEN%. 
  919. 'Source' specifies the source string from which you want to extract information. Usually, you should place an environment variable here. 
  920. 'Mask' specifies the part of the selected filename you want BEN to return to you. It can contain one or more letters which define what BEN should put into %BEN%: 
  921.  D    -    Returns only the drive part of the source (eg. C:)
  922.  P    -    Returns only the path part of the source without
  923.            the trailing backslash (eg. \TELECOM)
  924.  \    -    Adds a trailing backslash to the path
  925.  N    -    Returns only the name part of the source
  926.            (eg. AUTOEXEC)
  927.  .    -    Adds a dot to the name
  928.  E    -    Returns only the extension part of the source (eg.
  929.            BAT)
  930.  Example
  931.  BEN DIRDISP C:\TELECOM
  932.  SET SELECT=%BEN%
  933.  BEN EXTRACT %SELECT% D
  934.  BEN ECHO You've selected a file that is located in
  935.      drive %BEN%
  936.  BEN EXTRACT %SELECT% P
  937.  BEN ECHO This file has a path (without trailing
  938.      backslash) of %BEN%
  939.  BEN EXTRACT %SELECT% P\
  940.  BEN ECHO This file has a path (with trailing
  941.      backslash) of %BEN%
  942.  BEN EXTRACT %SELECT% N
  943.  BEN ECHO This file's name is %BEN%
  944.  BEN EXTRACT %SELECT% E
  945.  BEN ECHO And its extension is %BEN%
  946.  BEN EXTRACT %SELECT% N.E
  947.  BEN ECHO Its filename (name+extension) is %BEN%
  948.  BEN EXTRACT %SELECT% P\N.E
  949.  BEN ECHO Its path, name and extension is %BEN%
  950.  BEN EXTRACT %SELECT% DP\N.E
  951.  BEN ECHO This file's full name is %BEN%!
  952.  BEN ECHO ~
  953.  BEN GETCD
  954.  BEN EXTRACT %BEN% DRIVE
  955.  BEN ECHO You're currently in %BEN% drive.
  956.   FLUSH Function 
  957. Syntax: FLUSH C
  958. This is a miscellaneous
  959. function that clears the keyboard buffer. 
  960.  Example
  961.  BEN FLUSH
  962.   GETCD Function 
  963. Syntax: GETCD 
  964. This is a miscellaneous
  965. function that finds out what the current directory is and stores it into the environment
  966. variable
  967. %BEN%. P
  968.  Example
  969.  BEN GETCD
  970.  BEN ECHO Hey man, you're in the %BEN% directory!
  971.   PAUSE Function 
  972. Syntax: PAUSE Y
  973. This is a miscellaneous
  974. function that pauses the computer until the user presses a key. 
  975.  Example
  976.  BEN PAUSE
  977.   SAVEPATH Function 
  978. Syntax: SAVEPATH 
  979. This is a miscellaneous
  980. function that saves the PATH environment variable into a file called SAVEPATH.DAT (this file is stored in the current directory) and erases the PATH environment variable. Using this function can free up environment space so that BEN functions that make use of the environment (eg. GETLINE) can function better. Remember to use the CLEANUP function to restore the PATH upon the completion of the batch file. 
  981.  Caution:  Make sure that you don't change directory after
  982.            using SAVEPATH. If you do, you must change back to
  983.            the directory where SAVEPATH stores SAVEPATH.DAT
  984.            before you run CLEANUP.
  985.  Example
  986.  @ECHO OFF
  987.  BEN SAVEPATH
  988.  BEN ECHO Your PATH has been saved!
  989.  BEN CLEANUP
  990.  BEN ECHO Your PATH is restored!
  991.   SHELL Function 
  992. Syntax: SHELL 
  993. This is a miscellaneous
  994. function that "jumps to DOS". After this function is used, the user can work in DOS as long as he/she want. He/she can let the batch file regain control by typing EXIT. 
  995.  Example
  996.  BEN SHELL
  997.   T Function 
  998. Syntax: T filename 
  999. This is a miscellaneous
  1000. function that runs all the instructions in the data file. This lets BEN perform its jobs at a quicker speed. 
  1001. The data file is just a normal text file (ASCII format). It can be created with any text editor, such as BENEDIT or the EDLIN or the EDIT programs included with DOS. The format of the text file is as follows: E
  1002.  FUNCTIONS
  1003.  FUNCTIONS
  1004.  FUNCTIONS
  1005.  FUNCTIONS
  1006.  <End of File>
  1007. The FUNCTIONS are exactly the same functions as those that are ran from the command line. For example: 
  1008.  BEN T DATA.DAT
  1009.  where DATA.DAT contains:
  1010.  BOX 1 1 80 25 YELLOW GREEN 3
  1011.  PAUSE
  1012.  CURSOR OFF
  1013.  CLS BLUE
  1014.  <End of File>
  1015.  is exactly the same as doing this:
  1016.  BEN BOX 1 1 80 25 YELLOW GREEN 3
  1017.  BEN PAUSE
  1018.  BEN CURSOR OFF
  1019.  BEN CLS BLUE
  1020. Usually, you should only use the T function when you have a large quantity of functions that you wish to be processed by BEN. >
  1021.  Example
  1022.  BEN T MYFILE.DAT
  1023.  BEN T C:\BATCH\INSTRUCT
  1024.  Run 
  1025.     (Alt-R)
  1026. When you select Run, BENEdit will save and run the batch file in the current editing window. H
  1027. Note: select this option only when you are working with a batch file.  
  1028.  Help on Open a File Dialog Box 
  1029. The Open a File dialog box contains an input box, a file
  1030. list, a file information panel, the standard button Cancel, one other action button (Open), plus a history list that's attached to the Name
  1031. inputbox. 
  1032.  Name 
  1033.                                  
  1034. The Name input box is where you enter the name of the file to load, or the file-name mask to use as a filter for the Files list box (for example, *.BAT). 
  1035.  Files 
  1036.                                  
  1037.   INSTALL.BAT   
  1038.   C.BAT         
  1039.   QD.BAT        
  1040.   D.BAT         
  1041.   PRO.BAT       
  1042.   E.BAT         
  1043.   DIRR.BAT      
  1044.   F.BAT         
  1045.   G.BAT         
  1046.   ..            
  1047.   W.BAT         
  1048.   \TRASH        
  1049.   A.BAT         
  1050.   \OTHERS       
  1051.   B.BAT         
  1052.                 
  1053. The Files list box lists the names of files in the current directory that match the file-name mask in the Name input box, plus the parent directory and all subdirectories. 
  1054.  C:\BATCH\QD.BAT                          
  1055.  QD.BAT         342  Jul 14,1990  12:00pm 
  1056. The File information panel shows the path name, file name, date, time, and size of the selected file. =
  1057. None of the items on this information panel are selectable. 
  1058.  [ Open ] 
  1059. The Open button opens a new edit window and places the selected file in that window. 
  1060.  [ Cancel ] 
  1061. If you choose Cancel, nothing changes and no action occurs, and the dialog box is put away. M
  1062. (Esc always cancels a dialog box, even if a Cancel button does not appear.) 
  1063.  [ Open ] 
  1064. In the Open a File dialog box, if you choose the Open button BENEdit opens a file and places the selected file in that window. 
  1065.  Help on the Change Directory dialog box 
  1066. The Change Directory dialog box consists of an input box, a list box, the standard OK and Help buttons, and two other buttons (Chdir and Revert). |
  1067.  Directory Name 
  1068.                                      
  1069. The Directory Name input box is where you type in the path of the new directory. 
  1070.  Directory Tree 
  1071.    Drives                            
  1072. C:\                            
  1073.      
  1074. BATCH                        
  1075.        
  1076. TRASH                      
  1077. The Directory Tree list box enables you to navigate directories by using the selecting bar and pressing Enter. 
  1078. If you're using the keyboard, press Enter to make the selected directory be the current directory, then choose OK or press Esc to exit the dialog box. +
  1079.  [Chdir ] 
  1080. The Chdir button changes the current directory once you've selected or typed in a directory name. +
  1081.  [Revert] 
  1082. The Revert button goes back to the previous directory, as long as you haven't yet exited the dialog box. 
  1083.  Help on the Find dialog box
  1084. The Find dialog box contains an input box with a history list, three sets of radio buttons, one group of check boxes, and the standard OK, Cancel, and Help buttons. 
  1085.  Text to Find 
  1086.                        
  1087.   Enter the search string in the Text to Find
  1088.   input box and choose OK to begin the search,
  1089.   or choose Cancel to forget it.
  1090.   Press the Down arrow key if you want to show
  1091.   the history list associated with the input
  1092.   box.
  1093.  [X] Case sensitive     
  1094.  [X] Whole words only   
  1095.  [X] Regular expression 
  1096.   This group of check boxes governs the kind of
  1097.   strings that BENEdit searches for.
  1098.  Direction     
  1099. ) Forward  
  1100.   ( ) Backward 
  1101.   Direction specifies which way you want BENEdit
  1102.   to search, starting from the current cursor
  1103.   position. Forward (from the current position
  1104.   to the end of the file) is the default.
  1105.  Scope                
  1106. ) Global          
  1107.   ( ) Selected text   
  1108.   Scope determines how much of the file BENEdit
  1109.   searches in. Global (entire file) is the default scope.
  1110.  Origin               
  1111. ) From Cursor     
  1112.   ( ) Entire Scope    
  1113.   Origin specifies where the search should
  1114.   start.
  1115. Most components of the Replace dialog box are identical to those in the Find
  1116. dialog
  1117. box, except for the following additions: 
  1118.  New Text 
  1119.                        
  1120.   Enter the replacement string in the New Text
  1121.   input box.
  1122.   You can also use the history list to the right
  1123.   of the box to select a string you've used
  1124.   previously.
  1125.  [X] Case sensitive     
  1126.  [X] Whole words only   
  1127.  [X] Regular expression 
  1128.  [X] Prompt to Replace  
  1129.   This group of check boxes governs the kind of
  1130.   strings that BENEdit searches for, and whether
  1131.   the replacement is automatic.
  1132.  [ Change All ] 
  1133.   Choose Change All if you want BENEdit to replace
  1134.   all occurrences of the search string found, as
  1135.   defined by the Direction, Scope, and Origin options.
  1136.  Calculator 
  1137. The calculator is a simple four-function calculator with add, subtract, multiply, and divide.  To operate the calculator you can either use the keyboard or press the buttons on the calculator with the mouse.  The 'C' key clears the calculator, the '
  1138. ' key will erases the last character typed, and the '
  1139. ' key toggles the value from positive to negative (the keyboard equivalent of '
  1140. ' is '_'). 
  1141.  ASCII Table 
  1142. The ASCII table displays the entire IBM PC character set.  The current character is marked by a blinking block cursor, and the hexadecimal and decimal ASCII values of the character are displayed below the chart. A new character is selected by pressing it on the keyboard, by clicking the mouse on it in the chart, or by moving the cursor using the cursor keys. 
  1143.  BEN and Environment Variables 
  1144. Several of BEN's functions (IE. GETKEY, GETKEYU, GETLINE, GETLINEU, DIRDISP, DIRDISPA, GETCD and GETVIDEO) return their results using environment variables. After you use any one of these functions, you can access the data that BEN returns by calling the variable %BEN%. Just put %BEN% in your batch file where you want the data to appear. For example, if you want to get the user's name and re-display it, you can do the following: e
  1145.  BEN WRITE White Black Please~enter~your~name:~; GETLINE
  1146.  BEN WRITE White Black Your~name~is~%BEN%!
  1147. If you stack several functions that return data via environment variables, the first result would be stored into %BEN%, the second result into %BEN2%, the third into %BEN3%, and so on. For example, if you want to ask the user to enter two favorite colors and re-display them, you can do the following: 
  1148.  BEN WRITE White Black Enter~your~two~favorite~colors:
  1149.  BEN GETLINE GETLINE
  1150.  BEN WRITE White Black So~they~are:~%BEN%~and~%BEN2%!
  1151.  Note:     At the end of your batch file, you should make a call
  1152.            to BEN's CLEANUP function to erase all the variables
  1153.            that BEN have created (IE %BEN%, %BEN2%, %BEN3%, etc.)
  1154.