home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 515.lha / BackTalk_v1.40 / BackTalk.doc < prev    next >
Text File  |  1991-06-08  |  59KB  |  1,434 lines
  1.                                BackTalk 1.40
  2.  
  3.             Copyright 1991 by Steve Ahlstrom and Don Curtis
  4.  
  5.  
  6. Copyright and Distribution Notice:
  7.  
  8. BackTalk is a copyrighted program.  BackTalk is freely distributable
  9. provided the following files (listed below) remain UNCHANGED and AS A WHOLE
  10. in LHARCIVE FORM along with this notice.
  11.  
  12. All rights to the program BackTalk and all files in this archive, except
  13. where specifically noted, remain the property of Steve Ahlstrom and Don
  14. Curtis.
  15.  
  16. BackTalk may not be sold or distributed for any fee.  The exception to this
  17. is that BackTalk may be included on any Amiga User Group Club disks on which
  18. BackTalk is not the only program on the disk and the disk does not sell for
  19. more than $10US. 
  20.  
  21.  
  22. Disclaimer:
  23.  
  24. No warranty is offered and no fitness for any particular purpose is claimed.
  25. Every effort has been made for this software to perform as indicated in
  26. the documentation.  However, nothing is perfect.
  27.  
  28.  
  29. Credits:
  30.  
  31. Thanks to the creators of the XPR library specification. 
  32.  
  33. Thanks to the authors of the various XPR libraries.  Do be aware than that,
  34. depending upon implementation, some of these libraries work better than
  35. others.
  36.  
  37. Thanks to Khalid Aldoseri for this File Requester library, his considerable
  38. help and expertise with suggestions, coding hints, and support all while he
  39. was constantly donning his gas mask and seeking shelter from SCUD attacks.
  40.  
  41. And special thanks to the corp of BackTalk testers who include, but are not
  42. limited to, Khalid Aldoseri, Larry, Phillips, Bob Rakosky, Steve Pietrowicz,
  43. Betty Clay, David Art, Brian Bartlett, Vic Wagner, Michael McCormick, and 
  44. Rick Stevens.
  45.  
  46.  
  47. Files in this LHARCHIVE:
  48.  
  49. BackTalk                  This is the terminal program "BackTalk"
  50. BackTalk.info             Icon for BackTalk
  51. BackTalk.doc              This file
  52.  
  53. *frqlib.lzh               Khalid Aldoseri's File Requester library (ver 2.0).
  54.                           This is the full distribution of the library,
  55.                           auxillary programs, user documentation, and
  56.                           programmer documentation.
  57.  
  58.                           Release 3.0 of Khalid's file requester library
  59.                           is due to be released "any day now" (as of the
  60.                           the date this is written, 24 Feb 1991).  It
  61.                           is fully backward compatible with previous
  62.                           versions and with BackTalk's calls to the
  63.                           library.
  64.                           
  65.  
  66. *xprquickb.library        Jack Rousse's CompuServe QuickB XPR library
  67.                           updated and modified by Don Curtis
  68.  
  69. *xprzmodem.library        Rick Huebner's XPR Zmodem library version 2.1.
  70.                           Previous versions of this library will NOT
  71.                           work with BackTalk and will likely cause
  72.                           a guru.
  73.  
  74. *xprascii.library         an ascii XPR library distributed with the
  75.                           XPR 2.0 specification
  76.  
  77. About_XPR                 A text file describing the various user
  78.                           options for the enclosed XPR libraries
  79.  
  80. *and various example ARexx scripts
  81.  
  82. * These files freely distributable and all rights to them remain with
  83.   their authors.
  84.  
  85. ---------------------------------------------------------------------------
  86.  
  87.                                  BackTalk
  88.  
  89.     A general purpose TTY-type telecommunications program for the Amiga
  90.  
  91. Feature Overview:
  92.  
  93.    - Supports the _complete_ XPR specification.  You may use any file transfer 
  94.      protocol for which there exists an XPR library implementation.  At the 
  95.      time of this writing there exists XPR libraries for CompuServe QuickB, 
  96.      Zmodem, Xmodem, Kermit, and Ascii.
  97.  
  98.    - Fully supports user selected fonts, including proportional fonts.
  99.  
  100.    - ARexx interface - callable internally and externally
  101.      113 ARexx commands and growing
  102.  
  103.    - ARexx scripts callable from FKey macros
  104.  
  105.    - Full featured Review Buffer
  106.  
  107.    - User sizable Review Buffer, from 8k to available ram.
  108.  
  109.    - "Live" Review Buffer.  You may use the review buffer while continuing
  110.      to interact with the communications window.
  111.  
  112.    - Sizable Review Buffer window
  113.  
  114.    - Program will operate in a 1 or a 2 bit plane custom screen or in
  115.      a workbench window.
  116.  
  117.    - If run in a hi-res/interlaced environment, a "split" is provided 
  118.      (half screen)
  119.  
  120.    - Capture Buffer for saving text to a file
  121.  
  122.    - Chat Window for network conferencing.
  123.    
  124.    - Color requester for loading and saving color choices
  125.    
  126.    - Phone Book limited only by available memory
  127.  
  128.    - Phone Book entries carry their own configuration and macro
  129.      files
  130.  
  131.    - Real time clock
  132.  
  133.    - A non-graphic Print Screen function
  134.  
  135.    - Print feature for echoing incoming text to a printer
  136.  
  137.    - Screen text is restored when moving from one display configuration
  138.      to another or in and out of the Chat Window
  139.  
  140. Minimum System Requirement:
  141.  
  142. Amiga 500/1000/2000/3000 with a minimum of 512k and 1 floppy drive
  143. Modem: 300/1200/2400/4800/9600
  144.  
  145. ---------------------------------------------------------------------------
  146.  
  147.                             How to Use BackTalk
  148.  
  149. Before running BackTalk for the first time, decompress frqlib.lzh and place 
  150. kd_freq.library, xprquickb.library, xprzmodem.library and xprascii.library 
  151. files in your LIBS: logical directory.  Library file names are case sensitive, 
  152. please do not change them.  BackTalk will not run without kd_freq.library and
  153. xprquickb.library.
  154.  
  155. BackTalk will open its screen/window in whatever resolution your computer
  156. is in at the time the program is run.  When BackTalk loads, it looks for 3
  157. files, BT.CFG (its configuration file), BT.MACROS (it's macro key file),
  158. and BT.PHONES (its phone book data file).  The S: directory will be
  159. searched for these files.  If they do not exist program defaults will be
  160. used.
  161.  
  162.  
  163. The most coherent method to document BackTalk is to describe the function
  164. of its menus (from left to right) and their menu items.
  165.  
  166. Menu: BackTalk
  167.    MenuItem: About
  168.       Hot Key: Right-Amiga-A
  169.  
  170.       This brings up a "credits" requester containing copyright, support,
  171.       and distribution information.  This requester also contains 
  172.       information on the current available chip ram, current available
  173.       fast ram, and current buffer size.
  174.  
  175.    MenuItem: Hangup
  176.       Hot Key: Right-Amiga-H
  177.  
  178.       This will cause your modem to hang up the phone.  This is done by
  179.       dropping DTR.  If your modem is setup to ignore DTR or you are using
  180.       a 3 wire serial cable between your computer and your modem, this
  181.       command has detects that dropping DTR had no effect and will then
  182.       send the standard Hayes compatible "+++ATH" string to your modem.
  183.  
  184.    MenuItem: Quit
  185.       Hot Key: Right-Amiga-Q
  186.  
  187.       This will terminate the program.  There are no "Are you sure?"
  188.       requesters.  Make sure you really want to exit the program before
  189.       using this menu item.
  190.  
  191. Menu: Phone
  192.    MenuItem: Dial...
  193.    Hot Key: Right-Amiga-P
  194.  
  195.       This brings up the Phone Directory.
  196.  
  197.       The Phone Directory displays 10 entries.  If there are more than 10
  198.       entries, you may scroll through them using the UP and DOWN arrow keys.
  199.       
  200.       You may select the entry to dial by using the mouse and clicking upon 
  201.       the entry or by typing the number to the left of the entry from the 
  202.       keyboard.  This will place the entry into the string gadgets below.  
  203.       You may dial the entry by clicking on the gadget labeled "Dial" or by 
  204.       typing "D" from the keyboard.  The phone number will be sent to the
  205.       modem with a terminating carriage return.  
  206.  
  207.       If for any reason you do not want the carriage return sent, in the
  208.       phone number portion of that entry, place an asterisk (*) as the last
  209.       character in the phone number (see "Adding Phone Book Entries" and
  210.       "Editing Phone Book Entries" below).  When "Dial" is clicked upon or
  211.       the letter "D" is typed, the phone number will be sent to the modem
  212.       without a terminating carriage return.
  213.  
  214.       Adding Phone Book Entries:
  215.       To add a phone book entry, click on the "Add" gadget with the mouse.
  216.       This will activate the "System" string gadget.  Type in the name and
  217.       then type return.  
  218.  
  219.       The "Phone" string gadget will now be activated.  Enter the phone 
  220.       number to be dialed and type a  return.  
  221.  
  222.       The "Comment" string gadget will be activated.  Enter a comment if you
  223.       wish, and type return.  
  224.  
  225.       The "Configuration" gadget will be activated.  In this string gadget
  226.       enter the name of the configuration file you wish to have activated
  227.       for this Phone Book entry.  If you do not remember the name of the 
  228.       configuration file, click on the small gadget immediately to the
  229.       right of the "Configuration" string gadget.  This will bring up a file
  230.       requester defaulted to S:#?.CFG.  
  231.  
  232.       The "Macros" gadget will be activated.  In this string gadget enter the
  233.       name of the macro file you wish to have activated for this Phone Book
  234.       entry.  If you do not remember the name of the macro file, click on
  235.       the small gadget immediately to the left of the "Macros" string gadget.
  236.       This will bring up a file requester defaulted to S:#?.MACROS.
  237.  
  238.       The "Modem Prefix" string gadget will be activated.  The "Modem Prefix"
  239.       string gadget serves two purposes.  The information entered here will
  240.       be prepended to the phone number when it is sent to the modem.  This is
  241.       also a "terminator" field for the Phone Book entry.  If you do not type 
  242.       a return in this gadget the Phone Book entry will not be added.  
  243.       By default, an "ATDT" is placed in the "Modem Prefix" string gadget.
  244.       If this is acceptable, just type a carriage return, if not, enter your 
  245.       dialing prefix and type a carriage return.
  246.  
  247.       You may also enter the new phone entry by clicking again on the 
  248.       ADD gadget.  If the "System" string requester contains text, the 
  249.       entry will be added.  Should you change your mind about adding a 
  250.       Phone Book entry, click on the DELETE gadget and all information 
  251.       currently in the string gadgets will be thrown away.
  252.  
  253.       Editing Phone Book Entries:
  254.       To edit an existing Phone Book entry, select the entry to be edited by
  255.       clicking upon the entry or by typing the number of the entry.  The
  256.       entry will be placed into the string gadgets below.  Click the mouse
  257.       on the string gadget you wish to change and make your changes.  When
  258.       you type a carriage return in the "Modem Prefix" string gadget, the
  259.       changes will be accepted.
  260.  
  261.       Deleting Phone Book Entries:
  262.       To delete an existing Phone Book entry, select the entry to be deleted
  263.       by clicking upon the entry of by typing the number of the entry.  The
  264.       entry will be placed into the string gadgets below.  Click the mouse 
  265.       on the "Delete" gadget.  The entry will be removed from the list.
  266.  
  267.       The Phone Book entries are "hot keyable" from within the requester by
  268.       using the number keys 1-1(0).  The Dial and Exit gadgets are also hot
  269.       keyable using the D and E keys, respectively.  
  270.  
  271.       If there have been any changes to the Phone Book those changes will be
  272.       written to the file BT.PHONES when you exit the Phone Book (by using
  273.       the Dial or Exit gadgets).
  274.  
  275.    MenuItem: Redial
  276.    Hot Key: Right-Amiga-$
  277.  
  278.       This will cause the last dialed Phone Book entry to be dialed again.
  279.       This will not cause the associated configuration or macros file
  280.       to be read.
  281.  
  282. Menu: Serial
  283.    MenuItem: Serial Definitions...
  284.    Hot Key: Right-Amiga-*
  285.  
  286.        This brings up the Serial Definitions requester.  Most of the items
  287.        within this requester are self explanatory.
  288.  
  289.       If you are using a modem or a serial card that requires the use of a
  290.       serial device driver other than the CBM supplied "serial.device" make
  291.       sure that device driver is located in your DEVS: directory.  Enter
  292.       the name of the device driver (the name is case sensitive) into the
  293.       "Device Name" string gadget.  If a unit number other than 0 is 
  294.       required, enter the unit number into the "Unit #" string gadget (check 
  295.       the documentation for your non-CBM supplied device driver for this 
  296.       information.
  297.    
  298.       NOTE 1:  There appears to be a problem with CBM's serial.device that
  299.                is distributed with the A2232 card.  The symptom is that when
  300.                a unit number other than 0 is being used, attempting to close
  301.                and reopen the port while online will cause BackTalk to hang.
  302.  
  303.       NOTE 2: BackTalk opens the serial port in SHARED mode, thus, one of
  304.               the first things it does it check to see if the serial port is 
  305.               already in use (on-line).  BackTalk does this by checking the
  306.               state of the Carrier Detect line.  Thus, IF you have your modem
  307.               configured to have the Carrier Detect line held ON all the time
  308.               (this is the default configuration for many modems!), BackTalk 
  309.               will take the current serial parameters and use them, you will 
  310.               NOT be able to change them.
  311.  
  312.               If you're not really on-line, but have the Carrier Detect line
  313.               set HIGH all the time, the serial port will open with the values
  314.               you've saved using the Amiga's Serial Preferences (saved by 
  315.               running the PREFERENCES program).  If you must keep your modem 
  316.               configured with the Carrier Detect line HIGH all the time, use
  317.               PREFERENCES to set your serial parameters.
  318.  
  319.               The best solution is, of course, to have the modem configured so
  320.               the Carrier Detect line shows the true state of connection.  On
  321.               a Hayes Compatible modem, this is done via the AT&C1 command 
  322.               followed by the AT&W command to save that setting.
  323.  
  324.  
  325.  
  326.       To exit the Serial Definitions requester, click on the Cancel or Use
  327.       gadgets, or type the letter C or U.  If you have made changes and 
  328.       selected "Use", those changes will go into effect immediately.  By 
  329.       selecting "Cancel" all changes will be negated and your serial 
  330.       definitions will remain as they were before you entered the Serial 
  331.       Definitions requester.
  332.  
  333.    MenuItem: Send Break
  334.    Hot Key: Right-Amiga-~ (tilde)
  335.  
  336.       This sends a break signal.
  337.  
  338. Menu: Files
  339.    MenuItem: Protocols...
  340.    Hot Key:  NONE
  341.  
  342.       BackTalk utilizes the XPR protocol specification.  This menu item will
  343.       bring up a file requester from which you may load the xpr library you
  344.       would like to use.  By default, the file requester will display files
  345.       in LIBS: that begin with XPR#?.
  346.  
  347.    MenuItem: Download
  348.    Hot Key: Right-Amiga-D
  349.  
  350.       When selected you will be presented with a file requester for you to
  351.       indicate the path and file name of where the download will be written.
  352.       Some transfer protocols are "autostart" meaning that when you tell
  353.       the system you are calling that you want to download a file the file
  354.       transfer starts automatically.  You will be prompted for the location
  355.       of where the file will be written.  
  356.  
  357.       An example of an autostart protocol is CompuServe QuickB protocol.
  358.       You would simply type "DOW filename", Compuserve will respond with
  359.       "Filename for your computer".  You would respond with the 
  360.       path/filename of the file you are downloading.  The transfer will 
  361.       start automatically at that point.
  362.  
  363.    MenuItem: Upload
  364.    Hot Key: Right-Amiga-U
  365.  
  366.       Same as DOWNLOAD only in the reverse direction.
  367.  
  368.    MenuItem: Capture On
  369.    Hot Key: Right-Amiga-O
  370.  
  371.       A file requester will be presented with the default path and filename
  372.       taken from the path and filename you indicated in the Global Options
  373.       requester (more on the Global Options requester later).  If this is
  374.       acceptable, hit return and the capture file will be opened.  If it is
  375.       not acceptable, enter the desired path and filename.
  376.       
  377.       Should you open a capture file, and that file already exists, the
  378.       new information will be appended to the existing file rather than
  379.       overwriting the existing file.
  380.  
  381.    MenuItem: Capture Off
  382.    Hot Key: Right-Amiga-C
  383.    
  384.       This turns off the capture buffer and closes the capture file.
  385.  
  386.    MenuItem: Change Current Directory
  387.    Hot Key: None
  388.  
  389.       This brings up a string requester into which you enter the 
  390.       directory path you'd like to be the new current directory.
  391.       
  392.    MenuItem: Selected Protocol Options
  393.    Hot Key: None
  394.  
  395.       All of the XPR libraries have options that the user may select
  396.       on a "run time" basis.  Using this item you will be presented
  397.       with a requester with various options that the currently 
  398.       selected protocol offers.
  399.  
  400.       ALSO SEE:  The SETXPR ARexx command and the text file About_XPR.
  401.    
  402. Menu: Review
  403.    MenuItem: Show Review
  404.    Hot Key: Right-Amiga-R
  405.  
  406.       This opens the Review Buffer.  The Review Buffer is a circular buffer,
  407.       user sizable.  You may move around in the Review Buffer by using the
  408.       up arrow and down arrow keys to scroll a line at a time.  Shifted up 
  409.       or   down arrows will scroll a page at a time.  ALT up and down arrow 
  410.       will move you to top or bottom of file, respectively.  Clicking the 
  411.       mouse   upper half of the display will scroll the display up one page.
  412.       Clicking the mouse in the lower half of the display will scroll the
  413.       display down one page.
  414.  
  415.       The Review Buffer has a menu attached that allows you to print the
  416.       current screen or print the entire review buffer.  
  417.  
  418.       A menu called "Size" is available.  The menu item below will either
  419.       be "FULL" or "HALF".  Select this item if you want to change the
  420.       size of the Review Buffer's window.  This will cause the Review
  421.       Buffer's window to be the full size of the communications window or
  422.       half the size of the communications window.  You may also size the
  423.       Review Buffer's window by using the sizing gadget in the lower
  424.       right corner.
  425.  
  426.       NOTE:  When you use the "Save Configuration" menu item located 
  427.              in the Configuration menu, the current setting of the
  428.              Size variable will be saved in the configuration file.
  429.  
  430.       You may exit the Review Buffer via the menu.  Other methods to exit 
  431.       the Review Buffer is to type Right-Amiga-Q, type ESC, or type HELP.
  432.       If you are running in a workbench window, there will also be a
  433.       Close Box in the upper left corner.
  434.  
  435.       NOTE:  The Review Buffer is "live", meaning that you may scroll around
  436.              in the buffer while text continues to come into the serial
  437.              port.  When the Review Buffer's window is opened, only that
  438.              text which is currently in the review buffer will be displayed.
  439.              Text which subsequently is received will continue to be added
  440.              to the Review Buffer but will not be displayable until you 
  441.              close and reopen the Review Buffer window.
  442.  
  443.    MenuItem: Save Review
  444.    Hot Key: NONE
  445.  
  446.       This brings up a file requester with the path "RAM:ReviewBuff" as
  447.       the default.  If this is acceptable hit return or click on the
  448.       SAVE button.  If it is not acceptable, enter the desired path and
  449.       file.
  450.  
  451.  
  452.    MenuItem: Size Review Buffer
  453.    Hot Key: NONE
  454.  
  455.      Enter the size you want the Review Buffer to be _in bytes_.  The
  456.      minimum size is 8k, the maximum is available memory size.  If the
  457.      attempted allocation fails, the program will automatically subtract
  458.      8k the given size and try again, repeating as necessary until the
  459.      the allocation succeeds.  
  460.  
  461.      NOTE:  When changing the size of the Review Buffer, all information
  462.             currently in the Review Buffer will be destroyed.
  463.  
  464.  
  465. Menu: Print
  466.    MenuItem: Print Screen
  467.    Hot Key: Right-Amiga-Z
  468.  
  469.       This will send what is currently displayed on BackTalk's screen to 
  470.       your prt:.
  471.  
  472.    MenuItem: Print Review
  473.    Hot Key: Right-Amiga-!
  474.    
  475.       This will send the contents of the Review Buffer to prt:.
  476.  
  477.    MenuItem: Echo Printer
  478.    Hot Key: Right-Amiga-E
  479.  
  480.       All text that is displayed on BackTalk's screen will be echoed to
  481.       prt:.
  482.  
  483. Menu: Configuration
  484.    MenuItem: Global Options
  485.    Hot Key: NONE
  486.  
  487.       This brings up the Global Options requester.  Here you specify
  488.       the default Upload and Download directories and the default name
  489.       of the Capture file.
  490.  
  491.       When BackTalk is first run, it takes note of the current directory.
  492.       It then will change the current directory to the path defined in
  493.       the "Download Directory" string gadget.  When BackTalk terminates,
  494.       it sets current directory to what it was before.  
  495.  
  496.       NOTE:  If you use the Change Current Directory menu item from
  497.              the Files menu, the current directory will be set to 
  498.              that directory.  On program termination, current directory
  499.              will be restored to what it was when the program was
  500.              run.
  501.  
  502.       BackTalk utilizes proportional fonts.  Even if the font you have
  503.       selected is not proportional, it is treated as such.  When using
  504.       the Chat Window (described in more detail later) lines are
  505.       "auto sent" when a maximum line length is reached.  This line
  506.       length is based upon the pixel length of the line, not the 
  507.       character length of the line.  You may, in the Global Options
  508.       requester, specify at what pixel length the line should be sent.
  509.       You are shown the current maximum line length, in pixels, that
  510.       is possible (based upon your horizontal resolution) and may enter
  511.       a different value in the string gadget.  This feature is basicly
  512.       a trial and error adventure depending on the font you are using.
  513.  
  514.       When using the Chat Window, as mentioned above, lines are auto sent
  515.       if a maximum line length is reached before a carriage return is
  516.       entered.  You may elect to have a "..." automatically appended to
  517.       all lines that are auto sent from the Chat Window.  Appending the
  518.       dots is especially useful when in a conferencing area to indicate to
  519.       others that you are not through typing.  However, it can become a
  520.       nuisance if you are leaving a message while using the Chat Window.
  521.       In the Global Options requester you may select to have the dots
  522.       appended or not.
  523.  
  524.       Also in the Global Options requester are two string gadgets, labeled
  525.       "Modem Init Command" and "Modem Exit Command".  Whatever string is
  526.       in the Moden Init Command string gadget will be sent to the serial
  527.       port immediately upon starting BackTalk.  The Modem Exit Command
  528.       string will be sent to the serial port just prior to terminating
  529.       BackTalk.  If you do not want these strings to be sent, clear
  530.       these string gadgets.
  531.  
  532.    MenuItem: Split
  533.    Hot Key: Right-Amiga-S
  534.  
  535.       If you are running BackTalk in a hi resolution/interlaced mode, the
  536.       Split command will reduce the size of BackTalk's window to half
  537.       screen.  Split is a toggle.  If BackTalk is in half size mode, 
  538.       selecting split again will return it to full screen size.
  539.       The state of this item is saved in the BT.CFG file.
  540.  
  541.    MenuItem: Screen Type
  542.       SubItem: 1 Bit Plane
  543.       Hot Key: Right-Amiga-1
  544.  
  545.          Causes BackTalk to be run in a 1 bit plane custom screen.
  546.          The state of this item is saved in the BT.CFG file.
  547.  
  548.       SubItem: 2 Bit Plane
  549.       Hot Key: Right-Amiga-2
  550.  
  551.          Causes BackTalk to be run in a 2 bit plane custom screen.
  552.          The state of this item is saved in the BT.CFG file.
  553.  
  554.       SubItem: Workbench
  555.       Hot Key: Right-Amiga-3
  556.  
  557.          Causes BackTalk to be run in a workbench window.
  558.          The state of this item is saved in the BT.CFG file.
  559.  
  560.    MenuItem: Borders On/Off
  561.    Hot Key: Right-Amiga-B
  562.  
  563.       This is a toggle which turns the window borders on or off.
  564.       The state of this item is saved in the BT.CFG file.
  565.  
  566.    MenuItem: Set Colors
  567.    Hot Key: NONE
  568.  
  569.       This brings up a color requester.  You may change the colors of the
  570.       program with this requester.  This menu item is ghosted if you are
  571.       running BackTalk from a workbench window.
  572.       The state of this item is saved in the BT.CFG file.
  573.  
  574.    MenuItem: Fonts
  575.       SubItem: Diskfonts...
  576.       Hot Key: Right-Amiga-F
  577.          
  578.          This brings up a file requester defaulted to FONTS:.  Select the
  579.          font you wish to use, then select the point size, and click
  580.          on use.  The state of this item is saved in the BT.CFG file.
  581.          
  582.       SubItem: Topaz 8
  583.       Hot Key: Right-Amiga-8
  584.       
  585.          Since Topaz is a rom font it will not show up in the Fonts
  586.          file requester.  This item will select the Topaz 8 font.
  587.          The state of this item is saved in the BT.CFG file.
  588.  
  589.       SubItem: Topaz 9
  590.       Hot Key: Right-Amiga-9
  591.  
  592.          Since Topaz is a rom font it will not show up in the Fonts
  593.          file requester.  This item will select the Topaz 9 font.
  594.          The state of this item is saved in the BT.CFG file.
  595.  
  596.    MenuItem: Macros
  597.       SubItem: Load Macros
  598.       Hot Key: NONE
  599.  
  600.          This brings up the a file requester.  You may choose the macro
  601.          the macro file you want to be active.
  602.  
  603.          NOTE: Macro files may be in any directory and named in any
  604.                way you would like.  However, it is recommended that
  605.                you place your macros files in S: and that you use
  606.                the extension ".macro".  When the file requester is
  607.                presented it will be defaulted to S:#?.macros.
  608.  
  609.  
  610.       SubItem: Edit Macros
  611.       Hot Key: NONE
  612.  
  613.          This brings up the Macros requester.  Simply click on the FKey
  614.          gadget of your choice, or type the associated F-key, enter the 
  615.          text into the string gadget and type return in the string gadget.
  616.          To enter a carriage return into your macros, type a ^M (either 
  617.          the 2 separate characters ^ and M or the 2 keys together.  The 
  618.          same goes for any control character you'd like to embed in a macro).
  619.          If you exit the Macro requester by selecting SAVE a file requester
  620.          will be presented with the name of the currently selected macro file.  
  621.  
  622.          A macro may contain the command to execute an ARexx script.  The
  623.          delimiter for ARexx script names is the backslash (\).  
  624.          An example ...
  625.  
  626.          This is a test \do_something\and another test.
  627.  
  628.          If the above is your macro, "This is a test " will be sent as a
  629.          normal macro string.  Then the ARexx script "do_something" will be
  630.          run, then the text "and another test" will be sent as a normal macro
  631.          string.
  632.  
  633.          NOTE 1:  If you need to send a backslash as part of your macro and 
  634.                 it's not to be used as an ARexx scriptname delimiter, preface
  635.                 the backslash with another backslash, ie., \\.
  636.  
  637.          NOTE 2:  The ARexx script name need not contain the path nor the
  638.                 extension.  The path is assumed to be REXX: and the extension
  639.                 is assumed to be .BT.
  640.  
  641.    MenuItem: Chat Window
  642.    Hot Key: Right-Amiga-W
  643.  
  644.       This toggles the Chat Window on and off.  Text typed into the Chat
  645.       Window will be sent to the serial port when a carriage return is
  646.       typed or when the length of the line exceeds the maximum line length
  647.       (see Global Options for more information on the maximum line length).
  648.       Because lines are auto sent from the Chat Window an insert mode
  649.       is not provided.  You may move the cursor on the line in the Chat
  650.       Window with the left and right arrow keys.  If you type over text you
  651.       will be "typing over text" rather than inserting new text.
  652.  
  653.       A ctrl-X typed in the Chat Window will clear the current line.
  654.       A ctrl-Y typed in the Chat Window will delete the text from the cursor
  655.       position to the end of the line.
  656.  
  657.       The Chat Window features a 20 line Chat History Buffer.  This is a
  658.       circular buffer.  You move through previously send line by using the
  659.       the up and down arrow keys.
  660.  
  661.       Using the Chat Window in Compuserve's Conferenicng or CB areas:
  662.       If the beginning of a line is "/sen nn" (where nn is a "job number")
  663.       and the line is auto sent before a carriage return is entered, the
  664.       unsent text will be wrapped to the next line and PREpended with
  665.       the "/sen nn" from the previous line.  This helps prevent embarassing
  666.       moments if the first /sen line is auto sent and the user neglects to
  667.       type "/sen nn" on the following line.
  668.  
  669.       Sending control characters from the Chat Window to the serial port is
  670.       sometimes necessary.  BackTalk will send ctrl-C, ctrl-O, ctrl-P, ctrl-Q,
  671.       ctrl-S, ctrl-Z, and ESC from the Chat Window to the serial port.  
  672.       All others are ignored.
  673.  
  674.       When the Chat Window is active, a gadget labeled /SEN is located
  675.       on the right side of the bottom status line.  When the /SEN gadget
  676.       is clicked upon a string gadget will appear to it's right.  This
  677.       gadget is used to make it more convenient to have a /SEN converation
  678.       (private conversation) with someone in CompuServe's Conferencing or
  679.       CB areas.  When the the /SEN gadget is activated and a job number
  680.       is entered into the string gadget, all lines in the Chat Window will
  681.       be prepended with "/SEN nn" (where nn is the job number).
  682.  
  683.       The state of this item is saved in the BT.CFG file.
  684.  
  685.    MenuItem: Append "..."
  686.    Hot Key: Right-Amiga-. (period)
  687.  
  688.       This function was decribed in more detail under Global Options.
  689.       It is another way (that is "hot keyable") to turn on and off the
  690.       append dots feature of lines auto sent from the Chat Window.  When
  691.       this option is selected a "box" will appear on the far right side of
  692.       the Chat Window bar (the bar separates the main communications window
  693.       from the Chat Window).  This gives you a visual indication that you
  694.       have selected the Send Dots feature.
  695.       The state of this item is saved in the BT.CFG file.
  696.  
  697.    MenuItem: Double Click XON/XOFF
  698.    Hot Key: NONE
  699.       
  700.       A check marked menu item that toggles on and off the ability to double
  701.       click the mouse to send an xon/xoff.  The state of this item is saved
  702.       in the BT.CFG file.
  703.  
  704.    MenuItem: CTRL-U From Chat
  705.    Hot Key: NONE
  706.  
  707.       A check marked menu item that prepends a ^U to all lines sent from
  708.       the Chat Window.  This option is CompuServe specific.  If you are using
  709.       the Chat Window and you are experiencing line noise, a ^U will clear
  710.       CompuServe's input buffer (get rid of the noise) before you line is
  711.       sent.  The state of this item is saved in the BT.CFG file.
  712.    
  713.    MenuItem: Load Configuration
  714.    Hot Key: NONE
  715.  
  716.       Selecting this item will present a file requester.  You may choose
  717.       a configuration file to be loaded and "take effect".
  718.  
  719.       NOTE: Configuration files may be in any directory and named in any
  720.             way you would like.  However, it is recommended that you place
  721.             your configuration files in S: and that you use the extension 
  722.             ".cfg".  When the file requester is presented it will be 
  723.             defaulted to S:#?.cfg.
  724.  
  725.  
  726.    MenuItem: Save Configuration
  727.    Hot Key: NONE
  728.  
  729.       Selecting this item causes all current user selectable options to
  730.       be written to the file BT.CFG.  This includes the current selection
  731.       of protocol, colors, fonts, split or full window, 1 bit plane screen,
  732.       2 bit plane screen, or workbench screen, modem init and modem exit
  733.       strings, what window off or on, borders off or on, send dots off or
  734.       on, all serial parameters -- ANYTHING the user may select or change
  735.       from the default configuration.
  736.  
  737.       NOTE: As of BackTalk 1.30, a version check is made when BT.CFG
  738.       is read from disk.  If your BT.CFG file was written with a version
  739.       of BackTalk prior to 1.30 you will be presented with a requester
  740.       informing you that the file format is incompatible.  The program
  741.       will then use the internal default values.  However, the next time
  742.       you use select "Save Configuration" the new file format will be
  743.       written to disk.  This was added in anticipation of future additions
  744.       to the BT.CFG file.
  745.  
  746.  
  747. ---------------------------------------------------------------------------
  748.  
  749.                        Other Features and Functions
  750.  
  751.  
  752. ARexx:
  753.  
  754. Using internal scripts ...
  755.  
  756. When BackTalk is run it attempts to open the ARexx port "REXX".  If this
  757. port is found an new menu is added, ARexx.  Under this menu is one menuitem,
  758. "ARexx...".  When this is selected a file requester is presented.
  759. The file requester is defaulted to the REXX: directory and only filenames
  760. with an extension of .BT are displayed.  .BT is the recognized extension
  761. for BackTalk specific ARexx scripts.
  762.  
  763. Using external scripts ...
  764.  
  765. Since BackTalk may be run more than once, different iterations of the progrm 
  766. will have a uniquely named ARexx port.  In the first iteration it is 
  767. named BT_REXX. The second iteration is BT_REXX2, the third is 
  768. BT_REXX3, etc.
  769.  
  770. Quote all string arguments in your BackTalk ARexx scripts.
  771. NOTE:  All <string> arguments are case sensitive EXCEPT those used
  772.        with the ONSTRING and OFFSTRING commands.
  773.  
  774. Following are the ARexx command currently supported:
  775.  
  776. WAITFOR  Usage: WAITFOR <string>
  777.    This command waits for the string.  ARexx is not replied to
  778.    until this string is found.
  779.  
  780. ONSTRING  Usage: ONSTRING <string>
  781.    Sends a message to ARexx whenever <string> is encountered in the
  782.    serial input stream.  Your ARexx program must open a port named
  783.    BT_msg.  When a match is found, BackTalk will send a message
  784.    to BT_msg, arg0 will be MATCH.
  785.  
  786.    You may embed control characters within <string>.  To do so, use 
  787.    the ^ (caret) then the character.  (ie, "John^M^J(" will cause the
  788.    serial input stream to be searched for "John" followed by an
  789.    0x0d (^M/carriage return), a 0x0a (^J), and a left parenthesis.
  790.    If you want to search the input stream for a ^ (caret) itself,
  791.    use "^^".  IE., to search for "2^2" your string would be entered
  792.    as "2^^2".  Each caret to be searched for must be preceeded with
  793.    another caret so the program knows you really want to search for
  794.    a caret and not to interpret it as the next character being a
  795.    control character.
  796.  
  797.    NOTE 1:  If you call ONSTRING(n) while an existing ONSTRING(n) command is
  798.           running you will not add a second string to the search but
  799.           will change the search string for the currently running
  800.           iteration of ONSTRING(n).
  801.           IE., ONSTRING "JOE"   (input stream being searched for "JOE")
  802.                ONSTRING "MOE"   (input strean now being searched for "MOE")
  803.  
  804.    NOTE 2:  There is only 1 port for BackTalk to send messages to 
  805.             your ARexx script, that being "BT_msg".  You should 
  806.             include something like the following in your scripts 
  807.             that use ONSTRING(n) and OFFSTRING(n) in case another 
  808.             script you've got running is already using the port.
  809.  
  810.               if ~openport("BT_msg") then do
  811.                  MESSAGE "PORT ALREADY IN USE"
  812.                  exit
  813.               end
  814.  
  815.               If you don't and just assume the port opened without
  816.               checking the return value, or you ignore the return
  817.               value and try to use it anyway, all sorts of strange
  818.               things may happen.
  819.  
  820.               The length of the ONSTRINGn/OFFSTRINGn arguments can
  821.               be up to 64 characters.  They are NOT case sensitive.
  822.  
  823. ONSTRING1  Usage: ONSTRING1 <string>
  824.    Works exactly as described for ONSTRING except the message sent to your
  825.    ARexx script will be MATCH1.
  826.  
  827. ONSTRING2  Usage: ONSTRING2 <string>
  828.    Works exactly as described for ONSTRING except the message sent to your
  829.    ARexx script will be MATCH2.
  830.  
  831. ONSTRING3  Usage: ONSTRING3 <string>
  832.    Works exactly as described for ONSTRING except the message sent to your
  833.    ARexx script will be MATCH3.
  834.  
  835. ONSTRING4  Usage: ONSTRING4 <string>
  836.    Works exactly as described for ONSTRING except the message sent to your
  837.    ARexx script will be MATCH4.
  838.  
  839. ONSTRING5  Usage: ONSTRING5 <string>
  840.    Works exactly as described for ONSTRING except the message sent to your
  841.    ARexx script will be MATCH5.
  842.  
  843. ONSTRING6  Usage: ONSTRING6 <string>
  844.    Works exactly as described for ONSTRING except the message sent to your
  845.    ARexx script will be MATCH6.
  846.  
  847. ONSTRING7  Usage: ONSTRING7 <string>
  848.    Works exactly as described for ONSTRING except the message sent to your
  849.    ARexx script will be MATCH7.
  850.  
  851. ONSTRING8  Usage: ONSTRING8 <string>
  852.    Works exactly as described for ONSTRING except the message sent to your
  853.    ARexx script will be MATCH8.
  854.  
  855. ONSTRING9  Usage: ONSTRING9 <string>
  856.    Works exactly as described for ONSTRING except the message sent to your
  857.    ARexx script will be MATCH9.
  858.  
  859. ONSTRING10  Usage: ONSTRING10 <string>
  860.    Works exactly as described for ONSTRING except the message sent to your
  861.    ARexx script will be MATCH10.
  862.  
  863. ONSTRING11  Usage: ONSTRING11 <string>
  864.    Works exactly as described for ONSTRING except the message sent to your
  865.    ARexx script will be MATCH11.
  866.  
  867. ONSTRING12  Usage: ONSTRING12 <string>
  868.    Works exactly as described for ONSTRING except the message sent to your
  869.    ARexx script will be MATCH12.
  870.  
  871. ONSTRING13  Usage: ONSTRING13 <string>
  872.    Works exactly as described for ONSTRING except the message sent to your
  873.    ARexx script will be MATCH13.
  874.  
  875. ONSTRING14  Usage: ONSTRING14 <string>
  876.    Works exactly as described for ONSTRING except the message sent to your
  877.    ARexx script will be MATCH14.
  878.  
  879. ONSTRING15  Usage: ONSTRING15 <string>
  880.    Works exactly as described for ONSTRING except the message sent to your
  881.    ARexx script will be MATCH15.
  882.  
  883. ONSTRING16  Usage: ONSTRING16 <string>
  884.    Works exactly as described for ONSTRING except the message sent to your
  885.    ARexx script will be MATCH16.
  886.  
  887. ONSTRING17  Usage: ONSTRING17 <string>
  888.    Works exactly as described for ONSTRING except the message sent to your
  889.    ARexx script will be MATCH17.
  890.  
  891. ONSTRING18  Usage: ONSTRING18 <string>
  892.    Works exactly as described for ONSTRING except the message sent to your
  893.    ARexx script will be MATCH18.
  894.  
  895. ONSTRING19  Usage: ONSTRING19 <string>
  896.    Works exactly as described for ONSTRING except the message sent to your
  897.    ARexx script will be MATCH19.
  898.  
  899. OFFSTRING  Usage: OFFSTRING <no argument> | <string>
  900.    This causes BackTalk to terminate the ONSTRING command.
  901.    If an argument is given to OFFSTRING it will be searched for in the
  902.    serial input string.  When found BackTalk will send a message to 
  903.    ARexx which will terminate the ONSTRING command.  If no argument
  904.    is given to OFFSTRING a message will be sent to ARexx immediately
  905.    to terminate the ONSTRING command.
  906.  
  907.    When the message is sent to ARexx it is sent to a port that ARexx
  908.    has opened named "BT_msg".  Arg0 will contain "OFF".
  909.  
  910.    You may embed control characters within <string>.  To do so, use 
  911.    the ^ (caret) then the character.  (ie, "John^M^J(" will cause the
  912.    serial input stream to be searched for "John" followed by an
  913.    0x0d (^M/carriage return), a 0x0a (^J), and a left parenthesis.
  914.    If you want to search the input stream for a ^ (caret) itself,
  915.    use "^^".  IE., to search for "2^2" your string would be entered
  916.    as "2^^2".  Each caret to be searched for must be preceeded with
  917.    another caret so the program knows you really want to search for
  918.    a caret and not to interpret it as the next character being a
  919.    control character.
  920.  
  921.    NOTE:  If you give OFFSTRINGn an argument ...
  922.           The input stream is searched for the argument string.
  923.           When it is found a message is sent to ARexx and the
  924.           corresponding ONSTRINGn (it it exists) is cleared.
  925.           If you change the argument to OFFSTRINGn before a match
  926.           is found in the input stream, all you have done is changed
  927.           the search string and NOT cleared the corresponding
  928.           ONSTRING (if it exists).  This means you may do a
  929.           
  930.           OFFSTRING "test"
  931.  
  932.           if later in your ARexx script you do a
  933.  
  934.           OFFSTRING "news"
  935.  
  936.           BEFORE a match on "test" is made, you will have changed
  937.           the search criteria from "test" to "news".
  938.          
  939.           If you do NOT give OFFSTRINGn an argument ...
  940.           A message is sent to ARexx immediately and the
  941.           corresponding ONSTRINGn (if it exists) is cleared.
  942.  
  943.           What this means is that OFFSTRINGn can be used as a "one shot"
  944.           "signal me when this string is found".  Very much like WAITFOR
  945.           with the exception being that your ARexx script will have to
  946.           be looking for the message from BackTalk signaling the string
  947.           was found.  (WAITFOR does not reply to ARexx until the string
  948.           is found and therefore effectively stops further execution of
  949.           your ARexx script until a match is found).
  950.  
  951.  
  952. OFFSTRING1  Usage: OFFSTRING1 <no argument> | <string>
  953.    Works exactly as described for OFFSTRING except the message sent to your
  954.    ARexx script will be OFF1.
  955.  
  956. OFFSTRING2  Usage: OFFSTRING2 <no argument> | <string>
  957.    Works exactly as described for OFFSTRING except the message sent to your
  958.    ARexx script will be OFF2.
  959.  
  960. OFFSTRING3  Usage: OFFSTRING3 <no argument> | <string>
  961.    Works exactly as described for OFFSTRING except the message sent to your
  962.    ARexx script will be OFF3.
  963.  
  964. OFFSTRING4  Usage: OFFSTRING4 <no argument> | <string>
  965.    Works exactly as described for OFFSTRING except the message sent to your
  966.    ARexx script will be OFF4.
  967.  
  968. OFFSTRING5  Usage: OFFSTRING5 <no argument> | <string>
  969.    Works exactly as described for OFFSTRING except the message sent to your
  970.    ARexx script will be OFF5.
  971.  
  972. OFFSTRING6  Usage: OFFSTRING6 <no argument> | <string>
  973.    Works exactly as described for OFFSTRING except the message sent to your
  974.    ARexx script will be OFF6.
  975.  
  976. OFFSTRING7  Usage: OFFSTRING7 <no argument> | <string>
  977.    Works exactly as described for OFFSTRING except the message sent to your
  978.    ARexx script will be OFF7.
  979.  
  980. OFFSTRING8  Usage: OFFSTRING8 <no argument> | <string>
  981.    Works exactly as described for OFFSTRING except the message sent to your
  982.    ARexx script will be OFF8.
  983.  
  984. OFFSTRING9  Usage: OFFSTRING9 <no argument> | <string>
  985.    Works exactly as described for OFFSTRING except the message sent to your
  986.    ARexx script will be OFF9.
  987.  
  988. OFFSTRING10  Usage: OFFSTRING10 <no argument> | <string>
  989.    Works exactly as described for OFFSTRING except the message sent to your
  990.    ARexx script will be OFF10.
  991.  
  992. OFFSTRING11  Usage: OFFSTRING11 <no argument> | <string>
  993.    Works exactly as described for OFFSTRING except the message sent to your
  994.    ARexx script will be OFF11.
  995.  
  996. OFFSTRING12  Usage: OFFSTRING12 <no argument> | <string>
  997.    Works exactly as described for OFFSTRING except the message sent to your
  998.    ARexx script will be OFF12.
  999.  
  1000. OFFSTRING13  Usage: OFFSTRING13 <no argument> | <string>
  1001.    Works exactly as described for OFFSTRING except the message sent to your
  1002.    ARexx script will be OFF13.
  1003.  
  1004. OFFSTRING14  Usage: OFFSTRING14 <no argument> | <string>
  1005.    Works exactly as described for OFFSTRING except the message sent to your
  1006.    ARexx script will be OFF14.
  1007.  
  1008. OFFSTRING15  Usage: OFFSTRING15 <no argument> | <string>
  1009.    Works exactly as described for OFFSTRING except the message sent to your
  1010.    ARexx script will be OFF15.
  1011.  
  1012. OFFSTRING16  Usage: OFFSTRING16 <no argument> | <string>
  1013.    Works exactly as described for OFFSTRING except the message sent to your
  1014.    ARexx script will be OFF16.
  1015.  
  1016. OFFSTRING17  Usage: OFFSTRING17 <no argument> | <string>
  1017.    Works exactly as described for OFFSTRING except the message sent to your
  1018.    ARexx script will be OFF17.
  1019.  
  1020. OFFSTRING18  Usage: OFFSTRING18 <no argument> | <string>
  1021.    Works exactly as described for OFFSTRING except the message sent to your
  1022.    ARexx script will be OFF18.
  1023.  
  1024. OFFSTRING19  Usage: OFFSTRING19 <no argument> | <string>
  1025.    Works exactly as described for OFFSTRING except the message sent to your
  1026.    ARexx script will be OFF19.
  1027.  
  1028. OFFSTRINGALL  Usage:  OFFSTRINGALL
  1029.    This will clear all outstanding OFFSTRINGn and ONSTRINGn
  1030.    calls.  To be used if RESET does too much for your needs.
  1031.    It is HIGHLY recommended you use either OFFSTRINGALL or
  1032.    RESET immediately before exiting your ARexx script if 
  1033.    ONSTRINGn and/or OFFSTRINGn were used in the script.
  1034.  
  1035. RESET  Usage: RESET
  1036.    This is recommended to be used immediately before the "exit" command
  1037.    in your ARexx scripts.  It will clear all outstanding ONSTRINGn and
  1038.    OFFSTRINGn calls, restore screen display if DISPLAYOFF was called, 
  1039.    and UNBLOCK user input if BLOCK was called.  The main purpose of this 
  1040.    command is to tell BackTalk that the script has terminated and there 
  1041.    is no longer any reason to be checking the input stream for matches 
  1042.    if you had used ONSTRINGn/OFFSTRINGn.  Of course, RESET can be used 
  1043.    at any time in an ARexx script if you wish the above actions to take 
  1044.    place.
  1045.  
  1046. SEND  Usage: SEND <string>
  1047.    Sends a string to the serial port with a terminating carriage return.
  1048.    If the first character of <string> is a ^ (caret) the following
  1049.    character will immediately be sent as a control character and any
  1050.    text following that 2 character sequence will be ignored.  No carriage
  1051.    return is sent after a control character regardless of whether SEND
  1052.    or SENDNCR was used.
  1053.  
  1054. SENDNCR  Usage: SENDNCR <string>
  1055.     The same as SEND however does not send a terminating carriage return
  1056.  
  1057. MESSAGE  Usage:  MESSAGE <string>
  1058.    Sends a text message to the screen and to the review buffer 
  1059.    but does not send it to the serial port.
  1060.  
  1061. FKEY  Usage: FKEY <Fn | SFn> 
  1062.    This will send one of BackTalk's fkey macros
  1063.    Returns a non-zero on failure.
  1064.  
  1065. LMACROS  Usage: LMACROS <path/filename>
  1066.    This will load in an alternate set of macros.
  1067.    Returns a non-zero on failure.
  1068.  
  1069. LCONFIG  Usage: LCONFIG <path/filename>
  1070.    This will load in an alternate configuration.
  1071.    Returns a non-zero on failure.
  1072.  
  1073. CDIR  Usage: CDIR <drive/path>
  1074.    Changes the current directory.  Returns non-zero on failure.
  1075.  
  1076. FONT  Usage: FONT <fontname> <size>  (ie, FONT "courier" "13")
  1077.    Will load in a new font.  If the point size argument is missing
  1078.    no change will be made and an error of "5" will be returned.  If
  1079.    the font name cannot be found the font will be changed to Topaz 8 and
  1080.    and error of 10 will be returned.
  1081.  
  1082. OPENCAPTURE  Usage: OPENCAPTURE <filename | default from global options>
  1083.    Returns a non-zero on failure.
  1084.  
  1085. CLOSECAPTURE  Usage:  CLOSECAPTURE
  1086.    closes the capture file
  1087.  
  1088. DISPLAYOFF  Usage: DISPLAYOFF
  1089.    this turns off screen output.  Scrolling, cursor
  1090.    positioning, etc. still takes place, just no text
  1091.    is output to the screen.
  1092.  
  1093. DISPLAYON  Usage:
  1094.    resume text display
  1095.  
  1096. GETSTRING  Usage: GETSTRING <no argument> | <string>
  1097.    Brings up a string requester and returns the string to ARexx.
  1098.    The argument for this command is the prompt string for the requester.
  1099.    You may remember why the requester popped up requesting input but
  1100.    other users of your script might not.  If no argument is given the
  1101.    default text is "Enter your text".  An error code of 10 is returned
  1102.    if the requester failed to display.
  1103.  
  1104. GETFILENAME  Usage: GETFILENAME <no argument | path>
  1105.    Brings up a file requester and returns the full path to ARexx.
  1106.    If cancel is clicked in the file requester a null string is returned.
  1107.  
  1108. PROTOCOL  Usage: PROTOCOL <xprlibrary name>  (ie., PROTOCOL "xprascii")
  1109.    Selects and loads the specified XPR library.  The ".library" is not 
  1110.    needed in the argument (but nothing is harmed if it's there).  If the 
  1111.    specified library cannot be loaded for some reason, the xprquickb.library
  1112.    will be loaded.  If this is the case an error of 10 will be returned,
  1113.    otherwise the result will be 0.
  1114.  
  1115. SETXPR  Usage: SETXPR <string>
  1116.    This will send string containing the codes for various user definable
  1117.    options for the currently loaded XPR library.  NO checking is made
  1118.    to determine which library is currently active, just that there IS a
  1119.    library loaded.  This function is probably best used immediately
  1120.    after a PROTOCOL call.  For details on just what user definable
  1121.    options each individual XPR protocol offers, and their codes,
  1122.    see the file "ABOUT_XPR".
  1123.  
  1124. DOWNLOAD  Usage: DOWNLOAD <path/filename>
  1125.    The argument the path/name of the file that is written to your computer.
  1126.    If no path/filename argument is given a file requester will be presented
  1127.    for you to enter the path/name.  If you select Cancel on the file requester
  1128.    or select USE with no filename selected a non-zero error code will be
  1129.    returned.
  1130.  
  1131.    NOTE: If the protocol selected is an "auto-start" protocol (currently
  1132.          xprquickb and xprzmodem are the only two currently available in 
  1133.          XPR format that I know of) this function will return immediately
  1134.          with an error code of 0.  If the protocol is not an auto-start
  1135.          protocol this function will return with a 0 after completion of
  1136.          the file transfer.
  1137.  
  1138. UPLOAD  Usage: UPLOAD <path/filename>
  1139.    The argument the path/name of the file that is sent from your computer.
  1140.    If no path/filename argument is given a file requester will be presented
  1141.    for you to enter the path/name.  If you select Cancel on the file requester
  1142.    or select USE with no filename selected a non-zero error code will be
  1143.    returned. 
  1144.    
  1145.    NOTE: See the NOTE for DOWNLOAD.
  1146.  
  1147. BAUD  Usage: BAUD <rate>
  1148.    Returns a non-zero on failure.
  1149.  
  1150. PARITY  Usage: PARITY <Odd | Even | None>
  1151.   Returns a non-zero on failure.
  1152.  
  1153. DUPLEX  Usage: DUPLEX <Full | Half>
  1154.    Returns a non-zero on failure.
  1155.  
  1156. DLENGTH  Usage: DLENGTH <7 | 8>
  1157.    Returns a non-zero on failure.
  1158.  
  1159. STOPBITS  Usage: STOPBITS <1 | 2>
  1160.    Returns a non-zero on failure.
  1161.  
  1162. DEVICENAME <string>  Usage: DEVICENAME <device.name>
  1163.    Should this command fail, the program will read bt.cfg and use
  1164.    those values to reopen the serial port.  Of course, this will
  1165.    negate any changes you may have made previously via the
  1166.    PARITY, DUPLEX, DLENGTH, BAUD, and STOPBITS command.
  1167.  
  1168. UNITNUMBER <number>  Usage: UNITNUMBER <number>
  1169.    This command has the same caveat as DEVICENAME.  If it fails
  1170.    bt.cfg will be read and the serial port reopened with those
  1171.    values.  A strange thing with unit number, tho.  Serial.device
  1172.    will allow you to open using unit number 1, so the change is
  1173.    successful altho BackTalk no longer talks to the modem.
  1174.  
  1175. PRINTERON  Usage: PRINTERON
  1176.    turns on echo to printer
  1177.  
  1178. PRINTEROFF  Usage: PRINTEROFF
  1179.    turns off echo to printer 
  1180.  
  1181. BEEP  Usage: BEEP
  1182.    Flashes all screens
  1183.  
  1184. CLEARSCREEN  Usage: CLEARSCREEN
  1185.    Clears the communications window.  If the Chat Window is present it will
  1186.    clear up to the Chat Bar.
  1187.  
  1188. BLOCK  Usage: BLOCK
  1189.    This function blocks all user input to BackTalk.
  1190.    Block removes the menustrip and ignores all keyboard input.  
  1191.  
  1192.    Note: Make sure that you issue either the UNBLOCK command or
  1193.          the QUIT command before the ARexx script ends otherwise
  1194.          you will not be able to communicate at all with BackTalk.
  1195.  
  1196. UNBLOCK  Usage: UNBLOCK
  1197.    Restores the menustrip and again pays attention to keyboard input.
  1198.  
  1199. SCREENTOBACK  Usage: SCREENTOBACK
  1200.    If BackTalk is running in a non-workbench screen, this will push
  1201.    the screen to the back.
  1202.  
  1203. SCREENTOFRONT  Usage: SCREENTOFRONT
  1204.    If BackTalk is running in a non-workbench screen, this will push
  1205.    the screen to the front.
  1206.  
  1207. HANGUP  Usage: HANGUP
  1208.   This command works just like the Hangup menu item.
  1209.   It drops DTR.  If CD was never set (dip flipped or using a 3 wire cable)
  1210.   it will wait 60 ticks then send a "+++", delay(60), "ATH\r\n".
  1211.  
  1212. QUIT  Usage: QUIT
  1213.    It does what it says, it will shutdown the program.
  1214.  
  1215. DOTS  Usage: DOTS
  1216.    This is a toggle.  If the "Append ..." feature is enabled this will
  1217.    turn it off.  If it is not enabled, this will turn it on.
  1218.  
  1219. BORDER  Usage: BORDER
  1220.    This is a toggle.  If the window borders are displayed this will remove
  1221.    them.  If the borders are not displayed this will a set them.
  1222.  
  1223. CHAT  Usage: CHAT
  1224.    This is a toggle.  If the chat window is up, this removes it.  If it is
  1225.    not enabled this enables it.
  1226.    
  1227. CLICK  Usage: CLICK
  1228.    This is a toggle.  If the "Double Click XON/XOFF" feature is set this
  1229.    turns it off.  If it is off, this turns it on.
  1230.  
  1231. SENDU  Usage: SENDU
  1232.    This is a toggle.  If the "Preface lines from chat window with ^U" is set
  1233.    this turns it off.  If it is off, this turns it on.
  1234.  
  1235. SPLIT  Usage: SPLIT
  1236.    This is a toggle.  If you are running on an interlaced system, SPLIT will
  1237.    toggle from full screen display to half screen display and back again.
  1238.  
  1239. BITPLANE1  Usage: BITPLANE1
  1240.    Causes BackTalk to be run in a 1 bitplane custom screen.
  1241.  
  1242. BITPLANE2  Usage: BITPLANE2
  1243.    Causes BackTalk to be run in a 2 bitplane custom screen.
  1244.  
  1245. WBWINDOW  Usage: WBWINDOW
  1246.    Causes BackTalk to be run in a Workbench window.
  1247.  
  1248. QSCREEN  Usage: QSCREEN
  1249.    Returns the string "SCREEN" or "WORKBENCH" indicating in what screen mode
  1250.    the program is currently running.
  1251.  
  1252. QSIZE  Usage: QSIZE
  1253.    Checks whether the program is running with a half or full sized window.
  1254.    Returns the string "HALF" or "FULL".
  1255.  
  1256. QLACE  Usage: QLACE
  1257.    Checks the interlace flag.  Returns the string "ON" or "OFF".
  1258.  
  1259. QDEPTH  Usage: QDEPTH
  1260.    If the program is running on a custom screen, returns, as a string,  the
  1261.    number of bit planes.  If running in a workbench window, it returns a
  1262.    null string.
  1263.  
  1264. QFONTNAME  Usage: QFONTNAME
  1265.     Returns the name of the currently selected font.
  1266.  
  1267. QFONTSIZE  Usage: QFONTSIZE
  1268.    Returns the size of the currently selected font.
  1269.  
  1270. QCHAT  Usage: QCHAT
  1271.    Returns the "ON" or "OFF" state of chat window.
  1272.  
  1273. QBORDER  Usage: QBORDER 
  1274.    Returns the "ON" or "OFF" state of the window borders.
  1275.  
  1276. QDUPLEX  Usage: QDUPLEX
  1277.    Returns the "FULL" or "HALF" state of the duplex.
  1278.  
  1279. QBAUD  Usage: QBAUD
  1280.    Returns the current baud rate.
  1281.  
  1282. QWLENGTH  Usage: QWLENGTH
  1283.    Returns the current word length setting.
  1284.  
  1285. QSTOPBITS  Usage: QSTOPBITS
  1286.    Returns the current stop bit setting.
  1287.  
  1288. QPARITY  Usage: QPARITY
  1289.    Returns the current parity setting, "NONE", "ODD", or "EVEN".
  1290.  
  1291. QCD  Usage: QCD
  1292.    Returns the state of Carrier Detect.  Returns the string "ON" if
  1293.    you are online, "OFF" if you aren't.
  1294.  
  1295. QDEVICENAME  Usage: QDEVICENAME
  1296.    Returns the name of the currently seleced serial device.
  1297.  
  1298. QUNITNUMBER  Usage: QUNITNUMBER
  1299.    Returns the currently selected serial device unit number.
  1300.  
  1301. QPROTOCOL  Usage: QPROTOCOL
  1302.    Returns the currently selected XPR protocol.
  1303.  
  1304. QDOTS   Usage: QDOTS
  1305.    Returns the state of "Append ...".  "ON" or "OFF".
  1306.  
  1307. QPIXELS  Usage: QPIXELS
  1308.    Returns the currently selected pixel length wrap point.
  1309.  
  1310. QCAPTURE  Usage: QCAPTURE
  1311.    Returns the name of the default capture path/file
  1312.  
  1313. QDOWNLOAD  Usage: QDOWNLOAD
  1314.    Returns the name of the default download path
  1315.  
  1316. QUPLOAD  Usage: QUPLOAD
  1317.    Returns the name of the default upload path
  1318.  
  1319. QCLICK  Usage: QCLICK
  1320.    Returns the current state of the "Double Click XON/XOFF" feature, 
  1321.    "ON", or "OFF".
  1322.  
  1323. QSENDU  Usage: QSENDU
  1324.    Returns the current state of the "prepend ^U to chat lines" feature, 
  1325.    "ON", of "OFF"
  1326.                
  1327. QSADDRESS  Usage: QSADDRESS
  1328.    If BackTalk is currently running in a custom screen, this
  1329.    returns the hex address of that screen.  If the program is
  1330.    running in a workbench window, this command returns a null string.
  1331.  
  1332.  
  1333.                        !!!!! IMPORTANT !!!!!
  1334.  
  1335. In all of your ARexx scripts that call ONSTRINGn and/or OFFSTRINGn,
  1336. make sure that in your getpkt() loop you've got something similiar to...
  1337.  
  1338. when arg0 = 'DIE' then do
  1339.    closeport("BT_msg")
  1340.    /* other clean up stuff here */
  1341.    exit
  1342. end
  1343.  
  1344. This is _VERY_ important.  If you have an ARexx script running that is
  1345. waiting for events (currently the only implemented BackTalk ARexx calls
  1346. that will generate these events are the ONSTRINGn and OFFSTRINGn calls)
  1347. and you terminate BackTalk, BackTalk will not be able to fully terminate
  1348. until your ARexx script exits the getpkt() loop.  During BackTalk's
  1349. termination process, it will check if the port BT_msg is open.  If it
  1350. is, BackTalk will send the "DIE" message to BT_msg.  It is up to your
  1351. script to properly exit the getpkt() loop and terminate.  The termination
  1352. of the ARexx script will signal BackTalk to complete its termination
  1353. process.
  1354.  
  1355. ---------------------------------------------------------------------------
  1356.  
  1357. Following is an example ARexx script:
  1358.  
  1359.  
  1360. /* Start BackTalk ARexx script */
  1361. options results
  1362. address command "run BackTalk"
  1363. waitforport BT_REXX
  1364.  
  1365. if ~show('l', "rexxsupport.library") then
  1366.    addlib('rexxsupport.library',0,-30,0) 
  1367.  
  1368. address BT_REXX 
  1369. BLOCK
  1370. QSIZE
  1371. if result = "FULL" then
  1372.    SPLIT
  1373.  
  1374. call delay 100
  1375.  
  1376. GETSTRING "Enter the phone number to dial"
  1377. num = result
  1378.  
  1379. SENDNCR "atmdt "
  1380. SEND num
  1381. WAITFOR "CONNECT"
  1382. call delay 50
  1383. SENDNCR "^C"
  1384. WAITFOR "User ID:"
  1385. call delay 50
  1386. DISPLAYOFF
  1387. FKEY F2      /* this is an fkey macro, it sends my ppn and password */
  1388.              /* in the form of 77777,1234\\password                 */
  1389.    
  1390. call delay 100
  1391. DISPLAYON
  1392. FONT "Courier" "13"
  1393. SEND "G AmigaUser"
  1394. WAITFOR "Forum !"
  1395. OPENCAPTURE "ram:testing"
  1396. SEND "RN"
  1397. WAITFOR "Forum !"
  1398. CLOSECAPTURE
  1399. SEND "BYE"
  1400. QUIT
  1401.  
  1402.  
  1403. (More scripts are included in the archive and will likely change from
  1404. release to release.  Remember, scripts ending in .REXX are meant to be
  1405. run external to BackTalk, those ending in .BT are meant to be run from
  1406. within BackTalk)
  1407.  
  1408. ---------------------------------------------------------------------------
  1409.  
  1410. Scroll Lock:
  1411.  
  1412. When a ^S is sent to the serial port, a text message, "Scroll Lock On" is
  1413. displayed on the left side of bottom status line.  This is just a visual
  1414. indication that a ^S has been send and incoming text will not be resumed
  1415. until a ^Q is sent.
  1416.  
  1417. Mouse double click:
  1418.  
  1419. Double clicking the left mouse button sends a ^S to the modem.  Double
  1420. clicking again sends a ^Q.  This feature is user selectable via the
  1421. Configuration menu.  The state of this item will be saved in BT.CFG.
  1422.  
  1423.  
  1424. Hot keyable requesters:
  1425.  
  1426. All gadget "buttons" in requesters in BackTalk, except for 2 exceptions 
  1427. previously noted, are "hot keyable".  Just type the first letter in the name
  1428. of the gadget.
  1429.  
  1430. ---------------------------------------------------------------------------
  1431.  
  1432. Many enhancements are planned for the future.  Please don't be shy with
  1433. enhancement requests and bug reports.
  1434.