home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / comm / term33in.lha / Documentation / term.doc < prev    next >
Text File  |  1993-04-30  |  121KB  |  3,443 lines
  1. Introduction
  2. **************
  3.  
  4.    `term' is a telecommuncations program designed for use with any
  5. Commodore-Amiga computer running Kickstart 2.04 or higher. Its features
  6. include
  7.  
  8.    * Fast built-in VT-220 terminal emulation
  9.  
  10.    * Support for custom terminal emulation modules following the `XEM
  11.      2.0' standard
  12.  
  13.    * Operates in any display environment, supports all screen display
  14.      modes
  15.  
  16.    * Support for file transfer modules following the `XPR' standard
  17.  
  18.    * File- and printer-capturing functions
  19.  
  20.    * Review-buffer support
  21.  
  22.    * Powerful phone book and dialing functions
  23.  
  24.    * `Amiga User Interface Style Guide' conformant user interface
  25.  
  26.    * Online-help (as of Workbench 3.0)
  27.  
  28.    * Built-in `ARexx' interface
  29.  
  30.    Although this program is freely-distributable, it is not entirely
  31. free. If you like and use it frequently, you are requested to send the
  32. author a donation which you suppose will do as a payment for the
  33. program. See the chapter Gift-Ware fee for details.
  34.  
  35.  
  36. Gift-Ware fee
  37. **************
  38.  
  39.    The development of `term' required considerable expense. The effort
  40. to find out by trial and error and with a little help from the
  41. DevCon-Disks and the Includes & Autodocs the operating principles of
  42. some routines would alone be worth a remuneration to the author -- it's
  43. simply bad luck if the Atlanta-DevCon records arrive with considerable
  44. delay. The author is susceptible to all kinds of donation and gifts so
  45. long as it is assured that they are useful to him. Therefore anyone
  46. pleased by `term' or who works with the source code is welcome to
  47. remunerate my programming efforts as he/she thinks that it matches my
  48. efforts - a lot of thanks! If you have got no ideas yet, here is a (by
  49. no means complete) list of suggestions:
  50.  
  51.    * Old CinemaWare games -- with the exception of `Defender of the
  52.      Crown', `The King of Chicago', `Sinbad', `It came from the desert'
  53.      `TV-Sports Basketball' and `TV-Sports Football'
  54.  
  55.    * Old Activision, Electronic Arts and Epyx games
  56.  
  57.    * Scenery disks for the SubLogic Flight-Simulator II -- except for
  58.      `Japan', `USA #7' and `USA #9'
  59.  
  60.    * The films `Jabberwocky', `Brazil', `The Fisher King' or `Time
  61.      Bandits' on a PAL-VHS video cassette
  62.  
  63.    * A CD by the Beatles (except for `Sgt. Pepper's Lonely Hearts Club
  64.      Band'), Jackson Browne, Little Feat (-1989), Weather Report, Paul
  65.      Simon (1971-1985), Eric Clapton (-1988), Al DiMeola (1977-)
  66.  
  67.    * A CD by Steely Dan (`Can't buy a thrill', `The early years',
  68.      `Berry Town', `Old regime', `Stone piano', `You go where I go',
  69.      `Founders of Steely Dan', `Sun Mountain') or by Donald Fagen (`The
  70.      Nightfly', `The New York Rock & Soul Revue', `Teahouse on the
  71.      tracks')
  72.  
  73.    * CD roms and CD rom caddies
  74.  
  75.    * A CTDV device
  76.  
  77.    * MPEG movie files and JPEG image files
  78.  
  79.    * A book by Michael Crichton, Bruce Chatwin, Raymond Chandler or
  80.      Steven Meretzky
  81.  
  82.    * Cash and checks (no credit cards -- sorry) are always welcome.
  83.  
  84.                               My address:
  85.  
  86.                              Olaf Barthel
  87.                            Brabeckstrasse 35
  88.                           D-3000 Hannover 71
  89.  
  90.                       Federal Republic of Germany
  91.  
  92.                  Internet: olsen@sourcery.mxm.sub.org
  93.  
  94.    Would those people looking at the source code to extend it or do some
  95. modifications here and there please contact me before publication so
  96. that our efforts can be coordinated.
  97.  
  98.  
  99. Reporting bugs
  100. ***************
  101.  
  102.    `term' is a rather complex program which is difficult to maintain --
  103. especially since there is only one person to take care of it:  me.
  104. Although one tries to write correct, bug-free software, one cannot
  105. always achieve this goal. Tough -- but that's life. It rains when you
  106. leave the umbrella at home. Toast falls buttered-side down. The phone
  107. rings while you are in the bath.
  108.  
  109.    In case you come upon one of those nasty features which even the
  110. author was unable to track down and remove, follow these steps:
  111.  
  112.   1. Keep calm. Shouting, cursing, crushing disks may help to cool your
  113.      temper, but it will not help anybody (the least yourself!) if it
  114.      results in a sudden cardiac infarction:  you will have problems in
  115.      reporting the problem.
  116.  
  117.   2. Read the documentation! The bug you may want to report may be a
  118.      deliberate feature.
  119.  
  120.   3. Repeat previous step as often as possible. Yes, really, do so.
  121.      Read the documentation. You will be glad you did.
  122.  
  123.   4. Describe your problem elaborately. A comment like `things fall
  124.      down when dropped' may have inspired Sir Isaac Newton, but a
  125.      similarly laconic comment `downloads do not work' will most
  126.      certainly fail to give any useful hints how to approach the
  127.      problem. In case you encounter a problem with the built-in terminal
  128.      emulation, try to make a verbatim file capture (i.e. turn off the
  129.      `Capture filter') of the session in which the offending codes were
  130.      used and send it to me.
  131.  
  132.   5. If you wish to report a bug in the ARexx interface include a
  133.      sample ARexx script to produce the bug.
  134.  
  135.   6. Do not forget to write it down! There is a difference between
  136.      noticing a bug and reporting it (honestly!). Do not suppose that a
  137.      bug will be fixed in a future program revision or rely on anybody
  138.      else to report it:  do it yourself. Send a letter to the author,
  139.      preferably per electronic mailing services. The addresses are
  140.      given at the end of this document.
  141.  
  142.   7. State your system and program configuration. It helps a lot to
  143.      know on which machine the program caused problems. Please include
  144.      information such as memory expansion size, Amiga model (A500+,
  145.      A600, A1200, A3000, A4000, etc.), graphics hardware (ECS, AGA,
  146.      etc.), CPU type (MC68000, MC68020, MC68030, MC68040, etc.).
  147.  
  148.  
  149.  
  150. Background
  151. ***********
  152.  
  153.    This program is a product of anger and despair; I was unable to find
  154. a telecommunications program to suit my personal needs -- neither in the
  155. commercial area, nor in the public-domain.
  156.  
  157.    Most programs had a lot of extras but lacked other more important,
  158. perhaps more sensible features (just to take an example:  in revision
  159. 2.20c and after four years of constant development `Handshake' still
  160. fails to use the current keymap settings and also strips the high order
  161. bit when receiving text -- sorry Eric, that's why I never registered!).
  162.  
  163.    I have hesitated for a long time before starting my first attempt at
  164. writing my very own telecommunications program. When Kickstart 2.x was
  165. about to become widely available I took the opportunity to create `term'
  166. always trying to use the new OS routines wherever possible. While this
  167. started to be quite a difficult task it also was a lot of fun (imagine
  168. Columbus wrecking his fleet four times on his journey to the West Indies
  169. due to unexpected leakages in all vessels and sudden changes in the
  170. ships' sailing manuals -- that's how I felt!).
  171.  
  172.    As far as computer-telecommunications are concerned, Germany appears
  173. to be a developing country. This is partly due to the Deutsche
  174. Bundespost, the federal mail/phone company whose telecommunications
  175. monopoly used to be protected by federal law. Until 1989 you would risk
  176. a heavy penalty if using a non-registered modem or telephone instead of
  177. the Bundespost-supplied hardware. So, if you have any complaints or
  178. miss a few extremely important features in `term', don't boo and hiss,
  179. I am not as long in the telecomm business as you are (I have yet seen
  180. only a single `DEC VT-101' from afar!). Tell me what you need and I will
  181. try to add it in the next revision.
  182.  
  183.    This project was started at December 24 1990 and completed by
  184. January 25 1991.
  185.  
  186.  
  187. Acknowledgements
  188. *****************
  189.  
  190.    My thanks go to the following people for their invaluable help and
  191. assistance:  Andreas Kirchwitz, Christoph Teuber, Christopher Wichura,
  192. Garry Glendown, Germar Morgenthaler, Henning Hucke, Holger Lubitz,
  193. Juergen Otte, Marc-Christian Schroer, Marko Kuechmann, Markus Stoll,
  194. Martin Berndt, Matthias Zepf, Michael Vaeth, Michael Wolfgang Hohmann,
  195. Oliver Wagner, Peter Fischer, Ralf Thanner, Ralph Schmidt, Roby Leemann
  196. & AUGS, Stefan Becker, Thorsten Seidel, Till `Dill-Prince' Prinzler,
  197. Udo Wolt, Ueli Kaufmann, Veith Schoergenhummer, Volker Ulle & the
  198. Aquila Sysop Team and to all those who supplied libraries & control
  199. sequence tables.
  200.  
  201.    Special thanks go to John Burton of Papua New Guinea who revised and
  202. rewrote certain parts of the program, in particular the terminal
  203. emulation routines, Leo Schwab who discovered means to use interleaved
  204. screen bitmaps in a system-integrated manner and to Nicola Salmoria
  205. whose invaluable assistance helped to reduce the incredible number of
  206. bugs lurking in the source code.
  207.  
  208.    The xpr-libraries were created by Terence Finney (`bplus'), Kenneth
  209. Osterberg & Markus Pietz (`jmodem'), Marco Papa & Stephen Walton
  210. (`kermit'), Jack Rouse (`quickb'), Marc Boucher (`xmodem'), Ueli
  211. Kaufmann (`ascii', `ymodem' & `vms') and Rick Huebner & William M.
  212. Perkins (`zmodem').
  213.  
  214.    The xpr-standard was created by Willy Langeveld, the quicksort
  215. routine (`QuickSort.asm') was written by David Jones.
  216.  
  217.    The current implementation of the external terminal emulation library
  218. interface was developed by Ueli Kaufmann, who also wrote the external
  219. terminal emulation libraries supplied with `term'. Without the
  220. invaluable help of Martin Berndt the library interface would probably
  221. not be working at all.
  222.  
  223.    Since time did not permit me to translate the full original German
  224. documentation into English, I had asked the Z-Net Amiga community for
  225. help. As a result this document was translated by three different
  226. authors (in order of translation):  me, Marc Schroer and Henning Hucke.
  227. Garry Glendown took care of the original termRexx documentation --
  228. thanks to all of you!
  229.  
  230.  
  231. Source code
  232. ************
  233.  
  234.    Since there are still only very few well-documented examples (or
  235. general programming examples) for Kickstart 2.x and Kickstart 3.x I
  236. have decided to include the full `C' source code with the `term'
  237. distribution.
  238.  
  239.    The source code is *not* intended for commercial use. If you are
  240. about to include portions in commercial programs you will need to ask me
  241. for permission. Still you may use parts of the source code for
  242. non-commercial software development without my consent.
  243.  
  244.    I sincerely hope that the release of the full `term' source code will
  245. give Kickstart 2.x a better start (I've overcome quite a lot of
  246. obstacles) so that more programs to use the new OS features will be
  247. available soon.
  248.  
  249.  
  250. Program updates
  251. ****************
  252.  
  253.    Whenever a new release of `term' becomes available I will try to
  254. make it known in the telecommunications networks. To order a copy send
  255. a self addressed envelope, the equivalent to DM 7,- (cash or cheque)
  256. and two 3.5" double density disks/one 3.5" high density disk to the
  257. author.
  258.  
  259.    The most current `term' release will be available through ftp from
  260. `ftp.informatik.uni-oldenburg.de' (`134.106.1.9'), look into the
  261. `/pub/amiga/term' directory.
  262.  
  263.    New program releases will be announced in the
  264. `comp.sys.amiga.datacomm' newsgroup.
  265.  
  266.    Whereever possible, I will include PGP signature certificate files
  267. with the binaries to ensure their authenticity.
  268.  
  269.  
  270. Documentation and online help
  271. ******************************
  272.  
  273.    `term' comes bundled with a number of documentation files, these are:
  274.  
  275. `term.doc'
  276.      Human-readable english program documentation in standard ASCII
  277.      format.
  278.  
  279. `term.dvi'
  280.      English program documentation in a format suitable for printing
  281.      using a utility to print TeX-DVI-output files, such as supplied
  282.      with the packages AmigaTeX(tm) or PasTeX.
  283.  
  284. `term.guide'
  285.      English program documentation in AmigaGuide(tm) format suitable to
  286.      submit to `AmigaGuide' or `MultiView'.
  287.  
  288. `termRexx.doc'
  289.      Human-readable english `term' ARexx interface documentation in
  290.      standard ASCII format. This file describes all the ARexx host
  291.      commands `term' supports and also gives a brief introduction how
  292.      to use them.
  293.  
  294. `termRexx.dvi'
  295.      English ARexx interface documentation in a format suitable to
  296.      printing using a utility to print TeX-DVI-output files, such as
  297.      supplied with the packages AmigaTeX(tm) or PasTeX. *Note that in
  298.      order to print this manual the LaTeX font `circle10' is required*
  299.  
  300. `termRexx.guide'
  301.      English ARexx interface documentation in AmigaGuide(tm) format
  302.      suitable to submit to `AmigaGuide' or `MultiView'.
  303.  
  304. `xprascii.doc ... xprzmodem.doc'
  305.      Human-readable documentation on the XPR transfer libraries
  306.      supplied with `term'.
  307.  
  308.    In order to take advantage of the online-help feature, Kickstart 3.0
  309. and the file `term.guide' are required. Copy the file to the drawer the
  310. `term' main program is located in and configure the ``term' help text
  311. file' settings (see Path panel) to point to `PROGDIR:term.guide'. Once
  312. this has been done, pressing the `Help' key in any window to support
  313. online help will bring up context sensitive online help.
  314.  
  315.  
  316. Foreign language support
  317. *************************
  318.  
  319.    `term' supports foreign language text catalog tables as introduced
  320. with Workbench 2.1 `locale.library'. As of this writing there is only a
  321. german translation of the program text available. If you wish to create
  322. your own national translation table you should consult the program
  323. source code file `term-blank.ct' which is a blank translation table.
  324. Before actually starting to fill the translation table in you should
  325. contact me first; there may already be someone preparing a translation.
  326. However, you should keep in mind that once you have created a foreign
  327. language translation of the program text I may ask you to update your
  328. translation for a future program release.
  329.  
  330.    Once you are done with the translation table, send it to me on disk
  331. or via eMail, *don't compile the catalog on your own!*.
  332.  
  333.  
  334. Operating the program
  335. **********************
  336.  
  337.    `term' can be controlled both by mouse and keyboard. With very few
  338. exceptions each operation requiring mouse control can also be executed
  339. using keyboard shortcuts.
  340.  
  341.    The program can be started both from Workbench and from Shell.
  342. Kickstart 2.04 (revision 37.175) and Workbench 2.04 (revision 37.67) are
  343. required to run `term'.
  344.  
  345.  
  346. Workbench and Shell
  347. ********************
  348.  
  349.    The `behaviour' of `term' can be changed by adding tool type entries
  350. to the corresponding Workbench icon or by specifying additional command
  351. line parameters when running the program from the Shell. Supported
  352. keywords are:
  353.  
  354. `WINDOW'
  355.      The console window specifier to be used when opening terminal
  356.      output windows (this will override the default settings). The
  357.      default is `CON:0/11//100/term Output Window/CLOSE/SCREEN TERM'.
  358.  
  359. `PUBSCREEN'
  360.      The name of a public screen to open the `term' window on. In case
  361.      the public screen happens to be unavailable, `term' will fall back
  362.      to the Workbench screen. Note that `term' assumes that the main
  363.      window is to be opened on a public screen rather than on a custom
  364.      screen if this option is in effect, regardless how the default
  365.      settings may be configured.
  366.  
  367. `STARTUP'
  368.      The name of an ARexx script file to be run on program startup.
  369.  
  370. `PORTNAME'
  371.      The ARexx host port name `term' is to use instead of the built-in
  372.      default name. The port name will be translated to upper case
  373.      characters as required by the ARexx host port naming convention.
  374.      The resulting name must be unique or `term' will fall back to its
  375.      built-in default name.
  376.  
  377. `SETTINGS'
  378.      This keyword determines where to read the default configuration
  379.      file from. In order to read it from `Work:term/config', one would
  380.      use `term Settings Work:term/config' from Shell or add the tooltype
  381.      entry `SETTINGS=Work:term/config' from Workbench. This argument
  382.      does not necessarily give the name of a path to search, but can
  383.      also specify the name of the configuration file to be used.
  384.  
  385. `UNIT'
  386.      Similar to the `DEVICE' keyword the `UNIT' keywords affects the
  387.      serial driver settings. It determines which serial driver unit is
  388.      to be used instead of the one specified in the default
  389.      configuration file. In order to use unit number 4 one would use
  390.      `term Unit 4' from Shell or add the tooltype entry `UNIT=4' from
  391.      Workbench.
  392.  
  393. `DEVICE'
  394.      In order to use a different serial device driver than the one
  395.      specified in the default configuration file, use this keyword. To
  396.      use `duart.device' one would use `term Device duart.device' from
  397.      Shell or add the tooltype entry `DEVICE=duart.device' from
  398.      Workbench.
  399.  
  400. `QUIET'
  401.      If this parameter is present, the program will not start opening a
  402.      display but rather put an icon on the Workbench backdrop, waiting
  403.      to be invoked. A double-click will bring it to life. This
  404.      parameter will be ignored in case the `STARTUP'-Parameter is used
  405.      along with it.
  406.  
  407. `SYNC (Shell only)'
  408.      If called from Shell `term' will detach itself immediately
  409.      allowing the Shell window to be closed afterwards. This effect can
  410.      be avoided if `SYNC' is entered in the command line.
  411.  
  412. `NEW (Shell only)'
  413.      Usually, running `term' twice will cause the screen of the other
  414.      program to be popped to the front instead of creating a second
  415.      `term' process. To avoid this effect, enter `NEW' as a calling
  416.      parameter. If called from Workbench, each program will run as a
  417.      separate process.
  418.  
  419.  
  420. Keyboard control
  421. *****************
  422.  
  423.    Starting with revision 2.2 almost any action can be executed both by
  424. mouse and by keyboard. Each element of the user interface in whose
  425. title an underlined character can be found can be controlled or
  426. activated by pressing the corresponding key. If the object in question
  427. is a list view or scroll bar, pressing the key along with a `Shift' key
  428. will scroll the list/bar back and forth. Pressing the `Tab' key will
  429. activate the first string gadget on the screen.
  430.  
  431.  
  432. Screen
  433. *******
  434.  
  435.    Unless configured to open only a simple window on a public screen the
  436. `term' main screen will alway open to the full text-overscan size (which
  437. can be set using the `Overscan' tool in the `Prefs' drawer).
  438.  
  439.    At the bottom of the screen a small window displays a few basic
  440. parameters. These are:
  441.  
  442. `Status'
  443.      The current program operating status. This includes `Ready',
  444.      `Holding' (`Control + S' was pressed), `Dialing' (the dialing
  445.      function is at work), `Upload' (data is being sent), `Download'
  446.      (data is being received), `Breaking' (a break signal is
  447.      transmitted across the serial line) and `Hanging up' (connection
  448.      is being cancelled).
  449.  
  450. `Font'
  451.      The currently active screen font used for text/graphics rendering.
  452.  
  453. `Protocol'
  454.      The currently set data transfer protocol.
  455.  
  456. `Emulation'
  457.      The currently active terminal emulation mode.
  458.  
  459. `Baud rate'
  460.      The data transfer rate in bits per second.
  461.  
  462. `Parameters'
  463.      The current serial parameters (Data bits-Parity-Stop bits).
  464.  
  465. `Time'
  466.      The current time of day.
  467.  
  468. `Online'
  469.      The time elapsed after a connection was successfully established.
  470.      This counter will be stopped as soon as the connection is
  471.      cancelled (e.g. by hanging up) and is reset to 00:00:00 as soon as
  472.      a new connection is made.
  473.  
  474.      Every five seconds the time display will change to a calling fee
  475.      display and the other way round.
  476.  
  477.    The screen itself is opened as a public screen (called `TERM') which
  478. is available to other programs for their purposes. If more than one
  479. `term' process is running, the public screen name will change according
  480. to the number of the program (i.e. the first `term' to be started will
  481. call the scren `TERM', the second one will call it `TERM.1', the third
  482. one `TERM.2', etc.). The screen title bar will also display the name of
  483. the public screen.
  484.  
  485.  
  486. Menus
  487. ******
  488.  
  489.    For each requester and input window there exists a set of menu items
  490. to execute the commands associated with the buttons, dials and gauges in
  491. the requester/window. Press the right mouse button to have a look at
  492. the commands and their shortcuts.
  493.  
  494.    The following text is to describe the menu items available in the
  495. `term' main menu.
  496.  
  497.  
  498. Project
  499. ========
  500.  
  501. `Save screen as Picture/Text'
  502.      This menu serves to save the current terminal window contents
  503.      either as plain ASCII text file or as a picture file.
  504.  
  505. `Print Screen/Clipboard'
  506.      These menu entries are to output text on the printer. You can
  507.      either print the contents of the main screen or the contents of
  508.      the clipboard.
  509.  
  510. `Capture to File/Printer'
  511.      Selecting one of these menu entries will toggle capturing incoming
  512.      text to the printer and/or a file on disk.
  513.  
  514. `Iconify'
  515.      Closes all screens and windows `term' has currently open, resets
  516.      and releases the serial driver and puts an icon into the Workbench
  517.      window. Double-clicking this icon will cause `term' to wake up and
  518.      to return the state is was in before iconification took place.
  519.  
  520.      *While `term' is iconified, most incoming ARexx-commands will be
  521.      queued and the corresponding ARexx programs will appear to `hang'.
  522.      In order to reactivate the program either double-click on the
  523.      program icon or send the ARexx command `ACTIVATE'. As soon as
  524.      `term' is `awake' again pending commands will be processed again*
  525.  
  526. `About'
  527.      Shows some information on the program.
  528.  
  529. `Quit'
  530.      Terminates the program, hold down a `Shift' key to quit
  531.      immediately, otherwise you will be prompted to confirm your
  532.      decision.
  533.  
  534.    After selecting the `Quit' menu item the program may take a few
  535. seconds to exit since the contents of the Text buffer are freed first.
  536.  
  537.  
  538. Edit
  539. =====
  540.  
  541. `Copy'
  542.      In order to transfer any currently marked screen text to the
  543.      clipboard buffer, select this menu item. Text can be marked by
  544.      double-clicking the select button while the mouse is over a word
  545.      or by clicking the select button and dragging the mouse. Holding
  546.      down either shift key will append the selected text to the current
  547.      clipboard contents. In any other case the new text will replace
  548.      the previous contents.
  549.  
  550. `Paste'
  551.      Pastes the contents of the clipboard at the current cursor position
  552.      provided that the clipboard contains text data. Hold down either
  553.      `Shift' key to have `term' include the `Paste prefix' and the
  554.      `Paste suffix' (see Clipboard panel) along with the clipboard
  555.      contents.
  556.  
  557. `Clear'
  558.      Any currently marked text will be released as soon as any rendering
  559.      operations are to be executed in the main window. To release marked
  560.      text manually, select this menu item.
  561.  
  562.  
  563. Commands
  564. =========
  565.  
  566. `Execute AmigaDOS command'
  567.      Enter the command you want to execute and its command line
  568.      arguments here.
  569.  
  570. `Execute ARexx command'
  571.      This function calls the ARexx server to execute a script file. If
  572.      the first input character is a ` or " the input will be considered
  573.      as a small program in a single line. Note that this function will
  574.      not be available if the ARexx server isn't running.
  575.  
  576.      The ARexx command set supported by `term' is described in the
  577.      `term' ARexx interface documentation.
  578.  
  579.  
  580. Phone
  581. ======
  582.  
  583. `Phonebook'
  584.      The phonebook is one of the most powerful and complex functions of
  585.      `term' and will be described later in this document (see
  586.      Phonebook).
  587.  
  588. `Redial'
  589.      Dialing list entries which the dialing routine was unable to
  590.      establish a connection to are once again passed to the dialer.
  591.  
  592. `Dial'
  593.      To dial a single phone number select this menu item. The phone
  594.      number entered will be passed to the dialing routine.
  595.  
  596. `Send break'
  597.      Sends a `break' signal across the serial line.
  598.  
  599. `Hang up'
  600.      Tells the modem to hang up the serial line.
  601.  
  602. `Wait...'
  603.      Will cause `term' to emit the character sequence `<Blank
  604.      space><Backspace>' every second in order to fool the remote into
  605.      believing that terminal input is currently taking place.
  606.  
  607. `Flush receive buffer'
  608.      Tells the serial driver to drop its input buffer contents and
  609.      resets the state of the internal serial buffers.
  610.  
  611. `Release serial device'
  612.      The serial driver is released for other programs to use it. A
  613.      requester will appear which allows you to reopen the serial driver
  614.      or to quit `term'.
  615.  
  616.      If the serial driver has been released by the ARexx interface and
  617.      has not been reopened yet, this menu item will do it.
  618.  
  619.    If you are still online, the `Redial' and `Dial' menu entries will be
  620. disabled. In order to make another call, hang up the line first.
  621.  
  622.  
  623. Transfer
  624. =========
  625.  
  626. `Upload ASCII file(s)'
  627.      This is a pure ASCII-file upload implemented through
  628.      `xprascii.library'. It was added to allow poor BBS programs to
  629.      receive text files (especially Paragon doesn't seem to like ZModem
  630.      text file upload).
  631.  
  632. `Download ASCII file(s)'
  633.      This is a pure ASCII-file download implemented through
  634.      `xprascii.library'. Refer to `Upload ASCII file(s)' for
  635.      features/options of this mode.
  636.  
  637. `Upload text file(s)'
  638.      Sends a file/files to the remote receiver using the current
  639.      transfer protocol. If possible this command will `ask' the
  640.      transfer protocol to transmit the file(s) in text mode (whatever
  641.      that means) which may include CR/LF substitution and other
  642.      gimmicks. Consult the library documentation to find out if your
  643.      favourite transfer library supports text mode.
  644.  
  645. `Download text file(s)'
  646.      Request a file/files using the current transfer protocol. Refer to
  647.      `Upload text file(s)' for features/options of this mode.
  648.  
  649. `Edit & upload text file'
  650.      Invokes the currently selected (see Path panel) text editor on a
  651.      file to be selected using a file requester.
  652.  
  653.      `term' will block and wait until the editor has returned.
  654.  
  655.      After the editor has returned, the user will be asked whether the
  656.      file edited is to be transferred as plain ASCII or via text upload.
  657.  
  658. `Upload binary file(s)'
  659.      Send a file/files to the remote receiver using the current transfer
  660.      protocol. True batch upload is supported both through wildcard
  661.      expressions (`#?.txt' will send all files whose names end with
  662.      `.txt') or through multiple selection. Refer to the documentation
  663.      of your favourite transfer library to find out if batch file
  664.      transfer is supported.
  665.  
  666. `Download binary file(s)'
  667.      Receive a file/files using the current transfer protocol. If the
  668.      protocol does not support batch download you are required to enter
  669.      the name of the file to be received. Files which remain empty
  670.      after the transfer are deleted automatically.
  671.  
  672.    The transfer routines open an information window in which a number of
  673. transfer parameters are displayed (see Transfer panel).
  674.  
  675.  
  676. Buffer
  677. =======
  678.  
  679. `Clear buffer'
  680.      Clears the contents of the Text buffer. Any text will be discarded
  681.      and *cannot* be recovered. Capture files are not affected by this
  682.      command.
  683.  
  684. `Display buffer'
  685.      Opens the Text buffer screen.
  686.  
  687. `Close buffer'
  688.      Closes the Text buffer screen but does not free the contents.
  689.  
  690. `Freeze buffer'
  691.      This menu entry will, if enabled, stop the Text buffer from
  692.      filling up with new text.
  693.  
  694. `Open buffer...'
  695.      Loads the contents of the Text buffer from a file. If there are
  696.      still text lines in the Text buffer a requester will appear giving
  697.      you the choice to discard the old data, append the new data, or to
  698.      cancel the action.
  699.  
  700. `Save buffer as...'
  701.      Saves the contents of the Text buffer to a file. You will be
  702.      notified if the file to save to exists already (you may discard
  703.      the old file, append the new data or cancel the action).
  704.  
  705.    More detailed information on the Text buffer will be given later in
  706. this document.
  707.  
  708.  
  709. Terminal
  710. =========
  711.  
  712. `Clear screen'
  713.      Clears the whole `term' screen and moves the cursor to the top
  714.      left home position.
  715.  
  716. `Reset font'
  717.      Will change the screen font back to the default screen font.
  718.  
  719. `Reset styles'
  720.      Resets all character style attributes (bold, blinking, inverse
  721.      video, underlined, etc.) and sets the text colour to the default
  722.      pen.
  723.  
  724. `Reset terminal'
  725.      Use this menu item to reset the state of the entire terminal
  726.      emulation.
  727.  
  728.  
  729. Settings
  730. =========
  731.  
  732.    This is where you adjust the program preferences settings. There is a
  733. difference between local and global settings:  local settings can also
  734. be set by making a connection to a mailbox while global settings are
  735. kept even while local settings are active. They have to be changed
  736. explicitely.
  737.  
  738. `Serial...'
  739.      See Serial panel
  740.  
  741. `Modem...'
  742.      See Modem panel.
  743.  
  744. `Screen...'
  745.      See Screen panel.
  746.  
  747. `Terminal...'
  748.      See Terminal panel.
  749.  
  750. `Emulation...'
  751.      See Emulation panel.
  752.  
  753. `Clipboard...'
  754.      See Clipboard panel.
  755.  
  756. `Capture...'
  757.      See Capture panel.
  758.  
  759. `Commands...'
  760.      See Command panel.
  761.  
  762. `Miscellaneous...'
  763.      See Miscellaneous panel.
  764.  
  765. `Paths...'
  766.      See Path panel.
  767.  
  768. `Transfer protocol...'
  769.      This command allows you to specify the transfer protocol library
  770.      to be employed for up-/downloads.
  771.  
  772. `Transfer...'
  773.      The transfer options can be changed with this command. If possible
  774.      a control panel will pop up which allows you to change the current
  775.      parameters by mouse/keyboard. If the selected transfer protocol
  776.      does not provide these option hooks, a simple string requester
  777.      will prompt for input. Consult the documentation of your favourite
  778.      transfer protocol for legal options and the values to which they
  779.      can be set.
  780.  
  781. `Translation tables...'
  782.      See Translation panel.
  783.  
  784. `Function keys...'
  785.      See Function key panel.
  786.  
  787. `Fast! macros...'
  788.      See Fast macro panel.
  789.  
  790. `Hotkeys...'
  791.      See Hotkey panel.
  792.  
  793. `Speech...'
  794.      See Speech panel.
  795.  
  796. `Sound...'
  797.      See Sound panel.
  798.  
  799. `Console window...'
  800.      Whenever an AmigaDOS/ARexx command is executed an output window is
  801.      opened. This menu item will bring up a requester allowing you to
  802.      edit the size and position of the window to be opened (consult
  803.      your AmigaDOS manual for a description of the window position
  804.      string). If you do not want the window to appear, simply enter
  805.      `NIL:'.
  806.  
  807.  
  808. Windows
  809. ========
  810.  
  811. `Status'
  812.      This function opens a window to display program status information.
  813.      Click the window to update the information:
  814.  
  815.     `Session start'
  816.           When was the program started?
  817.  
  818.     `Bytes received'
  819.           The number of bytes received.
  820.  
  821.     `Bytes sent'
  822.           The number of bytes sent.
  823.  
  824.     `Connection message'
  825.           The string returned by the modem when a connection was made.
  826.  
  827.     `BBS name'
  828.           If available, the name of the BBS the modem is currently
  829.           connected to.
  830.  
  831.     `BBS phone number'
  832.           If available, the phone number of the BBS the modem is
  833.           currently connected to.
  834.  
  835.     `BBS comment'
  836.           If available, the phone book comment corresponding to the BBS
  837.           the modem is currently connected to.
  838.  
  839.     `BBS user name'
  840.           If available, the user name, as available through the phone
  841.           book, corresponding to the BBS the modem is currently
  842.           connected to.
  843.  
  844.     `Screen size'
  845.           The size of the terminal output window in characters (columns
  846.           / rows).
  847.  
  848.     `ARexx port name'
  849.           If available, the name of the ARexx host `term' is currently
  850.           using.
  851.  
  852.     `Buffer size (bytes)'
  853.           The size of the Text buffer.
  854.  
  855.     `Free memory (bytes)'
  856.           The amount of free system memory.
  857.  
  858. `Review'
  859.      A review window is opened which basically displays the same text
  860.      as the text buffer screen. You can scroll through the text
  861.      displayed both by mouse (see the right hand side scroller) and by
  862.      cursor keys.
  863.  
  864. `Packet'
  865.      Opens an input window in which a single line of characters to be
  866.      transferred across the serial line can be entered. More on this
  867.      feature is explained under Packet window below.
  868.  
  869. `Fast! macros'
  870.      Opens or closes the so-called Fast macro panel. The role of the
  871.      Fast! macros will be discussed later in this text.
  872.  
  873.  
  874. The quick dialing menu
  875. =======================
  876.  
  877.    Note: this menu is available only in case any phone book entries have
  878. the special `Quick menu' switch set.
  879.  
  880.    Selecting any item of this menu will cause the corresponding phone
  881. number to be dialled.
  882.  
  883.  
  884. Control panels
  885. ***************
  886.  
  887.    This where all the control panels employed by `term' are explained:
  888.  
  889.  
  890. Serial panel
  891. =============
  892.  
  893.    This is where the serial parameters may be changed.
  894.  
  895. `Baud rate'
  896.      Transfer speed in bits per second.
  897.  
  898. `Bits/char'
  899.      Number of bits per transferred character (7 or 8).
  900.  
  901. `Parity'
  902.      Serial parity (none, odd, even, mark or space).
  903.  
  904. `Stop bits'
  905.      Number of stop bits (1 or 2).
  906.  
  907. `Handshaking'
  908.      Serial handshaking mode (RTS/CTS, RTS/CTS with DRS signal check,
  909.      none).
  910.  
  911. `Duplex'
  912.      Determines whether characters are echoed back to the terminal
  913.      screen or not (full, half = local echo).
  914.  
  915. `Buffer size'
  916.      The number to be specified here allows to set the serial driver I/O
  917.      buffer size. *Every number you enter here will result in `term'
  918.      and the serial driver allocating twice the buffer size (this is
  919.      only a word of warning for those among us who prefer buffer sizes
  920.      of 256K and up).*
  921.  
  922. `Break length'
  923.      Length of the break signal given in microseconds.
  924.  
  925. `Strip bit 8'
  926.      For those guys and gals who need it:  if this switch is effect each
  927.      character received or transmitted by `term' will have its
  928.      high-order bit cleared.
  929.  
  930. `High-speed mode'
  931.      Activates a special mode of the serial driver which is to skip a
  932.      couple of internal parity and stop bits checks resulting in higher
  933.      data throughput rate. *If this switch is turned on, the serial
  934.      parameters will be reset to 8 bits per char, no parity and 1 stop
  935.      bit.*
  936.  
  937. `Check carrier'
  938.      `term' will recognize the `NO CARRIER' message a modem emits when
  939.      the carrier line signal drops back to low. For maximum safety,
  940.      `term' will also check the carrier signal line after receiving the
  941.      `NO CARRIER' message if this switch is enabled. This is to make
  942.      sure that no accidentally appearing string causes confusion.
  943.  
  944.      If this switch is enabled, `term' will check the carrier signal
  945.      during file transfers and will abort the transfer if the signal is
  946.      lost.
  947.  
  948.      *Note:  Be sure to switch this feature off in case you wish to
  949.      transfer files using a null-modem cable!*
  950.  
  951. `Shared access'
  952.      Requested by many (two to be accurate) users, this switch allows
  953.      you to run the serial driver in shared access mode. Not all driver
  954.      types will allow this to happen.
  955.  
  956. `xON/xOFF'
  957.      This switch enables the processing of the flow-control characters
  958.      `xON' (= `Control + S') and `xOFF' (= `Control + Q').
  959.  
  960. `Pass ^S/^Q through'
  961.      If this switch is enabled, `term' will pass the `xON'/`xOFF'
  962.      characters through to the modem rather than swallowing them.
  963.  
  964. `Serial device'
  965.      The name of the serial driver to be used by `term'. This is usually
  966.      `serial.device' (`modem?.device' for the internal Supra modem,
  967.      `sxbios.device' for ASDG's serial IO card).
  968.  
  969. `Device unit number'
  970.      The device unit number of the serial driver selected above. This is
  971.      usually left `0' but can also be used to address multiple serial IO
  972.      ports.
  973.  
  974. `Use'
  975.      Accept the current settings.
  976.  
  977. `Default (phone book only)'
  978.      Drop the current settings, making a connection to the corresponding
  979.      phone number will leave the corresponding main configuration entry
  980.      unchanged.
  981.  
  982. `Cancel'
  983.      Don't use the current settings.
  984.  
  985.    Most modems will not recognize a sudden change in the baud rate. Type
  986. `AT<RETURN>' to make the change known.
  987.  
  988.    If `RTS/CTS (DSR)' handshaking is selected, `term' will check to see
  989. if the `Data set ready' line happens to be high active. If not, it will
  990. default back to software handshaking (`xON'/`xOFF'). The `RTS/CTS'
  991. handshaking mode will ignore the presence or absence of the `DSR'
  992. signal.
  993.  
  994.    `term' will take advantage of Christopher Whichura's
  995. `OwnDevUnit.library' if installed in your system, allowing controlled
  996. access to the serial driver's resources.
  997.  
  998.  
  999. Modem panel
  1000. ============
  1001.  
  1002.    This is where modem control strings and other related parameters are
  1003. configured.
  1004.  
  1005. `Modem init command'
  1006.      The string to send to the modem after successful program
  1007.      initialization. This string is optional and does not need to be
  1008.      entered.
  1009.  
  1010.      The dialing routine will use the initialization string entered here
  1011.      before dialing a phone number.
  1012.  
  1013. `Modem exit command'
  1014.      The string to be sent to the modem shortly before the program
  1015.      terminates. Just like the modem init string this string is
  1016.      optional and does not need to be entered.
  1017.  
  1018.      The dialing routine will use the initialization string entered here
  1019.      before dialing the next telephone number.
  1020.  
  1021. `Hangup command'
  1022.      The string to be sent to the modem when asked to hang up the line.
  1023.      This string does have to be present if the `Drop DTR on hangup'
  1024.      switch is enabled.
  1025.  
  1026. `Dial prefix'
  1027.      The string to be used to prefix each dialing command. This is
  1028.      usually a variant of `ATDP' or `ATDT'.
  1029.  
  1030. `Dial suffix'
  1031.      The string to be used to append to each dialing command. This is
  1032.      usually the carriage-return character `\r'.
  1033.  
  1034. ``No carrier' message'
  1035.      The message the modem emits if the data carrier is lost. The
  1036.      program uses this to determine the length of the connection and to
  1037.      calculate the how much the user is to pay for it.
  1038.  
  1039. ``Connect' message'
  1040.      The message the modem emits after detecting a carrier signal.
  1041.      `term' uses this input to determine successful telephone
  1042.      connection, to reconfigure itself and to start the online timer.
  1043.  
  1044. ``No dialtone' message'
  1045.      The message to be returned by the modem in case it does not
  1046.      encounter any dialing tone on the phone line.
  1047.  
  1048. ``Voice' message'
  1049.      The message `term' is expected to receive if the modem detects a
  1050.      voice call. If in dialing mode, `term' will abort the process. The
  1051.      user will in any case be notified of the event.
  1052.  
  1053. ``Ring' message'
  1054.      The message the modem emits if it receives a call, same effects as
  1055.      with the `Voice message'.
  1056.  
  1057. ``Busy' message'
  1058.      The message the modem returns if the number which has just been
  1059.      dialed is busy.
  1060.  
  1061. ``Ok' message'
  1062.      The message the modem returns if a command was successfully
  1063.      executed.
  1064.  
  1065. ``Error' message'
  1066.      The message the modem returns if a command was not to be executed
  1067.      successfully.
  1068.  
  1069. `Redial delay'
  1070.      The time to wait after walking through the whole dialing list
  1071.      without making any successful connection before another attempt is
  1072.      started.
  1073.  
  1074. `Number of dial retries'
  1075.      The number of times the dialer walks through the dialing list
  1076.      trying to make a successful connection before giving up.
  1077.  
  1078. `Dial timeout'
  1079.      The time to wait for a successful connection during dialing. After
  1080.      this time has elapsed, the dialer will skip to the next entry in
  1081.      the list.
  1082.  
  1083. `Redial after hanging up'
  1084.      If this switch is in effect, `term' will redial all the phone
  1085.      numbers still in the dialing list as soon as the line is hung up
  1086.      or the carrier signal is lost.
  1087.  
  1088. `Connect auto-baud'
  1089.      Most modems echo the baud rate upon successful connection. If
  1090.      enabled the baud rate will be read and set for the serial driver.
  1091.  
  1092.      *Use this feature with care as it may have certain negative
  1093.      side-effects (such as the modem dropping the line just after
  1094.      connecting to a BBS)! If you happen to use a modern high-speed
  1095.      modem you will most certainly no need this feature. If in doubt
  1096.      whether you need to enable this feature you should rather disable
  1097.      it!*
  1098.  
  1099. `Drop DTR on hangup'
  1100.      Some modems will track the `data terminal ready' line in order to
  1101.      make sure that the terminal program is listening, once the line
  1102.      goes back to low potential, these modems will drop the line and
  1103.      hang up. Use this button to enable this feature.
  1104.  
  1105. ``NO CARRIER' = `BUSY''
  1106.      If this switch is in effect, the dialing function will treat the
  1107.      modem response code `NO CARRIER' exactly as the `BUSY' response
  1108.      code.
  1109.  
  1110. `Connect limit'
  1111.      This gauge is to set a certain period of time to be counted after
  1112.      a connection is made. When elapsed, a control sequence will be
  1113.      executed as to be set using the `Limit macro' settings. If set to
  1114.      `0:00' this function will be disabled.
  1115.  
  1116. `Limit macro'
  1117.      A control sequence to be triggered when the time to be set using
  1118.      the `Connect limit' gauge has elapsed. If no text is entered this
  1119.      function will be disabled.
  1120.  
  1121. `Use'
  1122.      Use the current settings.
  1123.  
  1124. `Default (phone book only)'
  1125.      Drop the current settings, making a connection to the corresponding
  1126.      phone number will leave the corresponding main configuration entry
  1127.      unchanged.
  1128.  
  1129. `Cancel'
  1130.      Keep original settings.
  1131.  
  1132.  
  1133. Screen panel
  1134. =============
  1135.  
  1136. `Display modes'
  1137.      All display modes available for the main screen are displayed here.
  1138.  
  1139.      *The A2024-modes should only be used in connection with an
  1140.      A2024/Hedley-monitor. Otherwise the screen may `crash' and working
  1141.      with `term' will not be possible any longer.*
  1142.  
  1143. `Colour'
  1144.      This button determines the colour-mode the terminal emulation is
  1145.      going to use. Until now, three modes have been implemented:
  1146.  
  1147.     `4 Colours (Amiga)'
  1148.           Four colours, optionally blinking.
  1149.  
  1150.     `8 Colours (ANSI)'
  1151.           Eight colours, optionally blinking.
  1152.  
  1153.     `16 Colours (EGA)'
  1154.           Sixteen colours, as the EGA-palette.
  1155.  
  1156.     `2 Colours (Monochrome)'
  1157.           Monochrome, two colours.
  1158.  
  1159. `Palette'
  1160.      These buttons are used to select a colour of the screen palette
  1161.      that is to be changed.
  1162.  
  1163. `Red/Green/Blue'
  1164.      Use these sliders to modify the red, green and blue components of
  1165.      the currently active colour.
  1166.  
  1167. `Use default colours'
  1168.      Press this button to have the current colour palette set to the
  1169.      built-in default colours.
  1170.  
  1171. `Screen font'
  1172.      The name of the current user-interface font is displayed here.
  1173.  
  1174. `Select new screen font'
  1175.      Press this button to select a new font to be used for the
  1176.      user-interface design.
  1177.  
  1178. `Make screen public'
  1179.      As dealt with before, the `term' mainscreen is opened as `public'.
  1180.      With this button the user may define if other applications are
  1181.      allowed to open up their windows on the `term' screen.
  1182.  
  1183. ``Shanghai' windows'
  1184.      This item, which is only displayed if `Make screen public' has been
  1185.      selected, is closely related to the function before. If active, all
  1186.      windows that will normally be displayed on the Workbench screen
  1187.      will open on the `term' main screen.
  1188.  
  1189. `Blinking'
  1190.      If selected the VT100-blink option is enabled. If running in eight
  1191.      colour mode, `term' will only use three bitplanes instead of four
  1192.      for text display.
  1193.  
  1194. `Faster layout'
  1195.      Activating this switch will slow down display updates and window
  1196.      management. Oh well, not always, there may be a speed increase with
  1197.      some configurations, such as with external emulations activated or
  1198.      when using more than four colours on the screen.
  1199.  
  1200.      I suggest to experiment with the effects of this button before
  1201.      actually using it.
  1202.  
  1203. `Screen title'
  1204.      If this button is enabled, the `term' screen will contain a
  1205.      draggable title bar, if not, the title bar will be disabled,
  1206.      leaving more space for the terminal output window.
  1207.  
  1208. `Use public screen'
  1209.      `term' does not necessarily open a custom screen, this switch will
  1210.      make the main and auxilary windows appear on a named public
  1211.      screen. `term' will try to adapt colours and text rendering modes
  1212.      to its new environment. It will share the screen palette with
  1213.      other applications which makes it possible to run the built-in
  1214.      terminal emulation in eight or sixteen colours provided that
  1215.      enough shareable screen pens are available (note:  Kickstart 3.0
  1216.      required). `term' will inherit the text font to be used for
  1217.      user-interface layout from the public screen it will open its
  1218.      window on. As of Kickstart 2.04 `term' will fall back to opening a
  1219.      custom screen in case the public screen text font happens to be
  1220.      proportional-spaced.
  1221.  
  1222.      *Note:  only the built-in terminal emulation is guaranteed to take
  1223.      advantage of pen-sharing facilities, external emulation libraries
  1224.      will most likely fail to display text correctly!*
  1225.  
  1226.      Take care when resizing the `term' main window as a size change
  1227.      will reset the terminal emulation.
  1228.  
  1229. `Public screen name'
  1230.      The name of the public screen `term' is to open windows on. `term'
  1231.      will fall back to the Workbench screen if no proper name is given
  1232.      (i.e. no name is entered) or the desired screen is unavailable.
  1233.  
  1234. `Status line'
  1235.      This switch allows to disable the status line display or to change
  1236.      between two alternative status line displays:
  1237.  
  1238.     `Disabled'
  1239.           No status line is displayed.
  1240.  
  1241.     `Standard'
  1242.           The standard two status lines are displayed.
  1243.  
  1244.     `Compact'
  1245.           A very condensed version of the status line is displayed,
  1246.           only the data is shown but no captions. The data is displayed
  1247.           in the following order:
  1248.  
  1249.             1. Status
  1250.  
  1251.             2. Terminal type
  1252.  
  1253.             3. Transfer protocol
  1254.  
  1255.             4. Baud rate
  1256.  
  1257.             5. Serial parameters
  1258.  
  1259.             6. Time of day
  1260.  
  1261.             7. Online time
  1262.  
  1263. `Online display'
  1264.      This switch determines what type of information is to be displayed
  1265.      in the bottom right corner of the status display:
  1266.  
  1267.     `Online time'
  1268.           The time online
  1269.  
  1270.     `Online cost'
  1271.           The amount of money to be paid for the connection
  1272.  
  1273.     `Time & cost'
  1274.           Both time and money, the display will toggle between both of
  1275.           them every five seconds.
  1276.  
  1277. `Use'
  1278.      Use the current settings.
  1279.  
  1280. `Default (phone book only)'
  1281.      Drop the current settings, making a connection to the corresponding
  1282.      phone number will leave the corresponding main configuration entry
  1283.      unchanged.
  1284.  
  1285. `Cancel'
  1286.      Keep the old settings.
  1287.  
  1288.    Some display modes (such as Super-Hires, Productivity, etc.) restrict
  1289. the number of screen colours on ECS machines. Instead of 16 bit
  1290. portions for red, green and blue only 2-bit portions are used which
  1291. leads to a maximum width of the palette of at all 64 colours. This is
  1292. not a `feature' of `term', but a hardware restriction.
  1293.  
  1294.  
  1295. Terminal panel
  1296. ===============
  1297.  
  1298.    All settings that may be done here determine the behaviour of the
  1299. terminal itself, i.e. how command sequences are interpreted and
  1300. displayed.
  1301.  
  1302. `Bell'
  1303.      This is where you select the action(s) `term' is to take whenever a
  1304.      `bell' character turns up in the data stream:
  1305.  
  1306.     `Visual'
  1307.           The screen will flash.
  1308.  
  1309.     `Audible'
  1310.           An audible signal will be generated.
  1311.  
  1312.     `Visual & audible'
  1313.           A combination of both effects.
  1314.  
  1315.     `Ignore'
  1316.           Nothing will happen.
  1317.  
  1318.     `System default'
  1319.           The system beep routines will be used.
  1320.  
  1321. `Alert'
  1322.      `term' notifies the user of certain events, such as a connection
  1323.      being established or a file transfer action which has just been
  1324.      finished. This switch allows you to select the type of
  1325.      notification:
  1326.  
  1327.     `Bell'
  1328.           A bell signal will be given.
  1329.  
  1330.     `Screen'
  1331.           The `term' screen will be brought to the front.
  1332.  
  1333.     `Bell/Screen'
  1334.           A combination of the two actions above.
  1335.  
  1336.     `None'
  1337.           Nothing will happen.
  1338.  
  1339. `Emulation'
  1340.      At this point the user may select the terminal emulation. First
  1341.      there is a solid VT102/VT220/ANSI emulation which supports all
  1342.      common commandsequences, then there is a so called `Atomic'
  1343.      emulation which does only support the very basic command-sequences
  1344.      (CR, LF, Backspace, etc.), all VT102- and ANSI-command-sequences
  1345.      are suppressed, and, last but not least, a `TTY'-emulation which
  1346.      does not suppress all command-sequences, as `Atomic' does, but
  1347.      rather echoes them to the screen.
  1348.  
  1349.      In addition to the built-in terminal emulation, `term' also
  1350.      supports external terminal emulations. To select one, set the
  1351.      terminal emulation type to `External' and enter the name of the
  1352.      emulation in the string gadget below (the file may alternatively
  1353.      selected by hitting the `Select new emulation' button). In case
  1354.      anything goes wrong loading or initializing the terminal emulation
  1355.      library, `term' will switch back to the built-in `ANSI/VT'
  1356.      emulation.
  1357.  
  1358.      If in hex-mode the program will display all incoming characters in
  1359.      a special notation. The left hand screen side will show the
  1360.      character code in hexadecimal notation, the right hand side will
  1361.      -- if possible -- display the character as a glyph.
  1362.  
  1363. `Emulation name'
  1364.      The name of an external terminal emulation library to be used by
  1365.      `term' instead of the built-in emulation code.
  1366.  
  1367. `Font'
  1368.      Here the type of the font to be used for text display in the
  1369.      terminal window can be selected:
  1370.  
  1371.     `Standard'
  1372.           The standard text font.
  1373.  
  1374.     `IBM-PC style'
  1375.           A font similar to the IBM-PC text font will be used. *This
  1376.           requires the `IBM.font' to be present in the `Fonts:'
  1377.           directory.* No matter how the translation tables (see
  1378.           Translation panel) are configured, outgoing Amiga characters
  1379.           are translated into PC character values.
  1380.  
  1381.     `IBM-PC style (raw)'
  1382.           This selection has very much the same effect as `IBM-PC
  1383.           style' but no character translation is involved.
  1384.  
  1385. `Text font'
  1386.      Here the name of the standard terminal window text font is
  1387.      displayed.
  1388.  
  1389. `Select new text font'
  1390.      Press this button to select a new terminal window text font.
  1391.  
  1392. `Send CR'
  1393.      This button determines the sequence that is sent to the remote if a
  1394.      carriage-return is issued.
  1395.  
  1396.     `As CR'
  1397.           Without any change
  1398.  
  1399.     `As CR+LF'
  1400.           Carriage-return and linefeed
  1401.  
  1402.     `Ignore'
  1403.           Suppress any carriage-return
  1404.  
  1405. `Send LF'
  1406.      This button determines the sequence that is sent to the remote if a
  1407.      linefeed is issued.
  1408.  
  1409.     `As LF'
  1410.           Without any change
  1411.  
  1412.     `As LF+CR'
  1413.           Linefeed and carriage-return
  1414.  
  1415.     `Ignore'
  1416.           Suppress any linefeed
  1417.  
  1418. `Receive CR'
  1419. `Receive LF'
  1420.      These two buttons have largely the same effect as the `Send CR/LF'
  1421.      buttons, they are different in that they affect the incoming data
  1422.      rather than the data transmitted.
  1423.  
  1424. `Columns'
  1425.      The number of columns to use for the terminal window. The minimum
  1426.      value is 20 columns, the maximum value is defined by the actual
  1427.      screen size.
  1428.  
  1429. `Lines'
  1430.      The number of lines to use for the terminal window. The minimum
  1431.      value is 20 lines, the maximum value is defined by the actual
  1432.      screen size.
  1433.  
  1434. `Keymap file'
  1435.      If your installation requires that `term' is to use a custom keymap
  1436.      layout, enter the keymap file name here.
  1437.  
  1438.      *At the time of this writing the program will not support custom
  1439.      keymap layouts with the Packet window due to operating system
  1440.      limitations.*
  1441.  
  1442. `Use'
  1443.      Use the current settings.
  1444.  
  1445. `Default (phone book only)'
  1446.      Drop the current settings, making a connection to the corresponding
  1447.      phone number will leave the corresponding main configuration entry
  1448.      unchanged.
  1449.  
  1450. `Cancel'
  1451.      Keep the old settings.
  1452.  
  1453.  
  1454. Emulation panel
  1455. ================
  1456.  
  1457.    The buttons found here allow you to change the internal parameters of
  1458. the selected emulation.
  1459.  
  1460.    The following text only describes the parameters to change when using
  1461. the built-in terminal emulation; if an external terminal emulation is in
  1462. effect, this menu will conjure up the corresponding parameters menu
  1463. supported by the external terminal emulation module.
  1464.  
  1465. `Cursor keys'
  1466.      If this mode is active the cursor keys transmit a command-sequence
  1467.      instead of a cursor move event. If the remote computer needs these
  1468.      sequences, this mode -- applications mode -- can be activated with
  1469.      this button.
  1470.  
  1471. `Numeric keypad'
  1472.      If this mode is activated the keys of the numeric keypad transmit a
  1473.      command-sequence instead of a number. If the remote computer needs
  1474.      these sequences, this mode -- applications mode -- can be
  1475.      activated with this button.
  1476.  
  1477. `Wrap cursor moves'
  1478.      According to the VT100-specification the cursor movements have to
  1479.      stop at the edges of the screen. In spite of this the cursor may
  1480.      leave these borders, especially in ANSI-mode, and may appear at
  1481.      the other side of the screen. This button activates a more
  1482.      `tolerant' mode.
  1483.  
  1484. `Wrap characters'
  1485.      This function activates the automatical carriage return function
  1486.      which is triggered as soon as the cursor crosses the right screen
  1487.      margin. To avoid unpleasant side-effects, this gadget should be
  1488.      activated all the time.
  1489.  
  1490. `Insert mode'
  1491.      Normally, `term' is in overwrite-mode (characters entered
  1492.      overwrite the contents of the screen). If this gadget is
  1493.      activated, typed characters are inserted by pushing all the
  1494.      characters right of the cursor towards the right margin.
  1495.  
  1496.      *The insert-mode does only work for lines. If characters are
  1497.      pushed out of the screen they cannot be restored.*
  1498.  
  1499. `New-line mode'
  1500.      This gadget activates a special mode in which some
  1501.      VT100-control-sequences cause `term' to perform a linefeed instead
  1502.      of clearing the screen or other serious changes of the contents of
  1503.      the screen.
  1504.  
  1505. `Font scale'
  1506.      VT-100 offers several different sizes of fonts. Some can be
  1507.      selected with this gadget:
  1508.  
  1509.     `Normal'
  1510.           The normal height of the font.
  1511.  
  1512.     `Half width'
  1513.           Half width of font.
  1514.  
  1515. `Scrolling'
  1516.      This button selects one of two different scrolling modes:  smooth
  1517.      or jumping.
  1518.  
  1519. `Destructive backspace'
  1520.      Determines if the `Backspace' code, which will delete the character
  1521.      left from the cursor, only moves the cursor to the left or removes
  1522.      the character from the screen.
  1523.  
  1524. `Swap `Backspace' and `Del' keys'
  1525.      For the die-hard VT100 user:  if this switch is enabled the roles
  1526.      of the backspace key and the delete key are reversed. *This also
  1527.      applies to sequences such as `Control + H' which will produce a
  1528.      delete character instead of a backspace character.*
  1529.  
  1530. `Printer control enabled'
  1531.      `term' supports the standard VT220 printer control commands. If you
  1532.      don't want the application on the other side of the line to play
  1533.      with the printer the printer support commands can be disabled with
  1534.      this switch. If disabled `term' will act like a VT220 terminal
  1535.      with no printer attached.
  1536.  
  1537. `Answerback message'
  1538.      The string to send across the serial line whenever an `ENQ'
  1539.      character is received. The string is -- as usual -- a command
  1540.      sequence.
  1541.  
  1542. `Use'
  1543.      Use the current settings.
  1544.  
  1545. `Default (phone book only)'
  1546.      Drop the current settings, making a connection to the corresponding
  1547.      phone number will leave the corresponding main configuration entry
  1548.      unchanged.
  1549.  
  1550. `Cancel'
  1551.      Keep the old settings.
  1552.  
  1553.  
  1554. Clipboard panel
  1555. ================
  1556.  
  1557. `Clipboard unit'
  1558.      The clipboard supports several units (0-255) which can be accessed
  1559.      independently. It can make sense to change this value but
  1560.      generally you will probably leave it as unit `0'.
  1561.  
  1562. `Character delay'
  1563.      When sending text this number determines how many seconds to wait
  1564.      before sending the next character.
  1565.  
  1566. `Line delay'
  1567.      When sending text this number determines how many seconds to wait
  1568.      before sending the line-termination character (carriage return).
  1569.  
  1570. `Line prompt'
  1571.      The character to wait for the receiver to issue after a line of
  1572.      text is send. These character may include control sequence tokens.
  1573.  
  1574. `Send timeout'
  1575.      If the `Text pacing' mode is set to  `Wait for echo' or `Wait for
  1576.      line prompt' the maximum time to wait for echo/prompt before the
  1577.      insertion is aborted.
  1578.  
  1579. `Text pacing'
  1580.      The mode to determine how text is sent to the remote:
  1581.  
  1582.     `Direct'
  1583.           Each line will be sent without any delay.
  1584.  
  1585.     `Wait for echo'
  1586.           The program will wait for each single character sent to be
  1587.           echoed by the remote.
  1588.  
  1589.     `Wait for any echo'
  1590.           The program will wait for the remote to return any character
  1591.           in response to any character sent. Typically, this is the case
  1592.           with password prompts issued by BBSes.
  1593.  
  1594.     `Wait for line prompt'
  1595.           The program will wait until the remote sends a certain line
  1596.           prompt text.
  1597.  
  1598.     `Character/line delay'
  1599.           The program will respect the character/line delay values to
  1600.           be set using this control panel.
  1601.  
  1602.     `Keyboard delay'
  1603.           The program will send character separated by a delay to be
  1604.           determined by the current system keyboard repeat delay.
  1605.  
  1606.      *Note: the `echo' text pacing mode is to be used with greate care.
  1607.      Certain online services do not echo characters back to the sender
  1608.      as they run only in half-duplex mode. On the other hand most
  1609.      mailbox programs will not echo certain characters, such as escape
  1610.      codes, etc.*
  1611.  
  1612. `Paste prefix'
  1613.      If enabled, the text to send before the clipboard contents are fed
  1614.      into the input stream, see Clipboard.
  1615.  
  1616. `Paste suffix'
  1617.      If enabled, the text to send after the clipboard contents are fed
  1618.      into the input stream, see Clipboard.
  1619.  
  1620. `Use'
  1621.      Use the current settings.
  1622.  
  1623. `Default (phone book only)'
  1624.      Drop the current settings, making a connection to the corresponding
  1625.      phone number will leave the corresponding main configuration entry
  1626.      unchanged.
  1627.  
  1628. `Cancel'
  1629.      Keep the old settings.
  1630.  
  1631.  
  1632. Capture panel
  1633. ==============
  1634.  
  1635. `Log actions'
  1636.      If enabled will write a protocol of each program action (uploads,
  1637.      downloads, dial attempts, etc.) to a file. Each action is listed
  1638.      along with time and date. Carrier-lost events will also note the
  1639.      approximate cost of the call.
  1640.  
  1641. `Log file'
  1642.      The name of the file in which the information on the actions
  1643.      executed by `term' will be logged if `Log actions' is enabled.
  1644.  
  1645. `Log calls'
  1646.      If this switch is enabled, `term' will create call-log files in a
  1647.      format compatible with the `NComm' terminal program.
  1648.  
  1649. `Call log file'
  1650.      The name of the file in which the information on calls made by
  1651.      `term' will be logged if `Log calls' is enabled.
  1652.  
  1653. `Maximum text buffer size'
  1654.      To save memory, a high-water mark concerning the maximum amount of
  1655.      memory the Text buffer will allocate for text may be specified.
  1656.      The minimum value to be entered here is 2,000 bytes which are
  1657.      roughly equivalent to two Text buffer pages of text. A value of 0
  1658.      will cause the Text buffer to always allocate as much memory as
  1659.      required to buffer all the incoming text.
  1660.  
  1661. `Text buffer enabled'
  1662.      This switch works in conjunction with the `Freeze buffer' menu
  1663.      entry (freezing the Text buffer contents). In fact, the menu entry
  1664.      is adjusted according to the configuration settings whenever a new
  1665.      configuration is invoked (that is, whenever a new connection is
  1666.      made through the dialing panel or at program startup time). *`term'
  1667.      will only freeze the buffer if this switch is set, it will leave
  1668.      the buffer state (frozen or not) untouched if this switch is not
  1669.      enabled.*
  1670.  
  1671. `Text buffer file path'
  1672.      The path the file requester will bring up when saving the contents
  1673.      of the text buffer.
  1674.  
  1675. `Connect-auto-capture'
  1676.      If enabled will automatically open a capture file after
  1677.      successfully making a connection. Any other already open capture
  1678.      file will be closed before proceeding. The files created will bear
  1679.      the names of the corresponding phonebook entry, the first line to
  1680.      be written to tell the time and date when the file was opened.
  1681.  
  1682. `Creation date'
  1683.      By default `term' will append the date of the call made to the
  1684.      name of the auto-capture file created. Alternatively, `term' will
  1685.      use only the BBS name for auto-capture files, including creation
  1686.      date lines in the file.
  1687.  
  1688. `Capture filter enabled'
  1689.      If selected, command sequences are filtered out before the incoming
  1690.      characters are captured to disk or printer.
  1691.  
  1692. `Capture file path'
  1693.      This string gadget contain the path in which the the capture files
  1694.      will be created if `Connect-auto-capture' is enabled.
  1695.  
  1696. `Use'
  1697.      Use the current settings.
  1698.  
  1699. `Default (phone book only)'
  1700.      Drop the current settings, making a connection to the corresponding
  1701.      phone number will leave the corresponding main configuration entry
  1702.      unchanged.
  1703.  
  1704. `Cancel'
  1705.      Keep the old settings.
  1706.  
  1707.  
  1708. Command panel
  1709. ==============
  1710.  
  1711.    Here you will find entries for four command sequences which serve
  1712. four functions:
  1713.  
  1714. `Startup/Login macro'
  1715.      At the beginning of every session with `term' and after a
  1716.      connection has been established by the dialing routine a
  1717.      command-sequence is executed which may execute command-files or
  1718.      perform a automatical `login'.
  1719.  
  1720. `Logoff macro'
  1721.      The macro to execute when the line is hung up or the carrier
  1722.      signal is lost.
  1723.  
  1724. `Upload macro'
  1725.      `term' will execute this macro after a successful upload has been
  1726.      made.
  1727.  
  1728. `Download macro'
  1729.      `term' will execute this macro after a successful download has
  1730.      been made.
  1731.  
  1732. `Use'
  1733.      Use the current settings.
  1734.  
  1735. `Default (phone book only)'
  1736.      Drop the current settings, making a connection to the corresponding
  1737.      phone number will leave the corresponding main configuration entry
  1738.      unchanged.
  1739.  
  1740. `Cancel'
  1741.      Keep the old settings.
  1742.  
  1743.  
  1744. Miscellaneous panel
  1745. ====================
  1746.  
  1747.    This is the place where options can be set which would not fit into
  1748. other control panels
  1749.  
  1750. `Program priority'
  1751.      Use this slider to determine the priority under which the `term'
  1752.      main process is to operate. Adjusting this value can make `term'
  1753.      perform more reliably in a system which experiences heavy task
  1754.      loading. It is recommended to play with this value until a
  1755.      satisfactory state is found, setting the program priority too high
  1756.      or too low may affect the performance of coprocess-services such
  1757.      as the double-buffered file I/O routines.
  1758.  
  1759. `Backup configuration'
  1760.      By default the local program configuration saved along with a
  1761.      phonebook entry will replace the global configuration as soon as a
  1762.      successful connection is made. If this switch is enabled, `term'
  1763.      will remember the global configuration in effect before the
  1764.      configuration data of a phonebook entry is adopted. As soon as the
  1765.      serial driver loses track of the carrier signal or the user
  1766.      chooses to hang up the line, `term' will switch back to the
  1767.      previous global configuration.
  1768.  
  1769. `Show fast! macros'
  1770.      If this switch is enabled, the Fast macro panel will be opened
  1771.      whenever the current configuration becomes active (e.g. at startup
  1772.      time).
  1773.  
  1774. `Release serial device when iconified'
  1775.      By default the serial device driver is released when `term' is
  1776.      iconified. Unfortunately, some modems drop the line when the
  1777.      device is closed so this switch allows you to keep the link.
  1778.  
  1779. `Override transfer path'
  1780.      Each batch file transfer protocol allows you to specify the name
  1781.      of the directory to place the files it receives in. By default
  1782.      `term' will redirect the files to a directory to be specified in
  1783.      the Path panel. If this switch is disabled, the internal settings
  1784.      of the current transfer protocol will be used.
  1785.  
  1786. `Use auto upload panel'
  1787.      Some users found the so-called `ZModem auto-upload panel' to be
  1788.      invoked whenever `term' encounters the ZModem inquiry sequence
  1789.      rather disturbing, this switch will allow them to disable this
  1790.      feature.
  1791.  
  1792. `Set `archived' bit'
  1793.      If enabled, this switch will cause `term' to set the `Archived' bit
  1794.      on files transferred using the XPR-interface.
  1795.  
  1796. `Transfer file icons'
  1797.      This switch works in conjunction with the drag & upload feature
  1798.      (see Transfer panel). By default, `term' will upload only the files
  1799.      whose icons are dragged on the main window, if this switch is in
  1800.      effect the icon files will be transferred as well.
  1801.  
  1802. `Create icons'
  1803.      If this switch is in effect `term' will try to provide icons for
  1804.      all files it receives. The following file types (and the
  1805.      corresponding icon files) are supported:
  1806.  
  1807.     *Text file (icon `ENV:sys/def_text.info')
  1808.     *Sound file (icon `ENV:sys/def_sound.info')
  1809.     *Picture file (icon `ENV:sys/def_picture.info')
  1810.     *Tool (icon `ENV:sys/def_tool.info')
  1811.     *Archive file (icon `ENV:sys/def_archive.info')
  1812.     *Preferences file (icon `ENV:sys/def_pref.info')
  1813.     *Other file types (icon `ENV:sys/def_project.info')
  1814.      Text and pictures saved by the program will also get icons
  1815.      attached.
  1816.  
  1817. `File comment'
  1818.      This is where the action to perform on downloaded files can be set:
  1819.  
  1820.     `Ignore'
  1821.           The file comment will not be touched.
  1822.  
  1823.     `File type'
  1824.           The file will be examined and a guess will be made which type
  1825.           of file it is. The file comment will be set to the name of
  1826.           the file type.
  1827.  
  1828.     `Source and time'
  1829.           The current BBS name and the time the file was received are
  1830.           placed in the file comment.
  1831.  
  1832. `Simple file I/O'
  1833.      This switch controls whether `term' is to use double-buffered file
  1834.      management routines or not.
  1835.  
  1836. `Use'
  1837.      Use the current settings.
  1838.  
  1839. `Default (phone book only)'
  1840.      Drop the current settings, making a connection to the corresponding
  1841.      phone number will leave the corresponding main configuration entry
  1842.      unchanged.
  1843.  
  1844. `Cancel'
  1845.      Keep the old settings.
  1846.  
  1847.  
  1848. Path panel
  1849. ===========
  1850.  
  1851.    In this part of the settings all paths, which `term' uses to save or
  1852. load any data, can be determined.
  1853.  
  1854. `...Uploadpath'
  1855. `...Downloadpath'
  1856.      The directories in which the functions contained in the `Transfer'
  1857.      menu will search and create files.
  1858.  
  1859. `Configuration storage directory'
  1860.      The directory that will contain all configuration files (Phonebook,
  1861.      Macrokeys, etc.). The default configuration file is called
  1862.      `term.prefs' and will be searched in the path defined by the
  1863.      enviroment variable `TERMCONFIGPATH' (see Environment variables).
  1864.  
  1865. `Text editor'
  1866.      Contains the name and search path of the editor used by `Edit &
  1867.      upload text file' in the Transfer menu.
  1868.  
  1869. ``term' help text file'
  1870.      This is where the name of the online-help text file is stored. By
  1871.      default this is `PROGDIR:term.guide'.
  1872.  
  1873. `Use'
  1874.      Use the current settings.
  1875.  
  1876. `Default (phone book only)'
  1877.      Drop the current settings, making a connection to the corresponding
  1878.      phone number will leave the corresponding main configuration entry
  1879.      unchanged.
  1880.  
  1881. `Cancel'
  1882.      Keep the old settings.
  1883.  
  1884.  
  1885. Translation panel
  1886. ==================
  1887.  
  1888.    `term' is capable of replacing any incoming and outgoing character
  1889. with custom text. This may come in handy with the numerous incarnations
  1890. of the dreaded IBM PC font. The control panel to be opened features a
  1891. large list of buttons, each single one representing a single character.
  1892. Some characters are shown with their corresponding glyphs, some with
  1893. their symbolic names and some as plain numbers. Clicking on one of the
  1894. buttons will bring up a control panel which allows setting the text to
  1895. be received by the terminal emulation when a certain character is
  1896. received and the text to be sent when a certain characters is
  1897. transmitted.
  1898.  
  1899.    Both texts can consist of standard Command sequences, except for the
  1900. following commands which are not supported:  `\a', `\c', `\d', `\g',
  1901. `\i', `\p', `\u' and `\x'.
  1902.  
  1903.    Please note that the translation does not come for free, terminal
  1904. input and output speed may suffer.
  1905.  
  1906.    As of this writing only a few translation table files (see below) are
  1907. included in the distribution. If you wish to create translation tables
  1908. for IBM doorway mode, national IBM-PC style font variants, etc. feel
  1909. free to send them to me. I will try to include them in the next `term'
  1910. release.
  1911.  
  1912.    Currently included in the `term' distribution are the following
  1913. translation table files:
  1914.  
  1915. `ISO-4-(GB).prefs'
  1916.      British 7 bit (ISO code 4) character set.
  1917.  
  1918. `ISO-10-(S).prefs'
  1919.      Swedish 7 bit (ISO code 10) character set.
  1920.  
  1921. `ISO-11-(S).prefs'
  1922.      Swedish 7 bit (ISO code 11) character set.
  1923.  
  1924. `ISO-15-(I).prefs'
  1925.      Italian 7 bit (ISO code 15) character set.
  1926.  
  1927. `ISO-16-(P).prefs'
  1928.      Portuguese 7 bit (ISO code 16) character set.
  1929.  
  1930. `ISO-17-(E).prefs'
  1931.      Spanish 7 bit (ISO code 17) character set.
  1932.  
  1933. `ISO-21-(D).prefs'
  1934.      German 7 bit (ISO code 21) character set.
  1935.  
  1936. `ISO-60-(N).prefs'
  1937.      Norwegian 7 bit (ISO code 60) character set.
  1938.  
  1939. `ISO-61-(N).prefs'
  1940.      Norwegian 7 bit (ISO code 61) character set.
  1941.  
  1942. `ISO-69-(F).prefs'
  1943.      French 7 bit (ISO code 69) character set.
  1944.  
  1945. `PC-8.prefs'
  1946.      Character translation for standard IBM-PC style font. If you wish
  1947.      to use these translation tables, make sure to set the `Font' type
  1948.      in the Terminal panel to `IBM-PC style (raw)'.
  1949.  
  1950.    Unfortunately, there is no translation available for the Norvegian
  1951. and Danish variants of the PC-8 character set as I do not yet have a
  1952. fitting Amiga font available. Similar reasons have yet prevented to
  1953. implement PC-850 character set support.
  1954.  
  1955.  
  1956. Function key panel
  1957. ===================
  1958.  
  1959.    This control panel allows setting user definable texts for all ten
  1960. function keys. All texts are considered Command sequences, a topic
  1961. which will be covered later in this document.
  1962.  
  1963. `Modifier'
  1964.      All in all 40 keys may be covered with user defined Command
  1965.      sequences. As the Amiga keyboard only has ten function-keys this
  1966.      button switches between the modifier keys (`Shift', `Control',
  1967.      `Alt') which, if pressed in addition which a function key, will
  1968.      execute one of the 40 command sequences.
  1969.  
  1970. `Load'
  1971.      Load the function key settings from a file.
  1972.  
  1973. `Save'
  1974.      Save the function key settings to a file.
  1975.  
  1976. `Use'
  1977.      Use the current settings.
  1978.  
  1979. `Cancel'
  1980.      Keep the old settings.
  1981.  
  1982.    As the definition of the function keys with command sequences
  1983. contradicts the standard definition of the four functions keys of a
  1984. VT-100-terminal, the keys `F1'-`F4', which may be executed by pressing
  1985. the `Shift' key and the approriate function-key simultaneously, are
  1986. mapped to the standard sequences for function-keys. The user may -- of
  1987. course -- change these settings.
  1988.  
  1989.    If an external terminal emulation happens to be active, those
  1990. function keys the emulation has allocated for itself will be disabled
  1991. and cannot be edited.
  1992.  
  1993.  
  1994. Cursor key panel
  1995. *****************
  1996.  
  1997.    This control panel both works and looks similar to the Function key
  1998. panel, the only difference is that it is to assign command sequences to
  1999. the cursor keys rather than to the function keys. Displayed are the
  2000. assignments for all four cursor keys and the following buttons:
  2001.  
  2002. `Modifier'
  2003.      Any cursor key can be pressed along with one of the modifier keys
  2004.      (`Shift', `Control', `Alt'). This button will switch between the
  2005.      different assignments.
  2006.  
  2007. `Load'
  2008.      Load the cursor key settings from a file.
  2009.  
  2010. `Save'
  2011.      Save the cursor key settings to a file.
  2012.  
  2013. `Use'
  2014.      Use the current settings.
  2015.  
  2016. `Cancel'
  2017.      Keep the old settings.
  2018.  
  2019.  
  2020. Fast macro panel
  2021. =================
  2022.  
  2023.    The design and implementation of the settings to be configured in
  2024. this menu are closely related to the menu entry Function key panel
  2025. discussed before, the only difference to be seen in the fact that the
  2026. fast! macros are mapped to buttons rather than function keys (more on
  2027. this topic later in this document, see Fast! macros).
  2028.  
  2029. `Macro list'
  2030.      The list of macros entered yet, to edit one of these, select it by
  2031.      clicking the mouse button with the mouse pointer on it.
  2032.  
  2033. `Macro'
  2034.      The name of a macro by which it is listed in the fast! macro list.
  2035.  
  2036. `Macro code'
  2037.      The command sequence (see Command sequences) associated with a
  2038.      fast! macro. Command sequences are discussed later in this
  2039.      document.
  2040.  
  2041. `New'
  2042.      Appends a new macro to the list. The user may then select and
  2043.      customize it.
  2044.  
  2045. `Delete'
  2046.      Removes the currently selected macro from the list.
  2047.  
  2048. `Load'
  2049.      Loads the macro list from a file.
  2050.  
  2051. `Save'
  2052.      Saves the macro list to a file.
  2053.  
  2054. `Top'
  2055.      Places the currently selected macro at the top of the list.
  2056.  
  2057. `Up'
  2058.      Moves the currently selected macro one entry up.
  2059.  
  2060. `Down'
  2061.      Moves the currently selected macro one entry down.
  2062.  
  2063. `End'
  2064.      Places the currently selected macro at the end of the list.
  2065.  
  2066.  
  2067. Hotkey panel
  2068. =============
  2069.  
  2070.    This is where the key sequences used to arrange screens and to
  2071. execute special functions are to be configured.
  2072.  
  2073. `term screen to front'
  2074.      The keys to press to bring the `term' screen to the front.
  2075.  
  2076. `Buffer screen to front'
  2077.      The keys to press to bring the screen of the Text buffer process
  2078.      to the front.
  2079.  
  2080. `Skip dial entry'
  2081.      As an alternative to the `Skip' button, pressing these keys will
  2082.      skip a dialing entry if the dialing function is currently active.
  2083.  
  2084. `Abort ARexx command'
  2085.      An ARexx script started from within `term' can be aborted by
  2086.      pressing these keys. Use this function only if pressing `Control +
  2087.      C' does not stop the program execution.
  2088.  
  2089. `Commodity priority'
  2090.      The commodity priority to assign this task to. You may want to
  2091.      change this value if you have more than one program running which
  2092.      uses the same key sequences as `term'. The program with the higher
  2093.      commodity priority will receive the keystrokes first.
  2094.  
  2095. `Hotkeys enabled'
  2096.      Whether the hotkeys are enabled or not can be toggled by clicking
  2097.      on this button, or by using the `Exchange' program to be found in
  2098.      the `Tools/Commodities' drawer.
  2099.  
  2100. `Load'
  2101.      Loads the hotkey settings from a file.
  2102.  
  2103. `Save'
  2104.      Saves the hotkey settings to a file.
  2105.  
  2106. `Use'
  2107.      Use the current settings.
  2108.  
  2109. `Cancel'
  2110.      Keep the original settings.
  2111.  
  2112.    If any changes made here do not seem to take effect immediately, the
  2113. user has probably typed a keyword wrong (causing the entire hotkey setup
  2114. to fail). I'm sorry about this, but the current implementation of
  2115. hotkey support does not sport error checking.
  2116.  
  2117.  
  2118. Speech panel
  2119. =============
  2120.  
  2121.    If enabled, the Amiga speech synthesizer will be used to alert the
  2122. user of certain actions, such as carrier lost, connection made, etc.
  2123. This feature makes sense if `term' is running in the background where
  2124. the user cannot see what is actually happening on the main screen. By
  2125. default this feature is disabled.
  2126.  
  2127.    *Note: speech synthesis is no longer available with Kickstart 3.0
  2128. and Workbench 2.1!*
  2129.  
  2130. `Rate'
  2131.      Speaking speed in words per minute.
  2132.  
  2133. `Pitch'
  2134.      The greater this value, the higher the voice appears to be
  2135.      speaking.
  2136.  
  2137. `Frequency'
  2138.      Voice frequency in Hertz.
  2139.  
  2140. `Volume'
  2141.      The volume of the voice.
  2142.  
  2143. `Sex'
  2144.      Enabled female or male voice.
  2145.  
  2146. `Speech enabled'
  2147.      Toggles the activity of the speech synthesizer.
  2148.  
  2149. `Speak!'
  2150.      Speaks a small sample text, note that speech must be enabled for
  2151.      this function to work.
  2152.  
  2153. `Load'
  2154.      Loads the speech settings from a file.
  2155.  
  2156. `Save'
  2157.      Saves the speech settings to a file.
  2158.  
  2159. `Use'
  2160.      Use the current settings.
  2161.  
  2162. `Cancel'
  2163.      Keep the original settings.
  2164.  
  2165.  
  2166. Sound panel
  2167. ============
  2168.  
  2169.    As an option `term' will associate sounds with special program
  2170. functions and events. This is where the sounds are configured:
  2171.  
  2172. `Terminal bell sound'
  2173.      The sound to be played whenever a `BEL' character is output on the
  2174.      terminal screen.
  2175.  
  2176. ``Connect' sound'
  2177.      The sound to be played when a connection is established.
  2178.  
  2179. ``Disconnect' sound'
  2180.      The sound to be played when a connection is lost.
  2181.  
  2182. ``File transfer finished' sound'
  2183.      The sound to be played when a file transfer is finished
  2184.      successfully.
  2185.  
  2186. ``File transfer failed' sound'
  2187.      The sound to be played when a file transfer is finished
  2188.      unsuccessfully.
  2189.  
  2190. `Modem `ring' sound'
  2191.      The sound to be played when the modem detects a call by a
  2192.      different modem.
  2193.  
  2194. `Modem `voice' sound'
  2195.      The sound to be played when the modem detects a phone call.
  2196.  
  2197. `Preload sound files'
  2198.      If this switch is enabled `term' will load all sound files
  2199.      immediately rather than accessing and loading them on demand. This
  2200.      may save access time when a sound is to be played but may eat up
  2201.      precious memory.
  2202.  
  2203. `Load'
  2204.      Load the sound settings from a file.
  2205.  
  2206. `Save'
  2207.      Save the sound settings to a file.
  2208.  
  2209. `Use'
  2210.      Use the current settings.
  2211.  
  2212. `Cancel'
  2213.      Keep the old settings.
  2214.  
  2215.    There is no fixed size limit to sound files, the amount of available
  2216. system memory matters. The sound files may be compressed, mono or
  2217. stereo files.
  2218.  
  2219.  
  2220. Transfer panel
  2221. ===============
  2222.  
  2223.    The transfer routines open an information window in which a number of
  2224. transfer parameters are displayed. Additionally, the file transfer can
  2225. be aborted by clicking either of two buttons (`Abort entire transfer'
  2226. and `Skip current file'). *For most transfer protocols both buttons
  2227. (abort and skip) have the same effect.* Consult the documentation to
  2228. see if different levels of abort are supported by your favourite
  2229. transfer protocol.
  2230.  
  2231.    The following information is displayed in the transfer window:
  2232.  
  2233. `Protocol'
  2234.      The name of the transfer protocol currently running.
  2235.  
  2236. `Information'
  2237.      A list to contain error message, the names files transferred and
  2238.      miscellaneous other messages addressed to the user.
  2239.  
  2240. `File'
  2241.      The name of the file being transferred.
  2242.  
  2243. `Next file'
  2244.      The name of the next file to be transferred.
  2245.  
  2246. `Space left'
  2247.      The space left on the destination device. `term' will try to
  2248.      calculate the number of blocks the file being received will take
  2249.      on the destination device and display a warning the file in
  2250.      question is probably not going to fit.
  2251.  
  2252.      Caution:  `term' only makes a very likely guess which may or may
  2253.      not come true. The guess may be wrong if the destination device
  2254.      happens to be a kind of ram-disk which shrinks and expands as
  2255.      memory requirements come and go. Such devices are usually 100%
  2256.      full. In most other cases you will probably be able to make room
  2257.      for the file being received before any space problem turns up.
  2258.  
  2259. `File size'
  2260.      If available, the size of the file.
  2261.  
  2262. `Bytes transferred'
  2263.      Number of bytes transferred yet.
  2264.  
  2265. `Total size'
  2266.      The total size of all files to be transferred.
  2267.  
  2268. `Total bytes transferred'
  2269.      The total number of bytes transferred yet.
  2270.  
  2271. `Files transferred'
  2272.      The number of files transferred yet and the number of files to go.
  2273.  
  2274. `Blocks transferred'
  2275.      Number of data blocks transferred yet.
  2276.  
  2277. `Characters/second'
  2278.      The effective transfer speed in characters per second.
  2279.  
  2280. `Character delay'
  2281.      The delay between two character being sent.
  2282.  
  2283. `Packet delay'
  2284.      The delay between two packets being sent.
  2285.  
  2286. `Packet type'
  2287.      A short description of the data block type employed for data
  2288.      transfer.
  2289.  
  2290. `Block check type'
  2291.      The method employed to verify the integrity of the data blocks
  2292.      being transferred (this usually is a form of cyclic redundancy
  2293.      checking).
  2294.  
  2295. `Block size'
  2296.      Size of a data block in bytes.
  2297.  
  2298. `Expected time'
  2299.      The time the transfer protocol expects the transfer will take.
  2300.  
  2301. `Elapsed time'
  2302.      The time elapsed during transfer.
  2303.  
  2304. `Message'
  2305.      A message of the transfer protocol addressed to the user.
  2306.  
  2307. `Number of errors'
  2308.      The number of errors occured during file transfer.
  2309.  
  2310. `Number of timeouts'
  2311.      The number of timeouts occured during file transfer.
  2312.  
  2313.    If the currently active transfer protocol provides the necessary
  2314. information, two bars will be displayed at the bottom of the transfer
  2315. window indicating the amount of transferred data and of time to go
  2316. before the transfer is finished.
  2317.  
  2318.    `term' knows about the Z-Modem data-inquire sequence the remote
  2319. receiver issues when expecting files. If recognized, this sequence will
  2320. cause `term' to display a requester asking for the type of data upload:
  2321.  text or binary. One could call this feature `auto upload'. You also
  2322. have the opportunity to select `Abort' which will transfer the ZModem
  2323. abort sequence or to click on the `Ignore' gadget which will plainly
  2324. ignore the fact that the ZModem inquiry sequence has been recognized.
  2325. *The Z-Modem abort sequence will also be transferred if you select the
  2326. `Cancel' button in the file requester to appear after selecting text-
  2327. or binary-upload.*
  2328.  
  2329.    *Some transfer protocols will allow you to enter a default receive
  2330. path the library is supposed to create files it receives in. On request
  2331. (see Miscellaneous panel) `term' will ignore these settings and use the
  2332. settings to be changed in the `Settings/Paths' (see Path panel) menu
  2333. instead.*
  2334.  
  2335.    Each file that is received and which does not remain empty is
  2336. examined briefly to find out about the file type. If recognized
  2337. successfully and the corresponding feature is enabled, a small comment
  2338. indicating the file type will be attached to the file. `term' currently
  2339. knows about 83 different file types.
  2340.  
  2341.    If the `term' main window is opened on the Workbench screen, you can
  2342. select and drag icons on it in order to upload the corresponding files.
  2343. A requester will be opened to ask for the upload style (either binary or
  2344. text).
  2345.  
  2346.    In case a file transfer terminates with an unrecoverable error
  2347. (*note:  the transfer protocol is responsible for reporting error
  2348. conditions to `term'*) the file transfer window will stay open until
  2349. explicitly closed by the user so the transfer error report list can be
  2350. viewed.
  2351.  
  2352.  
  2353. Phonebook
  2354. ==========
  2355.  
  2356.    The functions described in the following can be found in the `Modem'
  2357. menu and relate to the menu entries `Phonebook', `Dial' and `Redial'.
  2358.  
  2359.    `term' is equipped with a telephone number management system, the
  2360. phonebook, which is described in the following lines.
  2361.  
  2362. `Name list'
  2363.      The names of all phonebook entries are displayed here.
  2364.  
  2365. `BBS name'
  2366.      Name of the last selected telephone book entry.
  2367.  
  2368. `Comment'
  2369.      A comment to associate with a phonebook entry.
  2370.  
  2371. `Phone number'
  2372.      The telephone number of the last selected telephone book entry.
  2373.  
  2374.      If a BBS supports multiple lines, the phone number of each line
  2375.      may be entered, each one separated by a vertical bar `|' character
  2376.      (example: `123456|654321' would cause the dialing routine to dial
  2377.      the numbers `123456' and `654321'). The dialing routine will
  2378.      process all these phone numbers before proceeding to the next
  2379.      phonebook entry.
  2380.  
  2381.      The `|' character also works for the modem init, modem exit and
  2382.      dial prefix sequences. Whenever the dialing routine dials another
  2383.      phone number from a list separated by bars, it will try to find a
  2384.      matching init/exit/dial prefix sequence. If more phone numbers are
  2385.      specified than sequences are available, it will use the last
  2386.      sequence given (an example:  a phone number may be given as
  2387.      `123456|654321|12345', the dial prefix string may be `ATDP|ATDT';
  2388.      the dialing routine will call the first number using `ATDP123456',
  2389.      the second number using `ATDT654321' and the third number, since
  2390.      no special dial prefix is available, again using `ATDT12345').
  2391.  
  2392. `Quick menu'
  2393.      If this switch is in effect, the corresponding phone book entry
  2394.      will be put into the `quick dialing menu' (see at the right hand
  2395.      side of the main menu. Selecting the menu entry will dial the
  2396.      corresponding phone number. Note: only up to 20 phone numbers can
  2397.      be put into the list.
  2398.  
  2399. `New entry'
  2400.      Generates a new telephone book entry with standard settings and
  2401.      places it at the end of the telephone book.
  2402.  
  2403. `Clone entry'
  2404.      Will duplicate the currently selected phonebook entry and place it
  2405.      at the end of the list.
  2406.  
  2407. `Remove entry'
  2408.      Removes the last selected telephone book entry from the telephone
  2409.      book and frees the memory allocated for this entry.
  2410.  
  2411. `Dial list'
  2412.      Will pass the list of currently marked phonebook entries to the
  2413.      dialing routine.
  2414.  
  2415. `Clear list'
  2416.      Will clear the marks set for each telephone entry in the dialing
  2417.      list.
  2418.  
  2419. `Use entry'
  2420.      Takes over the local configuration settings saved with the
  2421.      currently selected phone book entry. Also installed are the
  2422.      associated password and user name entries.
  2423.  
  2424. `Load list'
  2425.      Loads the contents of a telephone book from a file.
  2426.  
  2427. `Sort list'
  2428.      If any phonebook entries have been selected to be dialed, the
  2429.      phonebook entries will be sorted in the order of dialing. The
  2430.      remaining phonebook entries will be sorted in ascending
  2431.      alphabetical order.
  2432.  
  2433. `Save list'
  2434.      Saves the contents of a telephone book to a file.
  2435.  
  2436. `Copy config'
  2437.      A lot of time can be saved by copying selected parts of the global
  2438.      configuration to a local configuration which is part of a phonebook
  2439.      entry. Selecting this button will invoke a control panel which
  2440.      allows to select which parts of the global configuration should be
  2441.      copied. The control panel also remembers which parts were copied
  2442.      when it was invoked the last time, see Copy panel for more
  2443.      information.
  2444.  
  2445. `Password'
  2446.      Press this button if you wish to save a special access password
  2447.      with the currently active telephone book file. You will then be
  2448.      asked to enter the password. What you type will not appear on the
  2449.      screen.
  2450.  
  2451.      To clear an existant password and to save the phonebook file
  2452.      without encryption, just press return when asked to enter the new
  2453.      password.
  2454.  
  2455.      The next time you save the phonebook data, the password will be
  2456.      encrypted and saved with it, the phonebook data itself will be
  2457.      encrypted using the password.
  2458.  
  2459.      *Whenever an encrypted phonebook file is loaded, it will take
  2460.      longer to load than an ordinary phonebook file, the same applies to
  2461.      saving phonebook data.*
  2462.  
  2463. `Print'
  2464.      This button will cause another control panel window to be opened
  2465.      which is to be described under Printing panel.
  2466.  
  2467.      Another list is located at the right hand side of the window. Each
  2468.      entry refers to a control panel to be invoked on the currently
  2469.      selected phonebook entry.
  2470.  
  2471. `Settings'
  2472.     `Serial'
  2473.     `Modem'
  2474.     `Screen'
  2475.     `Terminal'
  2476.     `Emulation'
  2477.     `Clipboard'
  2478.     `Capture'
  2479.     `Commands'
  2480.     `Misc'
  2481.     `Paths'
  2482.     `Transfer'
  2483.     `Translations'
  2484.     `Function keys'
  2485.     `Cursor keys'
  2486.     `Fast! macros'
  2487.           These entries refer directly to the settings main menu
  2488.           entries of the same name.
  2489.  
  2490.     `User/Password'
  2491.           This entry will open a control panel in which the password
  2492.           and user name to be used for the current phonebook entry can
  2493.           be entered. Both password and name are made available from
  2494.           within the `term' ARexx interface to allow auto login script
  2495.           files to set up a connection.
  2496.  
  2497.     `Rates'
  2498.           `term' will count the minutes you are online and connected to
  2499.           a BBS as soon as a connection is made through the dialing
  2500.           routine. This entry opens a control panel which allows
  2501.           setting the necessary data (see Rate panel).
  2502.  
  2503.    If you are still online, the `Dial list' gadget will be disabled. In
  2504. order to make another call hang up the line first.
  2505.  
  2506.    To put a phonebook entry into the dialing list, Shift-click (i.e.
  2507. hold down either shift key, then click once on the list entry) its
  2508. name. The number appearing to the left of its name indicates the
  2509. precedence of entries in the dialing list. To remove an entry from the
  2510. list, Shift-click it again. Instead of Shift-clicking on an entry, the
  2511. space bar may be pressed as well.
  2512.  
  2513.    Double-clicking on a name will immediately dial the selected entry.
  2514.  
  2515.    To dial the list of selected entries, press the `Dial list' button,
  2516. control will be passed over to the dialing panel.
  2517.  
  2518.    As I have been asked several times:  For dialing a telephone number
  2519. the dialing prefix specified for this telephone number is used. If the
  2520. MNP-error correction for a certain mailbox has to be specifically
  2521. switched on via the dial string, this has to be done in the modem
  2522. settings for this mailbox and not in the global settings of `term'. The
  2523. `Modem init string' and `Modem exit string' entries of the telephone
  2524. book can also be used for initialisation.
  2525.  
  2526.  
  2527. Rate panel
  2528. ===========
  2529.  
  2530.    `term' will count the minutes you are online and connected to a BBS
  2531. as soon as a connection is made through the dialing routine. As soon as
  2532. the connection is lost or you hang up, `term' will use the information
  2533. to be specified in this control panel to calculate the amount of money
  2534. to be paid for the call.
  2535.  
  2536. `Pay/unit'
  2537.      The amount of money to be paid for each single time unit when
  2538.      online. This fee must be given in the smallest currency unit
  2539.      available (pence, cents, centimes, etc.).
  2540.  
  2541. `Seconds/unit'
  2542.      This is where you enter how many seconds each time unit lasts.
  2543.  
  2544.    There are two different groups of the two entries listed above
  2545. available:  one for the first unit and one for all following units. So,
  2546. if you only pay for the call you make but not for the time you spend
  2547. making it, just enter the fee in the first group and set the second
  2548. group to zero.
  2549.  
  2550. `Days and dates'
  2551.      This list contains the default rate settings and exceptions for
  2552.      certain dates and days of the week. Each line displays the type of
  2553.      the entry and a comment (separated by the `>>' character). The
  2554.      following types are available:
  2555.  
  2556.     `Day(s)'
  2557.           Settings for certain days of the week
  2558.  
  2559.     `12. Jan (example)'
  2560.           Settings for a specific date
  2561.  
  2562.      If there is no special type available for an entry, it's probably
  2563.      the default settings you are dealing with. These settings are used
  2564.      whenever `term' cannot find an entry for the current day.
  2565.  
  2566.    For each entry in this list there is at least one associated starting
  2567. time available which defines when the associated rate settings are to be
  2568. used. You will find the time settings in the list titled `Time'. To add
  2569. a new time use the `Add time' button, to edit an existing entry, use
  2570. the `Edit time' button. To remove an entry, press the `Remove time'
  2571. button.
  2572.  
  2573. `Add date'
  2574.      Will invoke a control panel to create a new rate entry to be used
  2575.      on a specific date. Use the sliders and button to select the day
  2576.      the settings will be valid for.
  2577.  
  2578.      *The control panel will allow you to enter nonexistant dates, such
  2579.      as `31. Feb' so you will have to make sure that the date in
  2580.      question really exists.*
  2581.  
  2582. `Add day(s)'
  2583.      Will create a new rate entry referring to one or more days of the
  2584.      week. Use the buttons of the control panel to select the days the
  2585.      current settings will be valid for.
  2586.  
  2587. `Import'
  2588.      Much work can be saved if the rate settings for the current
  2589.      phonebook entry are imported (or copied) from a different
  2590.      phonebook entry. To do so, select this button. The control panel
  2591.      to be opened will display the list of phonebook entries available
  2592.      and three buttons:
  2593.  
  2594.     `Replace rates'
  2595.           The rate settings of the current phonebook entry will be
  2596.           replaced by the settings of the selected entry.
  2597.  
  2598.     `Append rates'
  2599.           The rate settings of the selected entry will be appended to
  2600.           the current phonebook entry.
  2601.  
  2602.     `Cancel'
  2603.           Will abort the selection.
  2604.  
  2605.    Whenever a rate entry is selected, the corresponding parameters
  2606. (`Pay/unit' and `Seconds/unit') can be edited. If the entry refers to a
  2607. certain date or a specific day of week three additional buttons are made
  2608. available:
  2609.  
  2610. `Edit'
  2611.      Just as the labels says, will allow you to modify an entry after
  2612.      it has been created.
  2613.  
  2614. `Clone'
  2615.      Will duplicate the current rate entry and append it to the list.
  2616.  
  2617. `Remove'
  2618.      Removes an entry from the list.
  2619.  
  2620.  
  2621. Copy panel
  2622. ===========
  2623.  
  2624.    This control panel allows you to select which parts of the global
  2625. configuration to copy into the currently selected phonebook entry.
  2626.  
  2627. `All'
  2628.      Selects all parts.
  2629.  
  2630. `Clear'
  2631.      Clears the current selection.
  2632.  
  2633. `Copy to all'
  2634.      The selected parts will be copied to all phone book entries. If any
  2635.      phone book entries are selected when this action is to be
  2636.      performed, only the selected entries will be affected.
  2637.  
  2638. `Copy'
  2639.      This is where you select from which source the configuration
  2640.      information will be copied:
  2641.  
  2642.     `Global configuration'
  2643.           Parts of the currently active global configuration will be
  2644.           copied.
  2645.  
  2646.     `Defaults'
  2647.           When going online, instead of overriding the currently active
  2648.           global configuration with the supplied local phone book
  2649.           configuration the corresponding global configuration will be
  2650.           left unchanged.
  2651.  
  2652.  
  2653. Dial panel
  2654. ===========
  2655.  
  2656.    The following information about the dialing process is displayed:
  2657.  
  2658. `Calling'
  2659.      The name of the telephone book entry belonging to the number being
  2660.      dialled. If it is just a telephone number the string `-- Unknown
  2661.      --' is shown, meaning that the name of the mailbox is unknown.
  2662.  
  2663. `Comment'
  2664.      This is where the comment corresponding to the current dialing list
  2665.      entry is displayed.
  2666.  
  2667. `Number'
  2668.      The telephone number being dialed or just dialed.
  2669.  
  2670. `Next'
  2671.      The name of the telephone book entry which will be processed next
  2672.      if no connection is established. If no further entry exists, `--
  2673.      None --' will be displayed.
  2674.  
  2675. `Timeout'
  2676.      A counter which is decreased every second and which reflects the
  2677.      time remaining to establish a connection or to cycle through the
  2678.      dial queue again.
  2679.  
  2680. `Attempt'
  2681.      This field shows the number of unsuccessful cycles made through the
  2682.      dialing queue to establish a connection.
  2683.  
  2684. `Message'
  2685.      A message to the user. This can be:
  2686.  
  2687.     `Dialing...'
  2688.           A dial is in process.
  2689.  
  2690.     `Line is busy.'
  2691.           The dialed number is engaged.
  2692.  
  2693.     `Incoming call!'
  2694.           The modem has been called from another modem.
  2695.  
  2696.     `Incoming voice call!'
  2697.           The modem is receiving a call which was not originated by
  2698.           another modem.
  2699.  
  2700.     `No dialtone detected!'
  2701.           The modem was unable to detect any dialing tone on the line,
  2702.           it may possibly be not connected.
  2703.  
  2704.     `Connection established.'
  2705.           Just as the name says...
  2706.  
  2707.     `Maximum number of dial retries reached!'
  2708.           Just as the name says...
  2709.  
  2710.     `Dial attempt timeout.'
  2711.           The time available to establish a connection has been reached
  2712.           or exceeded.
  2713.  
  2714.     `Redial Delay...'
  2715.           Pause until the next cycle through the dialing queue.
  2716.  
  2717.    Additionally three buttons can be found in the input field which
  2718. initiate the following functions.
  2719.  
  2720. `Skip call'
  2721.      With this function the current dialing attempt is cancelled and
  2722.      the next number is processed. If no succeeding telephone number
  2723.      exists `term' waits for the next cycle through the dial queue or
  2724.      until `Skip call' is pressed again.
  2725.  
  2726.      There also is a hotkey combination available to accomplish the same
  2727.      effect.
  2728.  
  2729. `Remove'
  2730.      This button works in part similar to the `Skip call' button.
  2731.      Additionally, it removes the current phonebook entry from the
  2732.      dialing list.
  2733.  
  2734. `Go to online'
  2735.      If the line is very noisy, the connection to a mailbox has been
  2736.      made but the `CONNECT' signal has been lost, you can use this
  2737.      button to switch directly to the online mode of the modem. This
  2738.      will also start the pay unit counter and the dial queue will be
  2739.      exited.
  2740.  
  2741. `Abort dialing'
  2742.      Operation of this button exits the dial queue (leaving the the dial
  2743.      queue intact) and ends the dialing process.
  2744.  
  2745.    If a connection is successfully made the corresponding entry in the
  2746. dial queue will be removed.
  2747.  
  2748.    Selecting the close gadget will close the window and cause the phone
  2749. book panel to be reopened.
  2750.  
  2751.  
  2752. Printing panel
  2753. ===============
  2754.  
  2755.    This control panel is part of the phone book. It is opened whenever
  2756. the `Print' button is selected and allows for setting the output
  2757. options.
  2758.  
  2759. `Output file or device'
  2760.      This is where you enter the name of the file or device (such as
  2761.      `PRT:') the phonebook printout is to be sent to.
  2762.  
  2763. `Plain text'
  2764.      If enabled only the plain and bare information text will be
  2765.      printed, else text attribute control sequences will be sent as
  2766.      well.
  2767.  
  2768. `Include...'
  2769.      Each switch determines whether the corresponding phonebook entry
  2770.      information will be included in the printout.
  2771.  
  2772. `Use'
  2773.      Will start printing the phonebook contents.
  2774.  
  2775. `Cancel'
  2776.      Returns to the phonebook.
  2777.  
  2778.  
  2779. Text buffer
  2780. ************
  2781.  
  2782.    The text buffer is a function which continually stores text
  2783. displayed on `term's main screen, so that the user can inform himself
  2784. about the received text at any time.
  2785.  
  2786.  
  2787. General characteristics
  2788. ========================
  2789.  
  2790.    The size of the text buffer is managed dynamically so that for every
  2791. new line which is read new memory must be allocated. So the size of the
  2792. text buffer is limited only by the amount of the available memory. It
  2793. is recommended that the text buffer is emptied periodically to avoid
  2794. using the entire free memory.
  2795.  
  2796.    If there is insufficient memory to place a new line into the text
  2797. buffer, the first line will be deleted to make room for the new line.
  2798.  
  2799.  
  2800. Operation
  2801. ==========
  2802.  
  2803.    The contents of the text buffer can be paged through using the keys
  2804. for moving of the cursor (`Shift + Cursor' keys moves page by page,
  2805. `Control + Cursor' key jumps to the beginning or end of the text
  2806. buffer). Additionally, the numeric keypad keys are overlaid with jump
  2807. and paging functions (corresponding to the inscriptions/graphics on the
  2808. front of the keys).
  2809.  
  2810.    Additionally there is another menu whose functions should be
  2811. explained briefly:
  2812.  
  2813. `Search'
  2814.      A search function is called which searches from the topmost line
  2815.      on the screen downwards for an entered search string. Upper- and
  2816.      lowercase are ignored by this function. If the search string is
  2817.      found it is displayed and highlighted.
  2818.  
  2819. `Repeat search'
  2820.      Continues the search process started with `Search'. The previously
  2821.      entered search string is carried over.
  2822.  
  2823. `Go to main screen'
  2824.      Switches to the main screen of `term'.
  2825.  
  2826. `Clear buffer'
  2827.      Clears the contents of the Text buffer.
  2828.  
  2829. `Close buffer, Quit'
  2830.      Closes the Text buffer screen but leaves the contents unchanged.
  2831.  
  2832.  
  2833. Clipboard
  2834. **********
  2835.  
  2836.    Cut & paste functions are available on the main screen, the buffer
  2837. screen and the review buffer. Here is how to use them:
  2838.  
  2839. `Buffer screen'
  2840.      Use the mouse to point to the first character you wish to send to
  2841.      the clipboard, hold down the select button, drag the mouse to the
  2842.      last character you wish to copy and release the button. The text
  2843.      marked will be transferred to the clipboard.
  2844.  
  2845.      Holding down the `Control' key while clicking on a character will
  2846.      feed the single character into the input stream, it will not be
  2847.      buffered in the clipboard.
  2848.  
  2849. `Main screen'
  2850.      Use the mouse to point to the first character you wish to send to
  2851.      the clipboard, hold down the select button, drag the mouse to the
  2852.      last character you wish to select and release the button. Select
  2853.      the `Copy' menu item (see Edit menu) to transfer the text to the
  2854.      clipboard. Instead of dragging the mouse you may also double-click
  2855.      on a single word to select it.
  2856.  
  2857.      Holding down the `Control' key while clicking on a character will
  2858.      feed the single character into the input stream, it will not be
  2859.      buffered in the clipboard.
  2860.  
  2861. `Review buffer'
  2862.      Use the mouse to point to the first character you wish to send to
  2863.      the clipboard, hold down the select button, drag the mouse to the
  2864.      last character you wish to select and release the button. Press
  2865.      `Amiga + C' to copy the selected text to the clipboard.
  2866.  
  2867.    To paste the clipboard contents, i.e. feed them into the terminal
  2868. input stream, either select the `Paste' menu item (see Edit menu) or
  2869. press `Amiga + V'. In order to send the clipboard contents along with a
  2870. `Paste prefix' and `Paste suffix' hold down any `Shift' key when
  2871. selecting the `Paste' menu entry or when selecting text with the mouse
  2872. (this works both with the main screen and the Text buffer screen).
  2873.  
  2874.    Hold down one of the `Alt' keys and press the left mouse button to
  2875. make `term' emit a number of cursor move sequences which will position
  2876. the on-screen cursor at the spot where you clicked the mouse.
  2877.  
  2878.    In standard string editing gadgets a solution had to be found to
  2879. preserve the line editing functions while still supporting menu
  2880. shortcuts. To undo any changes made press `Amiga + Q', to clear the
  2881. string editing gadgets press `Amiga + X'. Menus associated with the
  2882. shortcuts `Amiga + Q/X' are called by holding down any `Shift' key
  2883. along with the `Amiga' keys (i.e. `Shift + Amiga + Q' will select the
  2884. `Quit' menu item if available).
  2885.  
  2886.    Clipboard functions are also available within string gadgets:  press
  2887. `Amiga + C' to copy the contents of the gadget to the clipboard and
  2888. press `Amiga + V' to insert the current clipboard contents at the
  2889. current cursor position.
  2890.  
  2891.  
  2892. Command sequences
  2893. ******************
  2894.  
  2895.    Each string sent directly to the modem is a command sequence. This
  2896. includes telephone numbers, modem initialisation strings, function key
  2897. assignments, etc. In addition to the normal text strings various other
  2898. commands are supported which will be described in the following section.
  2899.  
  2900.  
  2901. Backslash
  2902. ==========
  2903.  
  2904. `\\'
  2905.      Generates a single backslash.
  2906.  
  2907. `\0'
  2908.      Resets the text pacing mode (see Clipboard panel) to the settings
  2909.      defaults. Any changes of the text pacing mode affect only the line
  2910.      to be sent. The next following line will be sent using the default
  2911.      text pacing mode.
  2912.  
  2913. `\1'
  2914.      Sets the text pacing mode to `Direct'.
  2915.  
  2916. `\2'
  2917.      Sets the text pacing mode to `Wait for echo'.
  2918.  
  2919. `\3'
  2920.      Sets the text pacing mode to `Wait for any echo'.
  2921.  
  2922. `\4'
  2923.      Sets the text pacing mode to `Wait for line prompt'.
  2924.  
  2925. `\5'
  2926.      Sets the text pacing mode to `Character/line delay'.
  2927.  
  2928. `\6'
  2929.      Sets the text pacing mode to `Keyboard delay'.
  2930.  
  2931. `\a'
  2932.      Executes an ARexx command (all text to follow this character).
  2933.  
  2934. `\b'
  2935.      Generates a backspace (deletes the character to the left of the
  2936.      cursor).
  2937.  
  2938. `\c'
  2939.      Calls a main menu entry, the menu entry to be called is determined
  2940.      by the argument to follow; this is either a six digit number
  2941.      (example: `\c 010203' would call subitem 1, item 2, menu 3) or the
  2942.      name of the menu entry enclosed in single quotes to call (example:
  2943.      `\c 'about'' would call the `About...' menu entry, the search is
  2944.      case-insensitive and only compares the characters given).
  2945.  
  2946. `\d'
  2947.      Executes an AmigaDOS command (all text to follow this character).
  2948.  
  2949. `\e'
  2950.      Generates the escape character (ASCII code 27).
  2951.  
  2952. `\f'
  2953.      Generates a form feed (skip to beginning of the next page or clear
  2954.      the screen).
  2955.  
  2956. `\g'
  2957.      Places the string to follow this character in the clipboard.
  2958.  
  2959. `\h'
  2960.      Appends the string to follow this character to the current
  2961.      clipboard contents.
  2962.  
  2963. `\i'
  2964.      Feeds the contents of the clipboard into the input stream.
  2965.  
  2966. `\n'
  2967.      Generates a line feed.
  2968.  
  2969. `\p'
  2970.      Feeds the password of the telephone book entry into the input
  2971.      stream of the last made connection. *The password is automatically
  2972.      cleared for security reasons when the connection is broken.*
  2973.  
  2974. `\r'
  2975.      Generates a carriage return.
  2976.  
  2977. `\t'
  2978.      Generates a tab jump.
  2979.  
  2980. `\u'
  2981.      Similar to the `\p' command, the `\u' command will feed the
  2982.      current user name into the input stream.
  2983.  
  2984. `\x'
  2985.      Generates a break signal (as with the `Send break' menu entry).
  2986.  
  2987. `\^'
  2988.      Generates a caret character.
  2989.  
  2990. `\*'
  2991.      The code to follow the asterisk determines the character to
  2992.      produce. This can be any three digit number or a symbolic name
  2993.      from the following list (1):
  2994.  
  2995.      `NUL', `SOH', `STX', `ETX', `EOT', `ENQ', `ACK', `BEL', `BS',
  2996.      `HT', `LF', `VT', `FF', `CR', `SO', `SI', `DLE', `DC1', `DC2',
  2997.      `DC3', `DC4', `NAK', `SYN', `ETB', `CAN', `EM', `SUB', `ESC',
  2998.      `FS', `GS', `RS', `US', `SP', `DEL', `SS2', `SS3', `DCS', `CSI',
  2999.      `ST', `OSC', `PM', `APC', `NBS' and `SHY'
  3000.  
  3001.    If none of the mentioned combinations is recognized the character
  3002. which follows the `\' will be fed into the input stream without any
  3003. changes.
  3004.  
  3005.    ---------- Footnotes ----------
  3006.  
  3007.    (1)  `EOU' may be implemented in a future release
  3008.  
  3009.  
  3010. Caret
  3011. ======
  3012.  
  3013.    This character is used to change the following character to a
  3014. `control character'. So the sequence `^J' will become a Line feed and
  3015. `^I' becomes a tab jump. The character which follows the `^' has to be
  3016. located between `@' and `[', otherwise it is fed into the input stream
  3017. without changes.
  3018.  
  3019.  
  3020. Tilde
  3021. ======
  3022.  
  3023.    This character causes the program to pause for exactly half a second
  3024. before it continues to process the following commands.
  3025.  
  3026.  
  3027. Fast! macros
  3028. *************
  3029.  
  3030.    In implementation and design the fast! macros are closely related to
  3031. the function key macros (see Function key panel). If invoked by
  3032. selecting the corresponding menu entry, a window will open on the right
  3033. hand side of the screen sporting a scrollable list of macros (the
  3034. contents of this list can be edited using the Fast macro panel). When a
  3035. list entry is selected, the associated command sequence (see Command
  3036. sequences) will be executed.
  3037.  
  3038.    By using the fast! macros it is theoretically possible to control a
  3039. BBS just by mouse, provided that you have the approriate macros in your
  3040. fast! macro list.
  3041.  
  3042.    The fast! macro panel can be resized and acts just like the main
  3043. `term' window:  menu items can be selected and characters entered are
  3044. sent to the serial driver.
  3045.  
  3046.  
  3047. Packet window
  3048. **************
  3049.  
  3050.    In this window a line can be edited before it is sent. All the usual
  3051. editing functions known from standard input fields are available
  3052. (`Shift + cursor left/right' jumps to the start/end of the line).
  3053.  
  3054.    Additionally, some extended functions exist which are performed by
  3055. pressing a cursor key together with the `Shift' or `Control' key:
  3056.  
  3057. `Control + Cursor left'
  3058.      Jumps to the next word.
  3059.  
  3060. `Control + Cursor right'
  3061.      Jumps to the previous word.
  3062.  
  3063. `Cursor up'
  3064.      Shows the last entered command in the input line.
  3065.  
  3066. `Shift + Cursor up'
  3067.      Shows the very first command entered so far.
  3068.  
  3069. `Cursor down'
  3070.      Shows the next entered command (if you moved back for some
  3071.      commands before).
  3072.  
  3073. `Shift + Cursor down'
  3074.      Shows the very last command entered so far.
  3075.  
  3076.    This string gadget has a buffer where all previously entered commands
  3077. are stored (`Command history'). You can page through this buffer, load
  3078. and save it and individual lines can be recalled. As with the Text
  3079. buffer this buffer is managed dynamically. The same memory restrictions
  3080. that apply to the Text buffer are valid for this buffer.
  3081.  
  3082.    The input line also has a menu which offers the following functions:
  3083.  
  3084. `Load history'
  3085.      Loads the contents of the input line buffer from a file. Each
  3086.      stored line in this file can be recalled and sent.
  3087.  
  3088. `Save history as...'
  3089.      Saves the contents of the input line buffer to a file.
  3090.  
  3091. `Clear history'
  3092.      Simply releases all previously stored commands and the memory used
  3093.      by them.
  3094.  
  3095. `Other window'
  3096.      Switches to the main screen of `term'.
  3097.  
  3098. `Quit'
  3099.      Closes the window (corresponds to clicking the close gadget of the
  3100.      window).
  3101.  
  3102.    *Every character entered into this window is shown immediately so
  3103. that those things where it is better that they should not appear on the
  3104. screen (like passwords for a mailbox) should be entered in another way.*
  3105.  
  3106.    The content of every input line is interpreted as a command sequence
  3107. and therefore can also contain control characters.
  3108.  
  3109.    If a line taken from the input buffer is sent without change it is
  3110. *not* stored in the buffer again (`true history' as known from
  3111. `ConMan').
  3112.  
  3113.    The contents of the input buffer are cleared automatically after the
  3114. window is closed. *Under no circumstances are the contents maintained
  3115. until the next call!*
  3116.  
  3117.    Provided that the packet window is large enough, a list to contain
  3118. the command line history will be displayed.
  3119.  
  3120.  
  3121. Environment variables
  3122. **********************
  3123.  
  3124.    Information which is to be available the next time the program is
  3125. run is placed as AmigaDOS variables in the directory `ENV:' and
  3126. `ENVARC:' by `term'.
  3127.  
  3128.    The variables used by `term' can be used and manipulated by other
  3129. programs transparently. In detail these variables are:
  3130.  
  3131. `TERMCONFIGPATH'
  3132.      The name of the directory in which all information used by `term'
  3133.      is placed (standard configuration, telephone book, etc.). The
  3134.      default settings file name is `ENVARC:term'.
  3135.  
  3136. `TERMWINDOW'
  3137.      The window definition which can also be entered in the program via
  3138.      the menu item Settings.
  3139.  
  3140. `xpr...'
  3141.      The standard settings used for the corresponding transfer protocol
  3142.      (`xprzmodem', `xprkermit', etc.).
  3143.  
  3144. `xem...'
  3145.      The standard settings used for the corresponding external terminal
  3146.      emulation library (`xemvt340', `xemascii', etc.).
  3147.  
  3148.  
  3149. Revision history
  3150. *****************
  3151.  
  3152. Changes introduced with v3.3:
  3153. *****************************
  3154.  
  3155.    * Added the quick dialing menu.
  3156.  
  3157.    * Enhanced the modem and screen settings
  3158.  
  3159.    * Fixed a few bugs in the ARexx interface commands `REQUESTFILE' and
  3160.      `REQUESTRESPONSE'
  3161.  
  3162.    * Unfortunately a single line was missing in the XPR option setup,
  3163.      causing them program not to save the transfer protocol options.
  3164.  
  3165.    * No longer forces the creation date of an auto-capture file to be
  3166.      included in the file. As an option, will use the naming convention
  3167.      used in previous program releases.
  3168.  
  3169.    * The program now optionally creates icons for files.
  3170.  
  3171.    * Added a terminal hex-mode for debugging purposes
  3172.  
  3173.    * Fonts are now opened using properly initialized DPI and aspect
  3174.      ratio values which results in much better scaled outline font
  3175.      rendering.
  3176.  
  3177.    * The name of an external emulation library is no longer quietly
  3178.      suppressed.
  3179.  
  3180.    * It is possible to disable the double-buffered file management
  3181.      routines now.
  3182.  
  3183.    * Added the text pacing option.
  3184.  
  3185.    * Apparently, external and internal terminal emulations tried to
  3186.      turn on/off each other's cursors.
  3187.  
  3188.    * Copying text to the clipboard now permits to append the text to
  3189.      the current clipboard contents.
  3190.  
  3191. Changes introduced with v3.2:
  3192. *****************************
  3193.  
  3194.    * Could not enter phonebook passwords
  3195.  
  3196.    * The XPR interface now states much more clearly what the likely
  3197.      cause of a serial I/O error might have been
  3198.  
  3199.    * New sound support functions added
  3200.  
  3201.    * Added `OK' and `ERROR' modem response codes
  3202.  
  3203.    * The order of messages displayed in the file transfer window has
  3204.      changed (now works top down rather than bottom up).
  3205.  
  3206.    * The ARexx interface routines did not check whether the serial
  3207.      device handles were available or not (boom!)
  3208.  
  3209.    * Redid the fast! macro handling
  3210.  
  3211.    * The text buffer screen did not notice when the buffer contents
  3212.      were cleared
  3213.  
  3214.    * Retuned the phone book and dial list routines which could generate
  3215.      Enforcer hits and trash innocent memory
  3216.  
  3217.    * Boldface/italics characters will no longer leak into the window
  3218.      borders
  3219.  
  3220.    * The cursor image now reflects the state of the terminal window
  3221.  
  3222.    * The program would generate an Enforcer hit when files were to be
  3223.      transferred by dropping their icons on the main window
  3224.  
  3225.    * When opening a capture file the program could ask twice whether an
  3226.      already existing file should be replaced.
  3227.  
  3228.    * Paste operations triggered from the review buffer window would not
  3229.      start any paste operation until the main window was reselected
  3230.  
  3231.    * Reworked the character translation table format.  Translation
  3232.      table files should be smaller now and should load a lot faster
  3233.  
  3234.    * The screen/output window size now changes to the number of columns
  3235.      specified in the terminal settings
  3236.  
  3237.    * Rarely, the file transfer window would be opened very narrow and
  3238.      tall.  So tall in fact that display elements would overlap each
  3239.      other, no text could be displayed in the big listview and Enforcer
  3240.      hits were not to be avoided.
  3241.  
  3242.    * The file transfer interface would produce Enforcer hits when to
  3243.      transfer files using an old-style XPR library.
  3244.  
  3245.    * The phonebook dial list handling would select single entries when
  3246.      a shift key was pressed during keyboard selection.
  3247.  
  3248.    * The review buffer window no longer loses track of the text area it
  3249.      ought to display after resizing the window.
  3250.  
  3251.    * Rewrote much of the keyboard/mouse/peanut butter handling loop. 
  3252.      No longer quite so complex.
  3253.  
  3254.    * Thanks to user persistence the `Password' text entry field
  3255.      available through the password/user panel no longer hides the
  3256.      actual password text.
  3257.  
  3258.    * `Hang up' menu item did not cause a backed-up configuration to be
  3259.      restored.
  3260.  
  3261.    * Naughty XPR protocols which would issue error reports through
  3262.      xpr_update() during XPRSetup() would cause the transfer window to
  3263.      be opened not to close afterwards.
  3264.  
  3265.    * No more odd happenings in the status line online time display. 
  3266.      The code responsible would misinterprete a string index.  This has
  3267.      been fixed.
  3268.  
  3269.    * It is no longer possible to dial phone book entries which have no
  3270.      name or phone number attached.
  3271.  
  3272.    * The terminal emulation code no longer leaves background colour
  3273.      artifacts when scrolling text with a background colour other than
  3274.      the default background colour enabled.
  3275.  
  3276.    * Calls to BeginIO() rather than SendIO() were giving some -- if not
  3277.      most -- device drivers hard times.  According to the few tests I
  3278.      have run so far the program now performs more reliable when doing
  3279.      file transfers.  `term' now works again in conjunction with
  3280.      isdn.device.
  3281.  
  3282.    * The program no longer encodes the creation date into the name of an
  3283.      auto-capture file but rather writes creation time and date to the
  3284.      first new line in the file.
  3285.  
  3286.    * New tooltype/command line option `Quiet' will cause `term' to
  3287.      start up iconified.
  3288.  
  3289. Changes introduced with v3.1:
  3290. *****************************
  3291.  
  3292.    * Previous releases of the phone book would not clone single phone
  3293.      book entries correctly.
  3294.  
  3295.    * The configuration copying routine will now selectively copy config
  3296.      information to the currently selected phone book entries.
  3297.  
  3298.    * The phone book encryption/decryption routines are a tad faster now.
  3299.  
  3300.    * The program will now prompt twice for a phone book access password.
  3301.  
  3302.    * Comment, phone number, user name and password can be much longer
  3303.      now than they used to be in previous releases.
  3304.  
  3305.    * The phone book now only contains the configuration information to
  3306.      differ from the global configuration.
  3307.  
  3308.    * Previous releases would not save any rate information along with
  3309.      encrypted phone book files, this has been fixed.
  3310.  
  3311.    * The configuration copying routine now allows to `drop' parts of
  3312.      the phone book configuration rather than replacing them with parts
  3313.      of the global configuration.  This feature works in conjunction
  3314.      with the new phone book file format.
  3315.  
  3316.    * A new feature has been added:  as an option, the program will
  3317.      immediately start to redial the currently configured dialing list
  3318.      as soon as the line is hung up or the carrier is lost.
  3319.  
  3320.    * The program finally includes context-sensitive online help
  3321.      implemented through amigaguide.library (note:  Kickstart 3.0
  3322.      required).  Any window to offer a help text will display it when
  3323.      the `Help' key is pressed.
  3324.  
  3325.    * The ARexx interface documentation was entirely rewritten.  The
  3326.      main program documentation was updated and slightly enhanced.  Be
  3327.      sure to reread it!
  3328.  
  3329.    * Both the text buffer screen and review buffer window now feature
  3330.      new and improved scrollers.  Scrolling and screen refreshes are
  3331.      also quite a bit faster now.
  3332.  
  3333.    * The text searching routine has been enhanced and now works much
  3334.      faster than in previous releases.  It also happens to find
  3335.      multiple occurences of a string in a single line.
  3336.  
  3337.    * Improved text buffer handling, reduced memory fragmentation if
  3338.      running under control of Kickstart 3.0.
  3339.  
  3340.    * The text buffer will no longer quietly swallow single characters
  3341.      and will finally correctly wrap lines longer than 80 characters.
  3342.  
  3343.    * The review buffer window now also sports a search function just
  3344.      like the text buffer screen, other useful menu items have been
  3345.      added as well.
  3346.  
  3347.    * In previous releases the program would miscalculate the number of
  3348.      bytes left on a filing device when receiving a file.  It would not
  3349.      take the number of bytes received into account, this has been
  3350.      fixed.
  3351.  
  3352.    * In order to transfer files one can simply drag the corresponding
  3353.      icons on the `term' main window (requires that the `term' window
  3354.      is opened on the Workbench screen).
  3355.  
  3356.    * Instead of identifying the type of a file received, the program
  3357.      will optionally attach a file comment to show the name of the BBS
  3358.      the file was received from and the time and date when the file was
  3359.      received.
  3360.  
  3361.    * In case a file transfer is terminated due to errors the file
  3362.      transfer window will remain open until explicitely closed.
  3363.  
  3364.    * The XPR interface will disable the xpr_unlink() routine if the
  3365.      `override transfer path' option is in effect.
  3366.  
  3367.    * The XPR interface will no longer sort files to be uploaded by size
  3368.      and name as most users found this feature annoying.  It now sorts
  3369.      the files by name.
  3370.  
  3371.    * The file transfer window now correctly displays the names of all
  3372.      files sent and received.
  3373.  
  3374.    * The file transfer server was removed as it would not lead to a
  3375.      performance gain but a performance loss.
  3376.  
  3377.    * `term' now finally also runs as a window on the Workbench or any
  3378.      other public screen (that's what you always wanted, right?).  If
  3379.      running under control of Kickstart 3.0 will attempt to share
  3380.      screen colours with other applications, making it possible to run
  3381.      the terminal emulation in eight or sixteen colours if enough
  3382.      shareable pens are available.
  3383.  
  3384.    * `term' will refuse to run on a public screen if running under
  3385.      control of Kickstart 2.x and if the screen font happens to be
  3386.      proportional-spaced.
  3387.  
  3388.    * Some minor and some major bugs in the built-in terminal emulation
  3389.      have been fixed.
  3390.  
  3391.    * The program distribution now includes the 11 point IBM.font
  3392.      donated by Bernhard F.  Muller.
  3393.  
  3394.    * I was surprised to discover that in previous releases the terminal
  3395.      emulation server would never get activated as the conditions it
  3396.      would be enabled would very rarely be met.  Since the file
  3397.      transfer server would actually lead to a performance loss rather
  3398.      than a performance gain I chose to remove the terminal server
  3399.      along with it.  Both may be implemented in a future release.
  3400.  
  3401.    * The terminal emulation should work a tad faster now.
  3402.  
  3403.    * The program now requires diskfont.library to be installed in order
  3404.      to work correctly.
  3405.  
  3406.    * The program will ask for a confirmation prior to resetting the
  3407.      serial device driver while the program is still online.  Most
  3408.      seasoned JR-Comm had trouble to adjust to the fact that the
  3409.      JR-Comm command `send password' would use the same menu shortcut
  3410.      as the `term' `release serial device' command.
  3411.  
  3412.    * The name of the call log file can now be configured completely. 
  3413.      Previous releases would use the call file path and use the name
  3414.      `term-call.log'.
  3415.  
  3416.    * The status window now displays the name of the ARexx host port,
  3417.      the BBS name, phone number, comment and current user name.
  3418.  
  3419.    * In order to confuse and annoy you, the menu layout has been
  3420.      changed once again.
  3421.  
  3422.    * A new feature has been added:  the `wait' menu item will
  3423.      repeatedly send the sequence <Space><Backspace> in order to
  3424.      simulate terminal input.
  3425.  
  3426.    * The program now requires a bit more memory than before (program
  3427.      size has climbed by about 50 KBytes).
  3428.  
  3429.    * New command line options and tool types have been added, some have
  3430.      been renamed.
  3431.  
  3432.    * The program is now much smarter in determining the sizes of the
  3433.      phone book and file transfer window.
  3434.  
  3435.    * The lists used by the phone book and the date panel no longer look
  3436.      quite so weird if using a proportional-spaced font.
  3437.  
  3438.    * The main screen text snipping scheme has changed a bit and now
  3439.      resembles the standard console device snipping.  Also supported is
  3440.      double-clicking on single words in order to snip them.
  3441.  
  3442.    * The ARexx interface has been entirely rewritten from scratch.
  3443.