home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / comms / comprgs / t22bi1.lha / term.doc < prev    next >
Text File  |  1992-05-14  |  105KB  |  2,041 lines
  1. =============================== term 2.2a =================================
  2. ===========================================================================
  3.              A Gift-Ware telecommunications program written by
  4.          Olaf Barthel, ⌐ copyright 1990-92 by Olaf Barthel & MXM,
  5.                            All rights reserved.
  6.  
  7.    No  guarantee of any kind is given that the program(s) described in this
  8. document are 100% reliable.  You are using this material on your own risk.
  9.  
  10.  
  11. ========================== Important information ==========================
  12. ===========================================================================
  13.  
  14.                      New names for configuration files
  15.                      ---------------------------------
  16.    For   compliance   with   existing   design  guidelines,  the  names  of
  17. configuration  files  and  the  preferred  storage  directory have changed.
  18. `term'  will  now  store  and read configuration files in the `TERM:config'
  19. drawer  (well,  unless  there  is  a  `TERMPATH'  variable  which lead to a
  20. different  path...   see below).  If no `TERM:' device is available, `term'
  21. will  assign  `TERM:'  to  the  directory  it  was  started  from.   If  no
  22. `TERM:config' drawer is available, it will be created.
  23.  
  24.                        The (old) new file names are:
  25.  
  26.                  Preferences.term -> term_preferences.iff
  27.                  Phonebook.term   -> term_phonebook.iff
  28.                  Hotkeys.term     -> term_hotkeys.iff
  29.                  Speech.term      -> term_speech.iff
  30.                  Macros.term      -> term_macros.iff
  31.                  Fast!Macros.term -> term_fastmacros.iff
  32.  
  33.               The names introduced in v2.0 have changed to:
  34.  
  35.                  term_preferences.iff -> term.prefs
  36.                  term_phonebook.iff   -> phonebook.prefs
  37.                  term_hotkeys.iff     -> hotkeys.prefs
  38.                  term_speech.iff      -> speech.prefs
  39.                  term_macros.iff      -> macros.prefs
  40.                  term_fastmacros.iff  -> fastmacros.prefs
  41.  
  42.                     The old names are still supported.
  43.  
  44. =============================== Background ================================
  45. ===========================================================================
  46. This  program  is  a  product of anger and despair;  I was unable to find a
  47. telecommunications  program  to  suit  my  personal needs -- neither in the
  48. commercial area, nor in the public-domain.
  49.  
  50.    Most  programs  had  a  lot  of  extras but lacked other more important,
  51. perhaps more sensible features (just to take an example:  in revision 2.20c
  52. and after four years of constant development `Handshake'ástill fails to use
  53. the  current  keymap  settings  and  also  strips  bit  7  when  displaying
  54. characters - sorry Eric, that's why I never registered!).
  55.  
  56.    I  have  hesitated  for  a long time before starting my first attempt at
  57. writing  my  very  own  telecommunications program.  When Kickstart 2.x was
  58. about  to  become  widely available I took the opportunity to create `term'
  59. always  trying  to  use  the new OS routines wherever possible.  While this
  60. started  to  be  quite  a  difficult task it also was a lot of fun (imagine
  61. Columbus  wrecking  his  fleat four times on his journey to the West Indies
  62. due  to unexpected leakages in all vessels and sudden changes in the ships'
  63. sailing manuals -- that's how I felt!).
  64.  
  65.    As  far as computer-telecommunications are concerned, Germany appears to
  66. be  a  developing  country.  This is partly due to the Deutsche Bundespost,
  67. the federal mail/phone company whose telecommunications monopoly used to be
  68. protected  by  federal  law.   Until 1989 you would risk a heavy penalty if
  69. using    a    non-registered    modem   or   telephone   instead   of   the
  70. Bundespost-supplied  hardware.   So,  if you have any complaints, or miss a
  71. few extremely important features in `term', don't boo and hiss, I am not as
  72. long in the telecomm business as you are (I have yet seen only a single DEC
  73. VT-101  from afar!).  Tell me what you need and I will try to add it in the
  74. next revision.
  75.  
  76.    This project was started at December 24 1990 and completed by January 25
  77. 1991.   I  used the following tools to create `term':  SAS/C 5.10b, WShell,
  78. CygnusEd Professional Release 2 & ARexx.
  79.  
  80.    My  thanks  go  to  the  following  people for their invaluable help and
  81. assistance:    Holger   Lubitz,  Peter  Fischer,  Christoph  Teuber,  Garry
  82. Glendown,  Oliver  Wagner, Jⁿrgen Otte, Germar Morgenthaler, Matthias Zepf,
  83. Markus   Stoll,   Ralf  Thanner,  Martin  Berndt,  Ueli  Kaufmann,  Andreas
  84. Kirchwitz,  Veith  Sch÷rgenhummer,  Michael  Vaeth,  Roby  Leemann  & AUGS,
  85. Thorsten  Seidel,  Till  `Dill-Prince'  Prinzler,  Volker Ulle & the Aquila
  86. Sysop  Team,  Marc-Christian  Schr÷er,  Udo  Wolt, Michael Hohmann, Henning
  87. Hucke, Stefan Becker, Christopher  Wichura  and to all  those who  supplied
  88. libraries & control sequence tables.
  89.    Special  thanks  go  to  John Burton of Papua New Guinea who revised and
  90. rewrote  certain parts of the program, in particular the terminal emulation
  91. routines.
  92.  
  93.    The  xpr-libraries  were  created  by  Kenneth  Osterberg & Markus Pietz
  94. (jmodem),  Stephen  Walton  (kermit),  Jack  Rouse  (quickb),  Marc Boucher
  95. (xmodem), Ueli Kaufmann (ascii, ymodem & vms) and Rick Huebner & William M.
  96. Perkins (zmodem).
  97.  
  98.    The  xpr-standard  was  created  by Willy Langeveld, I borrowed a single
  99. routine  (ahtoi)  from  Matthew  Dillon's  `DMouse'  program, the quicksort
  100. routine  (QuickSort.asm) was written by David Jones, the touch-tone dialing
  101. routines  are  based  on  the  article  `DTMF  -  A  Program for Generating
  102. Touch-Tone  Signals'  by Adam Levin, the touch tone period and cycle values
  103. are ⌐ Copyright 1989 by Commodore-Amiga, Inc.
  104.  
  105.    The  current  implementation  of  the external terminal emulation module
  106. interface  was  developed  by  Ueli  Kaufmann,  who also wrote the external
  107. terminal  emulation libraries supplied with `term'.  Without the invaluable
  108. help  of  Martin Berndt the library interface would probably not be working
  109. at all.
  110.  
  111.    Special  thanks go to Leo Schwab who discovered means to use interleaved
  112. bitmaps in a system-integrated manner.
  113.  
  114.    Since  time  did  not  permit  me  to translate the full original German
  115. documentation into English, I had asked the Z-Net Amiga community for help.
  116. As  a  result  this  document was translated by three different authors (in
  117. order of translation):  me, Marc Schr÷er and Henning Hucke.  Garry Glendown
  118. took care of the termRexx documentation -- thanks to all of you!
  119.  
  120.  
  121. ============================= The source code =============================
  122. ===========================================================================
  123. Since  there  are  still only very few well-documented examples (or general
  124. programming  examples) for Kickstart 2.x I have decided to include the full
  125. `C' source code with the `term' distribution.
  126.    The  source code is _not_ intended for commercial use.  If you are about
  127. to  include  portions  in  commercial  programs you will need to ask me for
  128. permission.   Still you may use parts of the source code for non-commercial
  129. software development without my consent.
  130.    I  sincerely  hope  that the release of the full `term' source code will
  131. give  Kickstart 2.x a better start (I've overcome quite a lot of obstacles)
  132. so that more programs to use the new OS features will be available soon.
  133.  
  134.  
  135. ============================ The distribution =============================
  136. ===========================================================================
  137. `term' may be included with commercial programs as long as no money is made
  138. by  including  it  in  the  distribution (this also applies to inclusion in
  139. AmigaDOS  Enhancer  kits,  on  Workbench/Extras  disks  or  A3x00 hard disk
  140. drives).
  141.    You  _must_not_ make any money by distributing `term'.  A small copy fee
  142. for  data media (5$ US maximum) or the inclusion of `term' in Public-Domain
  143. collections  such  as  Fred  Fish's  Amiga  Library of Freely Distributable
  144. Software is permitted though.
  145.  
  146.  
  147. ============================== Using `term' ===============================
  148. ===========================================================================
  149. The  program  `term'  and the data received/sent by it must not be used for
  150. the following purposes:
  151.  
  152. 1) The  construction,  development,  production  or  testing  of weapons or
  153.    weapon systems of any kind.
  154.  
  155. 2) The construction, development, production or use of plants/installations
  156.    which include the processing of radioactive/fissionable material.
  157.  
  158. 3) The training of persons to deal with the abovesaid actions.
  159.  
  160.  
  161. ===================== Updates & new program revision ======================
  162. ===========================================================================
  163. Whenever  a  new  release of `term' becomes available I will try to make it
  164. known  in  the  telecommunications  networks.   To order a copy send a self
  165. addressed  envelope,  an  international  mail  reply coupon (coupon-rΘponse
  166. international) and a 3╜" disk to the author.
  167.    The  most  current  `term'  release  will  be available through ftp from
  168. ftp.informatik.uni-oldenburg.de     (134.106.1.9),     look     into    the
  169. `/pub/amiga/term'  directory.   I  will also try to make sure that the most
  170. current    `term'    release    will   be   available   trough   ftp   from
  171. ab20.larc.nasa.gov (wuarchive.wustl.edu in the near future).
  172.  
  173.  
  174. ============================ Operating `term' =============================
  175. ===========================================================================
  176. `term'  can  be  controlled  both  by  mouse  and keyboard.  With two minor
  177. exceptions  each  operation  requiring  mouse  control can also be executed
  178. using keyboard shortcuts.
  179.    The  program  can  be  started  both  from  Workbench  and  from  Shell.
  180. Kickstart  2.x  is required to run `term'.  The program will refuse to work
  181. if executed under control of Kickstart 1.3 and below!
  182.    At  least  Kickstart 2.04 (revision 37.175) and Workbench 2.04 (revision
  183. 37.67)  are  required  to  execute  `term' successfully.  Earlier developer
  184. Kickstart  revisions  or the Kickstart release installed on the older A3000
  185. models will probably not work (try it if you want -- but don't complain!).
  186.    If  called from Shell `term' will detach itself immediately allowing the
  187. Shell  window  to  be  closed  afterwards.   This  effect can be avoided if
  188. `KEEPIO' is entered in the command line (`term keepio').
  189.    Usually, running `term'átwice will cause the screen of the other program
  190. to  be popped to the front instead of creating a second `term' process.  To
  191. avoid  this  effect,  enter  `DONTPOP'  as a calling parameter (e.g.  `term
  192. dontpop').   If  called from Workbench, each program will run as a separate
  193. process.
  194.  
  195.  
  196. ============================ Keyboard control =============================
  197. ===========================================================================
  198. Starting  with revision 2.2 almost any action can be executed both by mouse
  199. and  by  keyboard.   Each  element  of the user interface in whose title an
  200. underlined character an underlined character can be found can be controlled
  201. or  activated by pressing the corresponding key.  If the object in question
  202. is  a list view or scroll bar, pressing the key along with a shift key will
  203. scroll  the  list/bar back and forth.  Pressing the `Tab' key will activate
  204. the first string gadget on the screen.
  205.  
  206.  
  207. =============================== The display ===============================
  208. ===========================================================================
  209. The  `term'  main screen always opens to the full text-overscan size (which
  210. can be set using the `Overscan' tool in the `Prefs' drawer).
  211.    At  the  bottom  of  the  screen  a  small  window  displays a few basic
  212. parameters.  These are:
  213.  
  214. Status ........ The   current  program  operating  status.   This  includes
  215.                 `Ready',  `Holding'á(Control+S was pressed), `Dialing' (the
  216.                 dialing  function  is  at  work),  `Upload'  (data is being
  217.                 sent),  `Download'  (data is being received), `Breaking' (a
  218.                 break  signal  is  transmitted  across the serial line) and
  219.                 `Hanging up' (connection is being cancelled).
  220.  
  221. Font .......... The  currently  active  screen  font used for text/graphics
  222.                 rendering.
  223.  
  224. Protocol ...... The currently set data transfer protocol.
  225.  
  226. Emulation ..... The currently active terminal emulation mode.
  227.  
  228. Baud Rate ..... The data transfer rate in bits per second.
  229.  
  230. Parameters .... The current serial parameters (Data bits-Parity-Stop bits).
  231.  
  232. Time .......... The current time of day.
  233.  
  234. Online ........ The  time  elapsed  after  a  connection  was  successfully
  235.                 established.   This  counter will be stopped as soon as the
  236.                 connection  is cancelled (e.g.  by hanging up) and is reset
  237.                 to 00:00:00 as soon as a new connection is made.
  238.                    Every  five  seconds  the  time display will change to a
  239.                 calling fee display and the other way round.
  240.  
  241.    The  screen itself is opened as a public screen (called `TERM') which is
  242. available  to  other  programs for their purposes.  If more than one `term'
  243. process  is  running,  the  public screen name will change according to the
  244. number  of  the program (i.e.  the first `term' to be started will call the
  245. scren  `TERM',  the second one will call it `TERM1', the third one `TERM2',
  246. etc.).   The  screen  title  bar  will  also display the name of the public
  247. screen.
  248.  
  249.  
  250. ================================ The menus ================================
  251. ===========================================================================
  252. For  each  requester  and  input window there exists a set of menu items to
  253. execute  the  commands associated with the buttons, dials and gauges in the
  254. requester/window.   Press  to  right  mouse  button  to  have a look at the
  255. commands and their shortcuts.
  256.    The following text is to describe the menu items available in the `term'
  257. main menu.
  258.  
  259. 1. Project
  260. ----------
  261. This menu contains functions to load and to save program configurations and
  262. to quit the program.
  263.  
  264. Open Settings.................. Loads the program configuration from a file
  265.                                 to be selected.
  266.  
  267. Save Settings.................. Saves  the  current  program  configuration
  268.                                 under  the  configuration  file  name  last
  269.                                 entered.
  270.  
  271. Save Settings As............... Saves  the current program configuration to
  272.                                 a file to be selected.
  273.  
  274. Print Screen................... Sends  the  current  contents of the `term'
  275.                                 screen  to  the  printer.   This  is  not a
  276.                                 graphics    hardcopy,    only   the   ASCII
  277.                                 characters are printed.
  278.  
  279. Iconify........................ Closes  all  screens and windows `term' has
  280.                                 currently  open,  resets  and  releases the
  281.                                 serial  driver  and  puts  an icon into the
  282.                                 Workbench   window.   Double-clicking  this
  283.                                 icon  will  cause  `term' to wake up and to
  284.                                 return   the   state   is   was  in  before
  285.                                 iconification took place.
  286.                                    Note:   while  `term'  is iconified, all
  287.                                 incoming synchronous ARexx-commands will be
  288.                                 queued and the corresponding ARexx programs
  289.                                 will  appear  to `hang'.  As soon as `term'
  290.                                 is  `awake'  again pending commands will be
  291.                                 processed again.
  292.  
  293. About.......................... Shows some information on the program.
  294.  
  295. Quit........................... Terminates the program, hold down a `shift'
  296.                                 key to quit immediately, otherwise you will
  297.                                 be prompted to confirm your decision.
  298.  
  299.    After  selecting the `Quit' menu item the program may take a few seconds
  300. to exit since the contents of the `log book' are freed first.
  301.  
  302. 2. Utilities
  303. ------------
  304. This  menu  contains  functions  which  are to make your life a bit easier.
  305. AmigaDOS  commands  as well as ARexx script files may be started from here.
  306. As  a  special  gift for `Snap' users, the contents of the clipboard may be
  307. fed into the input stream.
  308.  
  309. Set Console Window............. Whenever   an   AmigaDOS/ARexx  command  is
  310.                                 executed  an output window is opened.  This
  311.                                 menu   item   will  bring  up  a  requester
  312.                                 allowing  you to edit the size and position
  313.                                 of  the  window  to be opened (consult your
  314.                                 AmigaDOS  manual  for  a description of the
  315.                                 window  position  string).   If  you do not
  316.                                 want  the  window  to  appear, simply enter
  317.                                 `NIL:'.
  318.  
  319. Execute AmigaDOS Command....... Enter  the  command you want to execute and
  320.                                 its command line arguments here.
  321.  
  322. Execute ARexx Command.......... This  function  calls  the  ARexx server to
  323.                                 execute  a script file.  If the first input
  324.                                 character  is  a  `  or " the input will be
  325.                                 considered  as  a  small program in a line.
  326.                                 Note   that   this  function  will  not  be
  327.                                 available   if   the   ARexx  server  isn't
  328.                                 running.
  329.                                    The   ARexx  command  set  supported  by
  330.                                 `term'    is    described   in   the   file
  331.                                 `termRexx.doc'.
  332.  
  333. Paste Clipboard Contents....... The  current contents of the clipboard will
  334.                                 be  fed  into  the  input stream (max.  255
  335.                                 characters).   Use the `log book' screen to
  336.                                 cut strings and characters to the clipboard
  337.                                 (`Snap' may also be used for this purpose).
  338.  
  339. Packet Window.................. Opens/closes  an  input  window  in which a
  340.                                 single line of characters to be transferred
  341.                                 across  the  serial  line  can  be entered.
  342.                                 More  on  this  feature  is explained under
  343.                                 `The packet window' below.
  344.  
  345. Toggle Fast! Macro Panel....... Opens  or closes the so-called fast!  macro
  346.                                 panel.   The role of the fast!  macros will
  347.                                 be discussed later in this text.
  348.  
  349.    The  menu  functions  `Execute  AmigaDOS  Command'  and  `Execute  ARexx
  350. Command'  allow  you  to  select  the  name  of  the file to be executed by
  351. clicking on the `Load File' gadget.
  352.  
  353. 3. Capture & Buffer
  354. -------------------
  355. The menu items in this menu offer functions to load/save, to display and to
  356. capture incoming text/graphics data.
  357.  
  358. Clear Buffer................... Clears the contents of the `log book'.  Any
  359.                                 text  will  be  discarded  and  _cannot_ be
  360.                                 recovered.   Capture files are not affected
  361.                                 by this command.
  362.  
  363. Display Buffer................. Opens  the  `log  book' screen.  If a shift
  364.                                 key  is  held  down  when this menu item is
  365.                                 selected,  instead of the `log book' screen
  366.                                 a  small  window will be opened on the main
  367.                                 screen.  Use the cursor keys to move around
  368.                                 in  the  buffer  and  mouse to copy & paste
  369.                                 text around.
  370.  
  371. Close Buffer................... Closes  the  `log book' screen but does not
  372.                                 free the contents.
  373.                                    If  a  shift  key is held down when this
  374.                                 menu item is selected, the small `log book'
  375.                                 window will be closed.
  376.  
  377. Freeze Buffer.................. This  menu entry will, if enabled, stop the
  378.                                 `log book' from filling up with new text.
  379.  
  380. Load Buffer.................... Loads the contents of the `log book' from a
  381.                                 file.  If there are still text lines in the
  382.                                 `log  book'  a requester will appear giving
  383.                                 you  the  choice  to  discard the old data,
  384.                                 append  the  new  data,  or  to  cancel the
  385.                                 action.
  386.  
  387. Save Buffer.................... Saves  the  contents of the `log book' to a
  388.                                 file.   You will be notified if the file to
  389.                                 save to exists already (you may discard the
  390.                                 old file, append the new data or cancel the
  391.                                 action).
  392.  
  393. Capture To Disk................ Toggles  file capture, options are the same
  394.                                 as with `Save Buffer'.
  395.  
  396. Capture To Printer............. Toggles printer capture.
  397.  
  398.    More  detailed information on the `log book' will be given later in this
  399. document.
  400.  
  401. 4. Transfer
  402. -----------
  403. Since  data  transfer cannot always be done by keyboard and console, `term'
  404. supports  a number of transfer protocols implemented as xpr-libraries.  The
  405. `term'    distribution    includes   xprascii.library,   xprjmodem.library,
  406. xprkermit.library,  xprquickb.library,  xprvms.library,  xprxmodem.library,
  407. xprymodem.library and xprzmodem.library.
  408.  
  409. Upload Text.................... Sends a file/files to the  remote  receiver
  410.                                 using  the  current  transfer protocol.  If
  411.                                 possible   this   command  will  `ask'  the
  412.                                 transfer  protocol  to transmit the file(s)
  413.                                 in  text  mode  (whatever that means) which
  414.                                 may  include  CR/LF  substitution and other
  415.                                 gimmicks.       Consult     the     library
  416.                                 documentation to find out if your favourite
  417.                                 transfer library supports text mode.
  418.  
  419. Download Text.................. Request  a  file/files  using  the  current
  420.                                 transfer  protocol.  Refer to `Upload Text'
  421.                                 for features/options of this mode.
  422.  
  423. Upload ASCII................... This    is   a   pure   ASCII-file   upload
  424.                                 implemented  through  xprascii.library.  It
  425.                                 was  added  to  allow  poor BBS programs to
  426.                                 receive   text  files  (especially  Paragon
  427.                                 doesn't  seem  to  like  ZModem  text  file
  428.                                 upload).
  429.  
  430. Download ASCII................. This   is   a   pure   ASCII-file  download
  431.                                 implemented    through    xprascii.library.
  432.                                 Refer     to     `Upload     ASCII'     for
  433.                                 features/options of this mode.
  434.  
  435. Upload File(s)................. Send  a  file/files  to the remote receiver
  436.                                 using  the current transfer protocol.  True
  437.                                 batch  upload  is  supported  both  through
  438.                                 wildcard  expressions  ("#?.txt"  will send
  439.                                 all  files  whose names end with `.txt') or
  440.                                 through  multiple  selection (hold down the
  441.                                 shift  key and click the names of the files
  442.                                 you   wish  to  transmit).   Refer  to  the
  443.                                 documentation  of  your  favourite transfer
  444.                                 library  to find out if batch file transfer
  445.                                 is supported.
  446.  
  447. Download File(s)............... Receive  a  file/files  using  the  current
  448.                                 transfer  protocol.   If  the protocol does
  449.                                 not support batch download you are required
  450.                                 to  enter  the  name  of  the  file  to  be
  451.                                 received.   Files  which remain empty after
  452.                                 the transfer are deleted automatically.
  453.  
  454. Edit & Transfer File........... Invokes the currently selected (see `Paths'
  455.                                 settings  menu  below)  text  editor  on  a
  456.                                 file to be selected using a file requester.
  457.                                    `term'  will  block  and  wait until the
  458.                                 editor has returned.
  459.                                    After  the editor has returned, the user
  460.                                 will be asked whether the file edited is to
  461.                                 be  transferred  as plain ASCII or via text
  462.                                 upload.
  463.  
  464. Transfer Options............... The  transfer  options  can be changed with
  465.                                 this  command.  If possible a control panel
  466.                                 will  pop up which allows you to change the
  467.                                 current  parameters  by mouse/keyboard.  If
  468.                                 the  selected  transfer  protocol  does not
  469.                                 provide these option hooks, a simple string
  470.                                 requester  will  prompt for input.  Consult
  471.                                 the   documentation   of   your   favourite
  472.                                 transfer protocol for legal options and the
  473.                                 values to which they can be set.
  474.  
  475. Transfer Protocol.............. This  command  allows  you  to  specify the
  476.                                 transfer  protocol  library  to be employed
  477.                                 for up-/downloads.
  478.  
  479.    The  transfer  routines  open an information window in which a number of
  480. transfer  parameters are displayed.  Additionally, the file transfer can be
  481. aborted  by  clicking  either  of  two buttons (`Abort Entire Transfer' and
  482. `Skip  Current  File').   Note:   for  most transfer protocols both buttons
  483. (abort  and  skip)  have  the  same  effect.   Consult the documentation if
  484. different  levels  of  abort  are  supported  by  your  favourite  transfer
  485. protocol.
  486.    The following information is displayed in the transfer window:
  487.  
  488. Protocol............... The   name   of  the  transfer  protocol  currently
  489.                         running.
  490.  
  491. File................... The name of the file being transferred.
  492. File Size.............. If available, the size of the file.
  493. Space Left............. The  space  left on the destination device.  `term'
  494.                         will try to calculate the number of blocks the file
  495.                         being  received will take on the destination device
  496.                         and  display  a  warning  the  file  in question is
  497.                         probably not going to fit.
  498.                            Caution:   `term'  only  makes  a  very propable
  499.                         guess  which  may  or may not come true.  The guess
  500.                         may  be  wrong if the destination device happens to
  501.                         be  a kind of ram-disk which shrinks and expands as
  502.                         memory  requirements come and go.  Such devices are
  503.                         usually  100%  full.   In most other cases you will
  504.                         probably  be  able  to make room for the file being
  505.                         received before any space problem turns up.
  506.  
  507. Bytes Transferred...... Number of bytes transferred yet.
  508. Blocks Transferred..... Number of data blocks transferred yet.
  509. Block Check Type....... The  method employed to verify the integrity of the
  510.                         data  blocks  being  transferred (this usually is a
  511.                         form of cyclic redundancy checking).
  512.  
  513. Block Size............. Size of a data block in bytes.
  514.  
  515. Estimated Time......... The time the transfer protocol expects the transfer
  516.                         will take.
  517. Elapsed Time........... The time elapsed during transfer.
  518.  
  519. Message................ A message of the transfer protocol addressed to the
  520.                         user.
  521. Information............ A  list  to  contain  the last error occured or the
  522.                         name of the last file transferred.
  523.  
  524. Number Of Errors....... The number of errors occured during file transfer.
  525.  
  526. Number Of Timeouts..... The   number   of   timeouts  occured  during  file
  527.                         transfer.
  528.  
  529. Packet Type............ A short description of the data block type employed
  530.                         for data transfer.
  531. Packet Delay........... The delay between two packets being sent.
  532. Characters/Second...... The  effective  transfer  speed  in  characters per
  533.                         second.
  534. Character Delay........ The delay between two character being sent.
  535.  
  536.    If  the  currently  active  transfer  protocol  provides  the  necessary
  537. information,  two  bars  will  be  displayed  at the bottom of the transfer
  538. window  indicating  the amount of transferred data and of time to go before
  539. the transfer is finished.
  540.    `term'  knows about the ZModem data-inquire sequence the remote receiver
  541. issues  when  expecting  files.   If  recognized,  this sequence will cause
  542. `term'  to display a requester asking for the type of data upload:  text or
  543. binary.   One  could  call  this  feature `auto upload'.  You also have the
  544. opportunity to select `Abort' which will transfer the ZModem abort sequence
  545. or  to click on the `Ignore' gadget which will plainly ignore the fact that
  546. the  ZModem  inquiry  sequence  has  been recognized.  Note that the ZModem
  547. abort  sequence  will also be transferred if you select the `Cancel' button
  548. in the file requester to appear after selecting text- or binary-upload.
  549.    NOTE:  some transfer protocols will allow you to enter a default receive
  550. path  the  library  is supposed to create files it receives in.  On request
  551. (see  the  `Settings/Miscellaneous' menu) `term' will ignore these settings
  552. and use the settings to be changed in the `Settings/Paths' menu instead.
  553.    Each  file  that is received and which does not remain empty is examined
  554. briefly  to  find  out  about the file type.  If recognized successfully, a
  555. small  comment  indicating  the  file  type  will  be attached to the file.
  556. `term' currently knows about the following 72 different file types:
  557.  
  558.            Workbench icon file               Windows bitmap image file
  559.              ASCII text file                      JFIF image file
  560.           `C' source code file                  IFF-ILBM image file
  561.              `C' header file                  IFF-ANIM animation file
  562.    Assembly language source code file           IFF-8SVX sound file
  563.      Assembly language include file             IFF-SMUS score file
  564.     Modula-2/Oberon source code file            IFF-FTXT text file
  565.             ARexx script file                IFF-PREF preferences file
  566.             Basic source code           IFF-TERM `term' configuration file
  567.         AmigaGuide document file                     IFF file
  568.             TeX document file                  AmigaVision flow file
  569.            Metafont font file                Imploder data output file
  570.             Generic font file              PowerPacker data output file
  571.           Packed TeX font file             LhPak self extracting archive**
  572.    TeX device independent output file            Arc archive file
  573.         PasTeX font library file                 ARJ archive file
  574.         Manx 3.x object code file                 Compressed file*
  575.         Manx 5.x object code file               Freeze output file*
  576.           Manx 3.x library file                  CPIO archive file*
  577.           Manx 5.x library file              MacCompress archive file▓
  578.         AmigaDOS object code file              Compact archive file▓
  579.     AmigaDOS object code library file          Diamond archive file▓
  580.         AmigaDOS executable file                LhArc archive file
  581.            System library file                   LHA archive file
  582.            System device file                    Zoo archive file
  583.    AmigaDOS filing system handler file          PKZip archive file
  584.           AmigaDOS handler file               Stuff It! archive file▓
  585.              GIF image file                    Pack It! archive file▓
  586.             Degas image file╣                  DMS disk archive file
  587.            MacPaint image file▓               Warp disk archive file
  588.           SuperPaint image file▓              Zoom disk archive file
  589.         Macintosh PICT image file▓               SPARC object code
  590.           Sun raster image file│                 SPARC executable
  591.              Postscript file                     MS-DOS executable
  592.              PCX image file                   Atari-ST/TT executable
  593.             TIFF image file                    Macintosh executable
  594.  
  595.    ╣  Atari-ST/TT-specific (Degas Elite)
  596.    ▓  Macintosh-specific
  597.    │  SunOS-specific
  598.    *  Unix-specific
  599.    ** Not yet ready for release
  600.  
  601.  
  602. 5. Phone
  603. --------
  604. The  commands  in  this  menu deal with controlling the serial line and the
  605. modem.
  606.  
  607. Phonebook...................... The  phonebook  is one of the most powerful
  608.                                 and complex functions of `term' and will be
  609.                                 described later in this document.
  610.  
  611. Dial........................... To  dial  a single phone number select this
  612.                                 menu  item.   The phone number entered will
  613.                                 be passed to the dialing routine.
  614.  
  615. Redial......................... Dialing  list  entries  the dialing routine
  616.                                 was unable to establish a connection to are
  617.                                 again passed to the dialer.
  618.  
  619. Play Number.................... Outputs a telephone number using touch-tone
  620.                                 dial coding on the Amiga audio hardware.
  621.  
  622. Send Break..................... Sends  a  `break'  signal across the serial
  623.                                 line.
  624.  
  625. Hang Up........................ Tells the modem to hang up the serial line.
  626.  
  627. Flush receive buffer........... Tells  the  serial driver to drop its input
  628.                                 buffer contents and resets the state of the
  629.                                 internal serial buffers.
  630.  
  631. Release Serial Device.......... The  serial  driver  is  released for other
  632.                                 programs  to  use  it.   A  requester  will
  633.                                 appear  which  allows  you  to  reopen  the
  634.                                 serial driver or to quit `term'.
  635.                                    If  the  serial driver has been released
  636.                                 by  the  ARexx  interface  and has not been
  637.                                 reopened yet, this menu item will do it.
  638.  
  639. 6. Display
  640. ----------
  641. The  items  in  this menu deal with the `term' main screen and the terminal
  642. emulation.
  643.  
  644. Clear Screen................... Clears  the  whole  `term'áscreen and moves
  645.                                 the cursor to the top left home position.
  646.  
  647. Reset Styles................... Resets   all   character  style  attributes
  648.                                 (bold, blinking, inverse video, underlined,
  649.                                 etc.)  and  sets  the  text  colour  to the
  650.                                 default pen.
  651.  
  652. Reset Font..................... Will  change  the  screen  font back to the
  653.                                 default screen font (IBM/topaz).
  654.  
  655. Reset Terminal................. Use  this  menu  item to reset the state of
  656.                                 the entire terminal emulation.
  657.  
  658. Save Screen (IFF-ILBM)......... Saves  the  contents  of  the  `term'  main
  659.                                 screen to a file.  The resulting image file
  660.                                 can  be  read  by  any  program  to support
  661.                                 IFF-ILBM images.
  662.  
  663. Save Screen (ASCII)............ Saves the current contents of the screen to
  664.                                 a file; this does not include any graphics,
  665.                                 only the ASCII characters are saved.
  666.  
  667.  
  668. 7. Settings
  669. -----------
  670. `term'  is  configured  using the `Settings' menu.  The following text will
  671. describe the functions associated with each menu item:
  672.  
  673. a) Serial Settings
  674. ------------------
  675. This is where the serial parameters may be changed.
  676.  
  677. Baud Rate.............. Transfer speed in bits per second.
  678.  
  679. Bits/Char.............. Number of bits per transferred character (7 / 8).
  680.  
  681. Parity................. Serial parity (none, odd, even, mark, space).
  682.  
  683. Stop Bits.............. Number of stop bits (1 / 2).
  684.  
  685. Handshaking............ Serial handshaking mode (XON/XOFF, RTS/CTS, none).
  686.  
  687. Duplex................. Determines  whether  characters  are echoed back to
  688.                         the  terminal  screen  or  not  (full, half = local
  689.                         echo).
  690.  
  691. Buffer Size............ The  number  to be specified here allows to set the
  692.                         serial  driver  I/O  buffer  size.  Note that every
  693.                         number you enter here will result in `term' and the
  694.                         serial  driver  allocating  twice  the  buffer size
  695.                         (this  is only a word of warning for those among us
  696.                         who prefer buffer sizes of 256K and up).
  697.  
  698. Shared Access.......... Requested  by many (two to be accurate) users, this
  699.                         switch  allows  you  to  run  the  serial driver in
  700.                         shared  access  mode.   Not  all  driver types will
  701.                         allow this to happen.
  702.  
  703. High-Speed Mode........ Activates a special mode of the serial driver which
  704.                         is  to  skip  a  couple of internal parity and stop
  705.                         bits  checks  resulting  in  higher data throughput
  706.                         rate.   Note  that  enabling this feature will only
  707.                         make  sense  if  used  on  two  directly  connected
  708.                         computers.
  709.  
  710. Break Length........... Length of the break signal given in microseconds.
  711.  
  712. Serial Device.......... The name of the serial driver to be used by `term'.
  713.                         This  is  usually  `serial.device' (`modem?.device'
  714.                         for  the  internal Supra modem, `sxbios.device' for
  715.                         ASDG's serial IO card).
  716.  
  717. Device Unit Number..... The   device  unit  number  of  the  serial  driver
  718.                         selected  above.   This usually left 0 but can also
  719.                         be used to address multiple serial IO ports.
  720.  
  721. Use.................... Accept the current settings.
  722.  
  723. Cancel................. Don't use the current settings.
  724.  
  725.    Most  modems  will not recognize a sudden change in the baud rate.  Type
  726. `AT<RETURN>' to make the change known.
  727.    If  `RTS/CTS (DSR)' handshaking is selected, `term' will check to see if
  728. the  `Data  set  ready'  line  happens  to be high active.  If not, it will
  729. default back to software handshaking (xON/xOFF).  The `RTS/CTS' handshaking
  730. mode will ignore the presence or absence of the `DSR' signal.
  731.    `term'  will take advantage of Christopher Whichura's OwnDevUnit.library
  732. if  installed  in  your  system,  allowing  controlled access to the serial
  733. driver's resources.
  734.  
  735. b) Modem Settings
  736. -----------------
  737. This  is  where  modem  control  strings  and  other related parameters are
  738. configured.
  739.  
  740. Modem Init String...... The  string  to  send to the modem after successful
  741.                         program  initialization.   This  string is optional
  742.                         and does not need to be entered.
  743.                            The  dialing routine will use the initialization
  744.                         string entered here before dialing a phone number.
  745.  
  746. Modem Exit String...... The  string  to be sent to the modem shortly before
  747.                         the  program  terminates.  Just like the modem init
  748.                         string this string is optional and does not need to
  749.                         be entered.
  750.                            The  dialing routine will use the initialization
  751.                         string   entered   here  before  dialing  the  next
  752.                         telephone number.
  753.  
  754. Modem Hangup String.... The  string  to  be sent to the modem when asked to
  755.                         hang  up the line.  This string is not optional, it
  756.                         has to be present for the program to work properly.
  757.  
  758. Dial Prefix............ The  string  to  be  used  to  prefix  each dialing
  759.                         command.   This  is  usually a variant of `ATDP' or
  760.                         `ATDT'.
  761.  
  762. Answerback Message..... The  string to send across the serial line whenever
  763.                         an `ENQ' character is received.  The string is - as
  764.                         usual - a command sequence.
  765.  
  766. Redial Delay........... The  time  to  wait after walking through the whole
  767.                         dialing   list   without   making   any  successful
  768.                         connection before another attempt is started.
  769.  
  770. Number Of Dial Retries. The  number  of  times the dialer walks through the
  771.                         dialing list trying to make a successful connection
  772.                         before giving up.
  773.  
  774. Dial Timeout........... The time to wait for a successful connection during
  775.                         dialing.   After  this time has elapsed, the dialer
  776.                         will skip to the next entry in the list.
  777.  
  778. Connect Auto-Capture... If  enabled  will automatically open a capture file
  779.                         after  successfully making a connection.  Any other
  780.                         already  open  capture  file  will be closed before
  781.                         proceeding.
  782.  
  783. Connect Auto-Baud...... Most  modems  echo  the  baud  rate upon successful
  784.                         connection.  If enabled  the baud rate will be read
  785.                         and set for the serial driver.
  786.  
  787. Log Actions............ If  enabled  will  write a protocol of each program
  788.                         action (uploads, downloads, dial attempts, etc.) to
  789.                         a  file.  Each action is listed along with time and
  790.                         date.    Carrier-lost-events  will  also  note  the
  791.                         approximate cost of the call.
  792.  
  793. Check Carrier.......... `term'  will  recognize  the `NO CARRIER' message a
  794.                         modem emits when the carrier line signal drops back
  795.                         to low.  For maximum safety, `term' will also check
  796.                         the  carrier  signal  line  after receiving the `NO
  797.                         CARRIER'  message  if this switch is enabled.  This
  798.                         is  to  make  sure  that  no accidentally appearing
  799.                         string causes confusion.
  800.  
  801. Drop DTR On Hangup..... Some  modems  will  track the `data terminal ready'
  802.                         line  order  to make sure that the terminal program
  803.                         is  listening,  once  the  line  goes  back  to low
  804.                         potential, these modems will drop the line and hang
  805.                         up.   Use  this  button  to  enable  this  feature.
  806.  
  807. Pass xON/xOFF through.. If this switch is enabled, `term' will pass
  808.                         the  xON/xOFF  characters  through  to  the
  809.                         modem  rather  than  processing them on its
  810.                         own.
  811.  
  812. No Carrier String...... The  string  the modem emits if the data carrier is
  813.                         lost.   The  program  uses  this  to  determine the
  814.                         length  of  the connection and to calculate the how
  815.                         much the user is to pay for it.
  816.  
  817. Connect String......... The  string  the  modem  emits  after  detecting  a
  818.                         carrier   signal.    `term'   uses  this  input  to
  819.                         determine   successful   telephone  connection,  to
  820.                         reconfigure itself and to start the online timer.
  821.  
  822. No Dialtone String..... The  string  to be returned by the modem in case it
  823.                         does  not  encounter  any dialing tone on the phone
  824.                         line.
  825.  
  826. Voice String........... The  string  `term'  is  expected to receive if the
  827.                         modem  detects  a  voice call.  If in dialing mode,
  828.                         `term'  will  abort  the process.  The user will in
  829.                         any case be notified of the event.
  830.  
  831. Ring String............ The  string  the modem emits if it receives a call,
  832.                         same effects as with the `Voice String'.
  833.  
  834. Busy String............ The  string  the  modem returns if the number which
  835.                         has just been dialed is busy.
  836.  
  837. Use.................... Use the current settings.
  838.  
  839. Cancel................. Keep original settings.
  840.  
  841. c) Screen Settings
  842. ------------------
  843. This  menu-item will bring up a window to change all parameters of the main
  844. screen.
  845.  
  846. Display Modes........... All graphic-modes available for the main screen are
  847.                          displayed  here.   If  you  wish  to use the `Super
  848.                          Hires', the `Productivity' mode or the A2024-modes,
  849.                          you  will  have  to  put up with some restrictions:
  850.                          there  are  only screens with a depth of two (Amiga
  851.                          colourmodes) and  if   in   A2024-mode,   different
  852.                          resolutions  cannot  be  mixed  with each other any
  853.                          longer.
  854.                            Annotation:   the A2024-modes should only be used
  855.                          in   connection   with   an   A2024/Hedley-monitor.
  856.                          Otherwise  the  screen may `crash' and working with
  857.                          `term' will not be possible any longer.
  858.  
  859. Edit Screen Palette..... These  gadgets  are  used to select a colour of the
  860.                          screen palette that is to to be changed.
  861.  
  862. Red/Green/Blue.......... These  proportional-gadgets  are used to modify the
  863.                          portions of red, green or blue.
  864.  
  865. Make Screen Public...... As  dealt  with  before,  the  `term' mainscreen is
  866.                          opened  as `public'.  With this gadget the user may
  867.                          define if other applications are allowed to open up
  868.                          their windows on the `term' screen.
  869.  
  870. `Shanghai' Windows...... This  item,  that is only displayed if `Make Screen
  871.                          Public'  has  been  selected, is closely related to
  872.                          the  function  before.  If active, all windows that
  873.                          will  normally be displayed on the Workbench screen
  874.                          will open on the `term' main screen.
  875.  
  876. Use..................... Use the current settings.
  877.  
  878. Cancel.................. Keep the old settings.
  879.  
  880.   It  has  to  be  remarked  that all the `new' display-modes (Super-Hires,
  881. Productivity,  etc.)  restrict  the  number  of colours.  Instead of 16-bit
  882. portions for red, green and blue, only 2-bit portions are used, which leads
  883. to  a  maximum width of the palette of at all 64 (4 ╫ 4 ╫ 4) colours.  This
  884. is no `feature' of `term' but a hardware restriction.
  885.  
  886. d) Terminal Settings
  887. --------------------
  888. All  settings that may be done here determine the behaviour of the terminal
  889. itself, i.e.  how command sequences are interpreted and displayed.
  890.  
  891. Capture Filter......... If  selected,  command  sequences  are filtered out
  892.                         before the incoming characters are captured to disk
  893.                         or printer.
  894.  
  895. Destructive BS......... Determines  if  the  `Backspace'  code,  which will
  896.                         delete  the  character  left  from the cursor, only
  897.                         moves  the  cursor  to  the  left  or  removes  the
  898.                         character from the screen.
  899.  
  900. Swap DEL <-> BS........ For  the  hard  core VT100 user:  if this switch is
  901.                         enabled  the  roles  of  the  backspace key and the
  902.                         delete  key are reversed.  Note:  this also applies
  903.                         to sequences such as Control+H which will produce a
  904.                         delete character instead of a backspace character.
  905.  
  906. Strip Bit 8............ For  those guys & gals who need it:  if this switch
  907.                         is effect each character received or transmitted by
  908.                         `term' will have its upmost bit cleared.
  909.  
  910. Stop Blinking.......... If  selected  the VT100-blink option is suppressed.
  911.                         If  running  in eight colour mode, `term' will open
  912.                         its  screen  only  three  bitplanes deep instead of
  913.                         four bitplanes deep.
  914.  
  915. Screen Title........... Requested  by  american  users  who  obviously were
  916. Status Line............ unable  to  produce satisfying results when playing
  917.                         with  the  Overscan  preferences  tool,  these  two
  918.                         switches  allow  you  to  disable  screen title and
  919.                         status line information, thus increasing the number
  920.                         of lines available on the terminal screen.
  921.  
  922. Faster Layout.......... Activating  this  switch  will  slow  down  display
  923.                         updates   and  window  management.   Oh  well,  not
  924.                         always,  there  may  be  a speed increase with some
  925.                         configurations,  such  as  with external emulations
  926.                         activated  or  when using more than four colours on
  927.                         the screen.
  928.                            I  suggest to experiment with this button before
  929.                         actually using it.
  930.  
  931. Send CR................ This gadget determines the sequence that is sent to
  932.                         the remote if a carriage-return is issued.
  933.  
  934.                         As CR    = without any change.
  935.                         As CR+LF = carriage-return and linefeed
  936.             Ignore   = suppress any carriage-return
  937.  
  938. Send LF................ This gadget determines the sequence that is sent to
  939.                         the remote if a linefeed is issued.
  940.  
  941.             As LF    = without any change.
  942.             As LF+CR = linefeed and carriage-return.
  943.             Ignore   = suppress any linefeed.
  944.  
  945. Receive CR............. These  two  buttons have largely the same effect as
  946. Receive LF............. the  `Send  xx' buttons, they are different in that
  947.                         they  affect the incoming data rather than the data
  948.                         transmitted.
  949.  
  950. Bell................... This is where you select the action(s) `term' is to
  951.                         take  whenever  a  `bell' character turns up in the
  952.                         data stream:
  953.  
  954.                         - Visual
  955.  
  956.                           The screen will flash.
  957.  
  958.                         - Audible
  959.  
  960.                           An audible signal will be generated.
  961.  
  962.                         - Visual & Audible
  963.  
  964.                           A combination of both effects.
  965.  
  966.                         - Ignore
  967.  
  968.                           Nothing will happen.
  969.  
  970.                         - System default
  971.  
  972.                           The system beep routines will be used.
  973.  
  974. Display Size........... Usually,  the  number of characters to be displayed
  975.                         on  screen is determined by the physical dimensions
  976.                         of  the  main  screen.   But  now  and  then  a BBS
  977.                         requires  the screen to be of a fixed size, here is
  978.                         what this switch allows you to set it to:
  979.  
  980.                         - Screen Size
  981.  
  982.                           Will fit as many characters on the screen  as the
  983.                           physical screen size allows.
  984.  
  985.                         - 80 ╫ 24 (VT100)
  986.  
  987.                           As required by VT100, this will limit the  number
  988.                           of characters to be displayed on  screen  to  the
  989.                           typical 80 ╫ 24 rectangle.
  990.  
  991.                         - 80 ╫ 25 (ANSI)
  992.  
  993.                           Similar to VT100, ANSI uses a fixed screen  width
  994.                           but supports one more display line than VT100.
  995.  
  996.                         In each case, using this switch will not change the
  997.                         physical  dimensions  of  the  main  screen but the
  998.                         limits in which the cursor can be moved.
  999.  
  1000. Colour................. This gadget determines the colour-mode the terminal
  1001.                         emulation  is going to use.  Until now, three modes
  1002.                         have been implemented:
  1003.  
  1004.                         - Amiga
  1005.  
  1006.                           Four colours and blinking.
  1007.  
  1008.                         - 8 Colours (Blink)
  1009.  
  1010.                           Eight colours and blinking.
  1011.  
  1012.             - 16 Colours
  1013.  
  1014.               Sixteen colours, as the EGA-palette.
  1015.  
  1016.             - Mono
  1017.  
  1018.               Monochrome, two colours.
  1019.  
  1020. Emulation.............. At  this  point  the  user  may select the terminal
  1021.                         emulation. First there is a solid  VT102/VT220/ANSI
  1022.                         emulation   which   supports  all  common  command-
  1023.                         sequences,  then  there  is  a  so  called `Atomic'
  1024.                         emulation  which  does  only support the very basic
  1025.                         command-sequences  (CR,  LF,  Backspace, etc.), all
  1026.                         VT102-  and  ANSI-command-sequences are suppressed,
  1027.                         and,  last  but  not least, a `TTY'-emulation which
  1028.                         does   not   suppress   all  command-sequences,  as
  1029.                         `Atomic'  does,  but  rather  echoes  them  to  the
  1030.                         screen.
  1031.                            In  addition  to the builtin terminal emulation,
  1032.                         `term'  also supports external terminal emulations.
  1033.                         To  select  one, set the terminal emulation type to
  1034.                         `External'  and  enter the name of the emulation in
  1035.                         the string gadget below (the file may alternatively
  1036.                         selected  by  hitting  the  `Select  New Emulation'
  1037.                         button).   In  case  anything goes wrong loading or
  1038.                         initializing  the terminal emulation module, `term'
  1039.                         will   switch   back   to   the  builtin  `ANSI/VT'
  1040.                         emulation.
  1041.  
  1042. Emu. Name.............. The  name of an external terminal emulation library
  1043.                         to  be  used  by  `term'  instead  of  the  builtin
  1044.                         emulation code.
  1045.  
  1046. Select New Emulation... Press  this  button  to  invoke  a  file  requester
  1047.                         allowing   you  to  select  the  external  terminal
  1048.                         emulation  file  to  be used by term instead of the
  1049.                         builtin terminal emulation.
  1050.  
  1051. Font................... `term'  makes  use of two fonts to display text and
  1052.                         graphics.    `Topaz'   is   the   system-integrated
  1053.                         standard  font,  `IBM'  is  a  font  similar to the
  1054.                         Standard   IBM   PC   font   which   also  contains
  1055.                         graphics-symbols.   If `IBM' is selected input from
  1056.                         the  console  is  automatically translated into the
  1057.                         corresponding `IBM' characters.
  1058.                            Note  that  the settings affected by this switch
  1059.                         will  be  ignored  if  an  external emulation is in
  1060.                         effect.
  1061.  
  1062. KeyMap Name............ If your installation requires that `term' is to use
  1063.                         a  custom keymap layout, enter the keymap file name
  1064.                         here.
  1065.                            Note  that  at  the  time  of  this  writing the
  1066.                         program will not support custom keymap layouts with
  1067.                         the   `Packet   Window'  due  to  operating  system
  1068.                         limitations.
  1069.  
  1070. Use.................... Use the current settings.
  1071.  
  1072. Cancel................. Keep the old settings.
  1073.  
  1074. e) Commands
  1075. -----------
  1076. Here  you  will  find entries for three command sequences which serve three
  1077. functions:
  1078.  
  1079. Startup/Login Macro.... At  the  beginning of every session with `term' and
  1080.                         after  a  connection  has  been  established by the
  1081.                         dialing  routine  a  command-sequence  is  executed
  1082.                         which   may  execute  command-files  or  perform  a
  1083.                         automatical  `login'.
  1084.  
  1085. Upload Macro........... `term'  will  execute this macro after a successful
  1086.                         upload has been made.
  1087.  
  1088. Download Macro......... `term'  will  execute this macro after a successful
  1089.                         download has been made.
  1090.  
  1091. f) Miscellaneous
  1092. ----------------
  1093. This  is  the place where options can be set which would not fit into other
  1094. control panels
  1095.  
  1096. Program Priority....... Use  this  slider  to  determine the priority under
  1097.                         which   the   `term'  main  process  is  operating.
  1098.                         Adjusting  this  value can make `term' perform more
  1099.                         reliably  in  a system which experiences heavy task
  1100.                         loading.  It is recommended to play with this value
  1101.                         until  a  satisfactory  state is found, setting the
  1102.                         program  priority to high or too low may affect the
  1103.                         performance  of  coprocess  services  such  as  the
  1104.                         double-buffered file I/O routines.
  1105.  
  1106. Override Transfer Path. Each  batch  file  transfer  protocol allows you to
  1107.                         specify the name of the directory to send the files
  1108.                         it  receives  to.   By default `term' will redirect
  1109.                         the  files  to  a  directory to be specified in the
  1110.                         `Path'  control panel.  If this switch is disabled,
  1111.                         the  internal  settings  of  the  current  transfer
  1112.                         protocol will be used.
  1113.  
  1114. Backup Configuration... By  default  the  local program configuration saved
  1115.                         along  with  a  phonebook  entry  will  replace the
  1116.                         global   configuration  as  soon  as  a  successful
  1117.                         connection  is  made.   If  this switch is enabled,
  1118.                         `term'  will  remember  the global configuration in
  1119.                         effect before the configuration data of a phonebook
  1120.                         entry  is  adopted.   As  soon as the serial driver
  1121.                         loses  track  of  the  carrier  signal  or the user
  1122.                         chooses  to  hang  up  the line, `term' will switch
  1123.                         back to the previous global configuration.
  1124.  
  1125. Use Auto Upload Panel.. Some  users found the so-called `ZModem auto-upload
  1126.                         panel' to be invoked whenever `term' encounters the
  1127.                         ZModem  inquiry  sequence  rather  disturbing, this
  1128.                         switch will allow them to disable this feature.
  1129.  
  1130. Set `archived' bit..... If  enabled,  this  switch will cause `term' to set
  1131.                         the  `archived'  bit on files transferred using the
  1132.                         XPR-interface.
  1133.  
  1134. Maximum Buffer Size.... To  save  memory,  a high-water mark concerning the
  1135.                         maximum  amount  of  memory  the  `log  book'  will
  1136.                         allocate  for  text  may be specified.  The minimum
  1137.                         value  to  be  entered here is 2000 bytes which are
  1138.                         roughly equivalent to two `log book'ápages of text.
  1139.                         A value  of  0  will cause the `log book' to always
  1140.                         allocate  as  much memory as required to buffer all
  1141.                         the incoming text.
  1142.  
  1143. Buffer Enabled......... This  switch  works in conjunction with the `Freeze
  1144.                         Buffer'   menu   entry  (freezing  the  `log  book'
  1145.                         contents).   In  fact,  the  menu entry is adjusted
  1146.                         according  to the configuration settings whenever a
  1147.                         new  configuration  is invoked (that is, whenever a
  1148.                         new connection is made through the dialing panel or
  1149.                         at  program startup time).  Please note that `term'
  1150.                         will  only freeze the buffer if this switch is set,
  1151.                         it  will  leave  the  buffer  state (frozen or not)
  1152.                         untouched if this switch is not enabled.
  1153.  
  1154. Show Fast! Macros...... If  this  switch is enabled, the fast!  macro panel
  1155.                         will  be  opened whenever the current configuration
  1156.                         becomes active (e.g.  at startup time).
  1157.  
  1158. g) Paths
  1159. --------
  1160. In this part of the settings all paths, which `term' uses to save or load
  1161. any data, can be determined.
  1162.  
  1163. Config. Storage Dir.... The  directory  that will contain all configuration
  1164.                         files  (Phonebook,  Makrokeys,  etc.).  The default
  1165.                         configuration file is called `Preferences.term' and
  1166.                         will  be  searched  in  the  path  defined  by  the
  1167.                         enviroment   variable   `TERMPATH'   (see   end  of
  1168.                         document).
  1169.  
  1170. ??? Up/Downloadpath.... The directories in which the functions contained in
  1171.                         the `Transfer' menu will search and create files.
  1172.  
  1173. Capture Path........... This  gadgets  contain  the  path  in which the the
  1174.                         capture   files   will   be   created  if  `Connect
  1175.                         Auto-Capture' is enabled.
  1176.  
  1177. Log File............... The  name  of  the file in which the information on
  1178.                         the  actions  executed  by `term' will be logged if
  1179.                         `Log Actions' is enabled.
  1180.  
  1181. Text Editor............ Contains  the  name  and  search path of the editor
  1182.                         used by `Edit File' in the Utilities menu.
  1183.  
  1184. Terminal `Beep' Sound.. The  name of the IFF-sound-file that will be played
  1185.                         if  a  BEL-signal  is  detected.  This file may for
  1186.                         technical reasons not be larger than 102400 bytes.
  1187.  
  1188. Use.................... Use the current settings.
  1189.  
  1190. Cancel................. Keep the old settings.
  1191.  
  1192.    If  any  `Select'  button is pressed, the path or filename beside can be
  1193. selected by the file-requester.
  1194.  
  1195. h) Emulation
  1196. ------------
  1197. The  gadgets  found here allow you to change the internal parameters of the
  1198. selected emulation.
  1199.    The  following  text  only describes the parameters to change when using
  1200. the  builtin  terminal  emulation;  if an external terminal emulation is in
  1201. effect,  this  menu  will  conjure  up  the  corresponding  parameters menu
  1202. supported by the external terminal emulation module.
  1203.  
  1204. Smooth Scrolling....... If active, the each carriage-return code will cause
  1205.                         the contents of the screen to scroll up smoothly.
  1206.  
  1207. Wrap Characters........ This  function  activates  the automatical carriage
  1208.                         return  function  which is triggered as soon as the
  1209.                         cursor  crosses  the right screen margin.  To avoid
  1210.                         unpleasant  side-effects,  this  gadget  should  be
  1211.                         activated all the time.
  1212.  
  1213. Wrap Cursor............ According  to  the  VT100-specification  the cursor
  1214.                         movements  have to stop at the edges of the screen.
  1215.                         In  spite  of  this  the  cursor  may  leave  these
  1216.                         borders, especially in ANSI-mode, and may appear at
  1217.                         the   other   side  of  the  screen.   This  gadget
  1218.                         activates a more `tolerant' mode.
  1219.  
  1220. Insert Mode............ Normally,  `term'  is in overwrite-mode (characters
  1221.                         entered  overwrite the contents of the screen).  If
  1222.                         this  gadget  is  activated,  typed  characters are
  1223.                         inserted by pushing all the characters right of the
  1224.                         cursor towards the right margin.
  1225.                           Note:   the insert-mode does only work for lines.
  1226.                         If  characters  are  pushed  out of the screen they
  1227.                         cannot be restored.
  1228.  
  1229. New Line Mode.......... This  gadget activates a special mode in which some
  1230.                         VT100-control-sequences  cause  `term' to perform a
  1231.                         linefeed  instead  of  clearing the screen or other
  1232.                         serious changes of the contents of the screen.
  1233.  
  1234. Numeric Keypad......... If  this  mode is activated the keys of the numeric
  1235.                         keypad  transmit  a  command-sequence  instead of a
  1236.                         number.    If   the  remote  computer  needs  these
  1237.                         sequences,  this  mode - applications mode - can be
  1238.                         activated with this gadget.
  1239.  
  1240. Cursor Keys............ If  this  mode is active the cursor-keys transmit a
  1241.                         command-sequence  instead of a cursor-move.  If the
  1242.                         remote  computer needs these sequences, this mode -
  1243.                         applications  mode  -  can  be  activated with this
  1244.                         gadget.
  1245.  
  1246. Font Scale............. VT-100 offers several  different  sizes  of  fonts.
  1247.                         Some can be selected with this gadget:
  1248.  
  1249.                         - Normal
  1250.  
  1251.                           The normal height of the font.
  1252.  
  1253.                         - Half Width
  1254.  
  1255.                           Half width of font.
  1256.  
  1257. Use.................... Use the current settings.
  1258.  
  1259. Cancel................. Keep the old settings.
  1260.  
  1261.  
  1262.                       Now for the global settings:
  1263.  
  1264.  
  1265. a) Macro Settings
  1266. -----------------
  1267. This  menu is used to set user definable strings for all ten function keys.
  1268. All strings are considered command sequences, a topic which will be covered
  1269. later in this document.
  1270.  
  1271. Modifier.............. All  in all 40 Keys may be covered with user defined
  1272.                        command  sequences.   As the Amiga keyboard only has
  1273.                        ten  function-keys  this gadget switches between the
  1274.                        modifier   keys  (shift,  control,  alt)  which,  if
  1275.                        pressed  in  addition  which  a  function  key, will
  1276.                        execute one of the 40 command sequences.
  1277.  
  1278. Load.................. Load the macro-keys from a file.
  1279.  
  1280. Save.................. Save the macro-keys to a file.
  1281.  
  1282. Use................... Use the current settings.
  1283.  
  1284. Cancel................ Keep the old settings.
  1285.  
  1286.    As   the   definition  of  the  function  keys  with  command  sequences
  1287. contradicts  the  standard  definition  of  the  four  functions  keys of a
  1288. VT-100-terminal,  the  keys  F1-F4,  which  may be executed by pressing the
  1289. shift key and the approriate function-key simultaneously, are mapped to the
  1290. standard  sequences  for  function-keys.  The user may - of course - change
  1291. these settings.
  1292.    If  an  external terminal emulation happens to be active, those function
  1293. keys  the emulation has allocated for itself will be disabled and cannot be
  1294. edited.
  1295.  
  1296. b) Fast! Macro Settings
  1297. -----------------------
  1298. The design and implementation of the settings to be configured in this menu
  1299. are  closely  related  to the menu entry `Macro Settings' discussed before,
  1300. the  only  difference  to  be  seen  in the fact that the fast!  macros are
  1301. mapped  to  buttons  rather than function keys (more on this topic later in
  1302. this document).
  1303.  
  1304. Macro List............... The  list  of  macros entered yet, to edit one of
  1305.                           these,  select  it  by  clicking the mouse button
  1306.                           with the mouse pointer on it.
  1307.  
  1308. Macro.................... The  name of a macro by which it is listed in the
  1309.                           fast!  macro list.
  1310.  
  1311. Macro Code............... The  command  sequenz  associated  with  a  fast!
  1312.                           macro.   Command sequenzes are discussed later in
  1313.                           this document.
  1314.  
  1315. New...................... Appends  a  new  macro to the list.  The user may
  1316.                           then select and customize it.
  1317.  
  1318. Delete................... Removes  the  currently  selected  macro from the
  1319.                           list.
  1320.  
  1321. Load..................... Loads the macro list from a file.
  1322.  
  1323. Save..................... Saves the macro list to a file.
  1324.  
  1325. Top...................... Places the currently selected macro at the top of
  1326.                           the list.
  1327.  
  1328. Up....................... Moves the currently selected macro one entry up.
  1329.  
  1330. Down..................... Moves  the  currently  selected  macro  one entry
  1331.                           down.
  1332.  
  1333. End...................... Places the currently selected macro at the end of
  1334.                           the list.
  1335.  
  1336. c) Hotkeys
  1337. ----------
  1338. This  is  where  the  key  sequences used to arrange screens and to execute
  1339. special functions are to be configured.
  1340.  
  1341. term Screen To Front.. The keys to press to bring the `term' screen to the
  1342.                        front.
  1343.  
  1344. Buffer Screen To Front The  keys  to  press to bring the screen of the log
  1345.                        book  process to the front (note:  if the screen is
  1346.                        not   already   open,   pressing  these  keys  will
  1347.                        accomplish nothing).
  1348.  
  1349. Skip Dial Entry....... As  an  alternative  to the `Skip' gadget, pressing
  1350.                        these keys will skip a dialing entry if the dialing
  1351.                        function is currently active.
  1352.  
  1353. Commodity Priority.... The commodity priority to assign this task to.  You
  1354.                        may want to change this value if you have more than
  1355.                        one   program  running  which  uses  the  same  key
  1356.                        sequences  as  `term'.  The program with the higher
  1357.                        commodity  priority  will  receive  the  keystrokes
  1358.                        first.
  1359.  
  1360. Hotkeys enabled....... Whether  the  hotkeys  are  enabled  or  not can be
  1361.                        toggled by clicking on this gadget, or by using the
  1362.                        `Exchange'    program    to   be   found   in   the
  1363.                        `Tools/Commodities' drawer.
  1364.  
  1365. Load.................. Loads the hotkey settings from a file.
  1366.  
  1367. Save.................. Saves the hotkey settings to a file.
  1368.  
  1369. Use................... Use the current settings.
  1370.  
  1371. Cancel................ Keep the original settings.
  1372.  
  1373.    If  any  changes  made  here do not seem to take effect immediately, the
  1374. user has probably typed a keyword wrong (causing the entire hotkey setup to
  1375. fail).   I'm  sorry  about  this,  but the current implementation of hotkey
  1376. support does not sport error checking.
  1377.  
  1378. d) Speech
  1379. ---------
  1380. If  enabled, the Amiga speech synthesizer will be used to alert the user of
  1381. certain  actions, such as carrier lost, connection made, etc.  This feature
  1382. makes  sense  if  `term' is running in the background where the user cannot
  1383. see what is actually happening on the main screen.  By default this feature
  1384. is disabled.
  1385.  
  1386. Rate.................. Speaking speed in words per minute.
  1387.  
  1388. Pitch................. The  greater  this  value,  the  higher  the  voice
  1389.                        appears to speak.
  1390.  
  1391. Frequency............. Voice frequency in Hertz.
  1392.  
  1393. Volume................ The volume of the voice.
  1394.  
  1395. Sex................... Enabled female or male voice.
  1396.  
  1397. Speech enabled........ Toggles the activity of the speech synthesizer.
  1398.  
  1399. Speak!................ Speaks  a  small sample text, note that speech must
  1400.                        be enabled for this function to work.
  1401.  
  1402. Load.................. Loads the speech settings from a file.
  1403.  
  1404. Save.................. Saves the speech settings to a file.
  1405.  
  1406. Use................... Use the current settings.
  1407.  
  1408. Cancel................ Keep the original settings.
  1409.  
  1410.  
  1411. ===================== Telephone book & Dial function ======================
  1412. ===========================================================================
  1413. The  functions  described in the following can be found in the `Modem' menu
  1414. and relate to the menu entries `Phonebook', `Dial' and `Redial'.
  1415. ááá`term'  is  equipped  with  a  user friendly telephone number management
  1416. system,  the  `telephoneábook', which is operated via a Control field.  The
  1417. Control field is described in the following lines.
  1418.  
  1419. a) The main control panel
  1420. -------------------------
  1421.  
  1422. NameáList..............áThe  list  of  all  telephone  numbers  with  names
  1423. ááááááááááááááááááááááááagainst  them  (name of the corresponding mailbox).
  1424.                         If  one  of these entries is selected with a double
  1425.                         click,  it will be placed at the end of the dialing
  1426.                         list (More on this later).
  1427.  
  1428. BBS Name...............áName of the last selected telephone book entry.
  1429.  
  1430. Phone Number...........áTelephone  number  of  the  last selected telephone
  1431.                         book entry.
  1432.                            If  a  BBS  supports  multiple  lines, the phone
  1433.                         number  of each line may be entered, each separated
  1434.                         by   a   vertical   bar   `|'  character  (example:
  1435.                         "123456|654321"  would cause the dialing routine to
  1436.                         dial  the  numbers  `123456'  and  `654321').   The
  1437.                         dialing   routine  will  process  all  these  phone
  1438.                         numbers  before  proceeding  to  the next phonebook
  1439.                         entry.
  1440.                            The `|' character also works for the modem init,
  1441.                         modem exit and dial prefix sequences.  Whenever the
  1442.                         dialing  routine  dials another phone number from a
  1443.                         list  separated  by  bars,  it  will  try to find a
  1444.                         matching  init/exit/dial  prefix sequence.  If more
  1445.                         phone  numbers  are  specified  than  sequences are
  1446.                         available,  it will use the last sequence given (an
  1447.                         example:    a   phone   number   may  be  given  as
  1448.                         "123456|654321|12345",  the  dial prefix string may
  1449.                         be  "ATDP|ATDT";  the dialing routine will call the
  1450.                         first  number using "ATDP123456", the second number
  1451.                         using  "ATDT654321"  and the third number, since no
  1452.                         special  dial  prefix  is  available,  again  using
  1453.                         "ATDT12345").
  1454.  
  1455. NewáEntry..............áGenerates  a new telephone book entry with standard
  1456.                         settings  and places it at the end of the telephone
  1457.                         book.
  1458.  
  1459. Clone Entry............ Will  duplicate  the  currently  selected phonebook
  1460.                         entry and place it at the end of the list.
  1461.  
  1462. RemoveáEntry...........áRemoves the last selected telephone book entry from
  1463. ááááááááááááááááááááááááthe  telephone  book and frees the memory allocated
  1464. ááááááááááááááááááááááááfor this entry.
  1465.  
  1466. Dial List.............. Will  pass  the  list of currently marked phonebook
  1467.                         entries to the dialing routine.
  1468.  
  1469. Clear List............. Will  clear  the marks set for each telephone entry
  1470.                         in the dialing list.
  1471.  
  1472. Play Number............ Plays the currently selected telephone number using
  1473.                         Touch-Tone« signal coding.
  1474.  
  1475. Load List..............áLoads the contents of a telephone book from a file.
  1476.  
  1477. Sort List..............áIf  any  phonebook entries have been selected to be
  1478.                         dialed, the phonebook entries will be sorted in the
  1479.                         order  of dialing.  The remaining phonebook entries
  1480.                         will be sorted in ascending alphabetical order.
  1481.  
  1482. Save List..............áSaves the contents of a telephone book to a file.
  1483.  
  1484. Set Password........... Press  this  button  if  you wish to save a special
  1485.                         access password with the currently active telephone
  1486.                         book  file.   You  will  then be asked to enter the
  1487.                         password  (note:   what you type will appear on the
  1488.                         screen!),  only  the  first  20  characters will be
  1489.                         used.
  1490.                            To  clear  an  existant password and to save the
  1491.                         phonebook   file  without  encryption,  just  press
  1492.                         return when asked to enter the new password.
  1493.                            The  next  time you save the phonebook data, the
  1494.                         password  will  be encrypted and saved with it, the
  1495.                         phonebook  data  itself will be encrypted using the
  1496.                         password.
  1497.                            Whenever  an  encrypted phonebook file is loaded
  1498.                         and  the  password saved with it does not match the
  1499.                         last  password  you  entered,  you will be asked to
  1500.                         enter  the access password.  What you type will not
  1501.                         appear  on  the screen, press the <Return> key when
  1502.                         done,  the <Backspace> key will delete a character,
  1503.                         the  <Escape>  key  will abort the process, as will
  1504.                         closing  the  window.   The  input  process will be
  1505.                         terminated  automatically  when  20 characters have
  1506.                         been entered.
  1507.                            Note:   whenever  an encrypted phonebook file is
  1508.                         loaded,  it  will  take  longer  to  load  than  an
  1509.                         ordinary phonebook file, the same applies to saving
  1510.                         phonebook data.
  1511.  
  1512.    Another  list  is  located  at  the right hand side of the window.  Each
  1513. entry  refers  to  a  control panel to be invoked on the currently selected
  1514. telephone entry.
  1515.  
  1516. Serial, Modem, ........ These  entries  refer  directly   to  the  settings
  1517. Transfer, Screen,       main menu entries of the same name.
  1518. Terminal, Commands,
  1519. Miscellaneous,
  1520. Paths, Keyboard Macros,
  1521. Fast! Macros
  1522.  
  1523. Password/User.......... This  entry  will open a control panel in which the
  1524.                         password  and  user name to be used for the current
  1525.                         phonebook  entry can be entered.  Both password and
  1526.                         name  are  made  available  from  within the `term'
  1527.                         ARexx interface to allow auto login script files to
  1528.                         set up a connection.
  1529.  
  1530. Copy Config............ A  lot  of  time  can  be saved by copying selected
  1531.                         parts  of  the  global  configuration  to  a  local
  1532.                         configuration  which  part  of  a  phonebook entry.
  1533.                         This entry will invoke a control panel which allows
  1534.                         to  select  which parts of the global configuration
  1535.                         should be copied.  The control panel also remembers
  1536.                         which  parts  were  copied when it was invoked last
  1537.                         time.
  1538.                            If  the  `Copy  To  All' button is selected, the
  1539.                         configuration  data  to be copied will be copied to
  1540.                         all phonebook entries.
  1541.  
  1542. b) Rates - support for call fee calculation
  1543. -------------------------------------------
  1544. `term' will count the minutes you are online and connected to a BBS as soon
  1545. as  a  connection  is  made  through  the  dialing routine.  As soon as the
  1546. connection  is  lost  or you hang up, `term' will use the information to be
  1547. specified in this control panel to calculate the amount of money to be paid
  1548. for the call.
  1549.    Although  the  design of this control panel refers largely to the german
  1550. telephone  system  I  hope  that  it will be applicable to other countries'
  1551. telephone systems as well.  Please tell me if this is not the case.
  1552.  
  1553. Pay/Unit............... The amount of money to be paid for each single time
  1554.                         unit  when  online.   This fee must be given in the
  1555.                         smallest  currency  unit  available  (pence, cents,
  1556.                         centimes, etc.).
  1557.  
  1558. Seconds/Unit........... This  is where you enter how many seconds each time
  1559.                         unit lasts.
  1560.  
  1561. Start Time............. Here  you  can  adjust  the time at which telephone
  1562.                         company  will  switch to the current pay/unit rate.
  1563.                         In  Germany, the Deutsche Bundespost will switch to
  1564.                         a  cheaper  rate  after  6:00  pm and return to the
  1565.                         original  rate at 8:00 am in the morning.  The main
  1566.                         purpose of this field is to offer support for these
  1567.                         periodic  changes.   If your telephone company does
  1568.                         not  change  its  rates  in  such  manner, set both
  1569.                         settings  (Starting  time  and  ending time) to the
  1570.                         same values.
  1571.  
  1572. Days And Dates......... This  list  contains  the default rate settings and
  1573.                         exceptions  for certain dates and days of the week.
  1574.                         Each  line  displays  the  type  of the entry and a
  1575.                         comment  (separated  by  the  `╗'  character).  The
  1576.                         following types are available:
  1577.  
  1578.                         - Day(s)
  1579.  
  1580.                           Settings for certain days of the week
  1581.  
  1582.                         - 12. Jan (example)
  1583.  
  1584.                           Settings for a specific date
  1585.  
  1586.                         If there is no special type available for an entry,
  1587.                         it's  probably the default settings you are dealing
  1588.                         with.   These  settings  are  used  whenever `term'
  1589.                         cannot find an entry for the current day.
  1590.  
  1591. Add Date............... Will  invoke  a  control panel to create a new rate
  1592.                         entry  to  be  used  on  a  specific date.  Use the
  1593.                         sliders  and  button to select the day the settings
  1594.                         will be valid for.
  1595.                            Caution:   the  control  panel will allow you to
  1596.                         enter  nonexistant  dates,  such as 31.  Feb so you
  1597.                         will  have  to  make sure that the date in question
  1598.                         really exists.
  1599.  
  1600. Add Day(s)............. Will  create  a  new rate entry referring to one or
  1601.                         more  days  of  the  week.   Use the buttons of the
  1602.                         control  panel  to  select  the  days  the  current
  1603.                         settings will be valid for.
  1604.  
  1605. Import................. Much work can be saved if the rate settings for the
  1606.                         current  phonebook  entry  are imported (or copied)
  1607.                         from a different phonebook entry.  To do so, select
  1608.                         this  button.   The control panel to be opened will
  1609.                         display the list of phonebook entries available and
  1610.                         three buttons:
  1611.  
  1612.                         - Replace Units
  1613.  
  1614.                           The  rate settings of the current phonebook entry
  1615.                           will  be replaced by the settings of the selected
  1616.                           entry.
  1617.  
  1618.                         - Append Units
  1619.  
  1620.                           The  rate  settings of the selected entry will be
  1621.                           appended to the current phonebook entry.
  1622.  
  1623.                         - Cancel
  1624.  
  1625.                           Will abort the selection.
  1626.  
  1627.    Whenever   a  rate  entry  is  selected,  the  corresponding  parameters
  1628. (Pay/Unit, Seconds/Unit, Start Time) can be edited.  If the entry refers to
  1629. a  certain date or a specific day of week three additional buttons are made
  1630. available:
  1631.  
  1632. Edit................... Just  as the labels says will allow you to modify
  1633.                         an entry after it has been created.
  1634.  
  1635. Clone.................. Will  duplicate the current rate entry and append
  1636.                         it to the list.
  1637.  
  1638. Remove................. Removes an entry from the list.
  1639.  
  1640. c) Dialing and selecting a phonebook entry
  1641. ------------------------------------------
  1642. To  put  a phonebook entry into the dialing list, double-click the mouse on
  1643. its  name.   The  number  appearing  to  the left of its name indicates the
  1644. precedence  of  entries  in  the dialing list.  To remove an entry from the
  1645. list,  double-click  it again.  Instead of double-clicking on an entry, the
  1646. space bar may be pressed as well.
  1647.    To  dial  the  list  of  selected entries, press the `Dial List' button,
  1648. control will be passed over to the dialing panel.
  1649.    As  I have been asked several times:  For dialing a telephone number the
  1650. dialing  prefix  specified  for  this  telephone  number  is  used.  If the
  1651. MNP-error  correction for a certain mailbox has to be specifically switched
  1652. on  via the dial string, this has to be done in the modem settings for this
  1653. mailbox  and not in the global settings of `term'.  The `Modem Init-String'
  1654. and  `Modem Exit-String' entries of the telephone book can also be used for
  1655. initialisation.
  1656.  
  1657.    áááThe following information about the dialling process is displayed:
  1658.  
  1659. Calling................áThe  name  of the telephone book entry belonging to
  1660.                         the   number  being  dialled.   If  it  is  just  a
  1661.                         telephone     number     the     string    constant
  1662.                         `--áUnknowná--'  is shown, meaning that the name of
  1663.                         the mailbox is unknown.
  1664.  
  1665. Number.................áThe telephone number being dialed or _just_ dialed.
  1666.  
  1667. Next...................áThe  name of the telephone book entry which will be
  1668.                         processed next if no connection is established.  If
  1669.                         no  further  entry  exists,  `--  None  --' will be
  1670.                         displayed.
  1671.  
  1672. Timeout................áA counter which is decreased every second and which
  1673.                         reflects   the   time   remaining  to  establish  a
  1674.                         connection  or  to  cycle  through  the  dial queue
  1675.                         again.
  1676.  
  1677. Attempt................áThis  field shows the number of unsuccessful cycles
  1678.                         made  through  the  dialing  queue to  establish  a
  1679.                         connection.
  1680.  
  1681. Message................áA message to the user. This can be:
  1682.  
  1683.                         - Dialing...
  1684.  
  1685.                           A dial is in process.
  1686.  
  1687.                         - Line Is Busy.
  1688.  
  1689.                           The dialed number is engaged.
  1690.  
  1691.                         - Incoming Call!
  1692.  
  1693.                           The Modem has been called from another Modem.
  1694.  
  1695.                         - Incoming Voice Call!
  1696.  
  1697.                           The  Modem  is  receiving  a  call  which was not
  1698.                           originated by another Modem.
  1699.  
  1700.                         - No dialtone detected!
  1701.  
  1702.                           The modem was unable to detect any  dialing  tone
  1703.                           on the line, it may possibly be not connected.
  1704.  
  1705.                         - Connection Established.
  1706.  
  1707.                           Nomen est omen!
  1708.  
  1709.                         - Maximum Number Of Dial Retries Reached!
  1710.  
  1711.                           Also nomen est omen.
  1712.  
  1713.                         - Dial Attempt Timeout.
  1714.  
  1715.                           The  time available to establish a connection has
  1716.                           been reached or exceeded.
  1717.  
  1718.                         - Redial Delay...
  1719.  
  1720.                           Pause  until  the  next cycle through the dialing
  1721.                           queue.
  1722.  
  1723. áááAdditionally  three  buttons  can  be  found  in  the input field, which
  1724. initiate the following functions.
  1725.  
  1726. SkipáCall...............áWith  this function the current dialing attempt is
  1727.                          cancelled and the next number is processed.  If no
  1728.                          succeeding  telephone  number  exists `term' waits
  1729.                          for the next cycle through the dial queue or until
  1730.                          `Skip Call' is `pressed' again.
  1731.                             There also is a hotkey combination available to
  1732.                          accomplish the same effect.
  1733.  
  1734. Remove.................. This  button  works  in part similar to the `Skip
  1735.                          Call'   button.   Additionally,  it  removes  the
  1736.                          current phonebook entry from the dialing list.
  1737.  
  1738. GoáToáOnline............áIf  the  line  is  very noisy, the connection to a
  1739.                          mailbox has been made but the `CONNECT' signal has
  1740.                          been  lost,  you  can  use  this  button to switch
  1741.                          directly  to  the  online mode of the Modem.  This
  1742.                          will  also start the pay unit counter and the dial
  1743.                          queue will be exited.
  1744.  
  1745. AbortáDialing...........áOperation  of  this  button  exits  the dial queue
  1746.                          (leaving  the  the dial queue intact) and ends the
  1747.                          dialing process.
  1748.  
  1749. áááIf a connection is successfully made the corresponding entry in the dial
  1750. queue will be removed.
  1751.    Selecting  the  close  gadget  or  the  `Quit' menu entry will close the
  1752. window and cause the phone book panel to be reopened.
  1753.  
  1754. ============================== The Log book ===============================
  1755. ===========================================================================
  1756. The  `Log  book'  is  a function which continually stores text displayed on
  1757. `term's  mainscreen, so that the user can inform himself about the received
  1758. text at any time .
  1759.  
  1760. 1. General characteristics
  1761. --------------------------
  1762. The  "size"  of the `log book' is managed dynamically so that for every new
  1763. line which is read new memory must be allocated.  So the "size" of the `log
  1764. book'  is  limited  only  by  the  amount  of  the available memory.  It is
  1765. recommended  that the `log book' is emptied periodically to avoid using the
  1766. entire free memory.
  1767. áááIf  there  is  insufficient  memory  to `write' a new line into the `log
  1768. book', the first line will be deleted to make room for the new line.
  1769.  
  1770. 2. Operation
  1771. ------------
  1772. The  contents  of  the  `log  book' can be paged through using the keys for
  1773. moving of the cursor (`Cursor keys') (cursor keys + shift key moves page by
  1774. page,  cursor  keys  + control key jumps to the beginning or end of the log
  1775. book).   Additionally,  the  numpad keys  are overlaid with jump and paging
  1776. functions  (corresponding  to the inscriptions/graphics on the front of the
  1777. keys).
  1778. áááAdditionally there is a further menu whose functions should be explained
  1779. briefly:
  1780.  
  1781. Search.................áA search function is called which searches from the
  1782. áááááááááááááááááááááááátopmost line ON THE SCREEN downwards for an entered
  1783. áááááááááááááááááááááááásearch string.  Upper-  and  lowercase  are ignored
  1784. ááááááááááááááááááááááááwith  this  function.
  1785. ááááááááááááááááááááááááIf  the  search string is found it is displayed and
  1786.                         marked/highlighted.
  1787.  
  1788. RepeatáSearch..........áContinues the search process started with `Search'.
  1789.                         The  previously  entered  search  string is carried
  1790.                         over.
  1791.  
  1792. GoáToáMaináScreen......áSwitches to the main screen of `term'.
  1793.  
  1794. ClearáBuffer...........áClears the contents of the `log book'.
  1795.  
  1796. CloseáBuffer,áQuit.....áCloses  the  `log  book'  screen  but  leaves  the
  1797.                         contents unchanged.
  1798.  
  1799.  
  1800. ==================== Using the clipboard and the mouse ====================
  1801. ===========================================================================
  1802. Cut  &  paste functions are available on the main screen.  Use the mouse to
  1803. point  to  the first character you wish to send to the clipboard, hold down
  1804. the  (left) select button, move the mouse to the last character you wish to
  1805. cut  and release the button.  The characters you have just marked will have
  1806. been transferred to the clipboard, use the key combination Amiga+V to paste
  1807. the  contents of the clipboard and to feed them back into the input stream.
  1808. Holding  down  the  control key while clicking on a character will feed the
  1809. single  character  into  the  input  stream, it will not be buffered in the
  1810. clipboard.   Hold  down any shift key to have the contents of the clipboard
  1811. fed  into  the  input  stream  right  after the mouse button is released, a
  1812. <return>  will  follow the data (this also works on the `log book' screen).
  1813. The  middle  mouse button has the same function as if the left mouse button
  1814. when pressed along with a shift key.
  1815.  
  1816. áááWith  the  aid  of the mouse you can mark blocks in the `log book' which
  1817. are  to  be copied into the `clipboard' and which can later be fed into the
  1818. input stream with the function `Paste Clipboard Contents'.
  1819.  
  1820.    Hold  down one of the `Alt' keys and press the left mouse button to make
  1821. `term'  emit  a  number  of  cursor  move sequences which will position the
  1822. on-screen cursor at the spot where you clicked the mouse.
  1823.  
  1824.    In standard string editing fields a solution had to be found to preserve
  1825. the  line editing functions while still supporting menu shortcuts.  To undo
  1826. any  changes  made  press  Amiga+Q, to clear the string editing field press
  1827. Amiga+X.   Menus  associated  with  the  shortcuts  Amiga+Q/X are called by
  1828. holding  down  any shift key along with the Amiga keys (i.e.  Shift+Amiga+Q
  1829. will select the `Quit' menu item if available).
  1830.    Clipboard  functions  are  also  available within string gadgets:  press
  1831. Amiga+C  to  copy  the  contents  of  the gadget to the clipboard and press
  1832. Amiga+V  to  insert  the  current  clipboard contents at the current cursor
  1833. position.
  1834.  
  1835.  
  1836. ============================ Command sequences ============================
  1837. ===========================================================================
  1838. Each  character  string  sent  directly to the modem is a command sequence.
  1839. This includes telephone numbers, modem initialisation strings, function key
  1840. assignments,  etc.   In  addition  to  the  normal  ASCII character strings
  1841. various  other  commands  are  supported  which  will  be  described in the
  1842. following.
  1843.  
  1844. a) The backslash \
  1845. ------------------
  1846. The following sequences are introduced with the `\':
  1847.  
  1848. \\.....áGenerates a single backslash.
  1849.  
  1850. \a.....áExecutes an ARexx command (all text to follow this character).
  1851.  
  1852. \b.....áGenerates  a  backspace  (deletes  the character to the left of the
  1853. áááááááácursor).
  1854.  
  1855. \c..... Calls  a main menu entry, the menu entry to be called is determined
  1856.         by  the  argument  to  follow;  this  is  either a six digit number
  1857.         (example:  "\c 010203" would call subitem 1, item 2, menu 3) or the
  1858.         name  of the menu entry enclosed in single quotes to call (example:
  1859.         "\c  'about'"  would  call the `About...' menu entry, the search is
  1860.         case-insensitive and only compares the characters given).
  1861.  
  1862. \d.....áExecutes an AmigaDOS command (all text to follow this character).
  1863.  
  1864. \e.....áGenerates the escape character (ASCII code 27).
  1865.  
  1866. \f.....áGenerates  a  form feed  (skip  to  beginning of the next  page  or
  1867. ááááááááclear the screen).
  1868.  
  1869. \g.....áPlaces the string to follow this character in the clipboard.
  1870.  
  1871. \i.....áFeeds the contents of the clipboard into the input stream.
  1872.  
  1873. \n.....áGenerates a line feed.
  1874.  
  1875. \p.....áFeeds  the  password  of  the  telephone  book entry into the input
  1876.         stream  of  the  last  made  connection.   Note:   The  password is
  1877.         automaticly  cleared  for  security  reasons when the connection is
  1878.         broken.
  1879.  
  1880. \r.....áGenerates a carriage return.
  1881.  
  1882. \t.....áGenerates a tab jump.
  1883.  
  1884. \u..... Similar  to  the  \p  command, the \u command will feed the current
  1885.         user name into the input stream.
  1886.  
  1887. \x.....áGenerates a break signal (as with the `Send Break' menu entry).
  1888.  
  1889. \^.....áGenerates a caret character.
  1890.  
  1891. áááIf  none of the mentioned combinations is recognized the character which
  1892. follows the `\' will be fed into the input stream without any changes.
  1893.  
  1894. b) The caret ^
  1895. --------------
  1896. This  character  is  used  to  change the following character to a `control
  1897. character'.   So the sequence `^J' will become a Line feed and `^H' becomes
  1898. a  tab jump.  The character which follows the `^' has to be located between
  1899. `@' and `[', otherwise it is fed into the input stream without changes.
  1900.  
  1901. c) The tilde ~
  1902. --------------
  1903. This character causes the program to pause for exactly half a second before
  1904. it continues to process the following commands.
  1905.  
  1906.  
  1907. ============================== Fast! Macros ===============================
  1908. ===========================================================================
  1909. In  implementation  and design the fast!  macros are closely related to the
  1910. function key macros.  If invoked by selecting the corresponding menu entry,
  1911. a  window  will  open  on  the  right  hand  side  of the screen sporting a
  1912. scrollable  list  of  macros (the contents of this list can be edited using
  1913. the  `Fast Macros' settings menu item).  When a list entry is selected, the
  1914. associated command sequence (discussed above) will be executed.
  1915.    By using the fast!  macros it is theoretically possible to control a BBS
  1916. just  by  mouse, provided that you have the approriate macros in your fast!
  1917. macro list.
  1918.    The fast!  macro panel can be resized and acts just like the main `term'
  1919. window:   menu items can be selected and characters entered are sent to the
  1920. serial driver.
  1921.  
  1922.  
  1923. =========================== The `Packet Window' ===========================
  1924. ===========================================================================
  1925. In  this  window  a  line  can  be edited before it is sent.  All the usual
  1926. editing  functions  known from standard input fields are available (shift +
  1927. left/right jumps to the start/end of the line).
  1928. áááAdditionally  some  extended  functions  exist  which  are  performed by
  1929. pressing a cursor key together with the Shift or Control key:
  1930.  
  1931. Leftá+áControl.........áJumps to the next word.
  1932. Rightá+áControl........áJumps to the previous word.
  1933.  
  1934. Up.....................áShows the last entered command in the input line.
  1935.  
  1936. Upá+áShift.............áShows the very first command entered so far.
  1937.  
  1938. Down...................áShows  the  next entered command (if you moved back
  1939.                         for some commands before).
  1940.  
  1941. Downá+áShift...........áShows the very last command entered so far.
  1942.  
  1943. áááThis  input field has a buffer where all previously entered commands are
  1944. stored  (`Command  History').   You  can page through this buffer, load and
  1945. save  it  and  individual  lines  can be called up again.  As with the `log
  1946. book'  this  buffer  is  managed dynamically.  The same memory restrictions
  1947. that apply to the `log book' are valid for this buffer.
  1948. áááThe input line also has a menu which offers the following functions:
  1949.  
  1950. LoadáHistory...........áLoads the  contents of the input line buffer from a
  1951.                         file.   Each stored line in this file can be called
  1952.                         up and sent.
  1953.  
  1954. SaveáHistory...........áSaves  the  contents  of the input line buffer to a
  1955. ááááááááááááááááááááááááfile.
  1956.  
  1957. ClearáHistory..........áSimply  releases all previously stored commands and
  1958. ááááááááááááááááááááááááthe used memory.
  1959.  
  1960. OtheráWindow...........áSwitches to the main screen of `term'.
  1961.  
  1962. Quit...................áCloses  the  window  (corresponds  to  clicking the
  1963.                         close gadget of the window).
  1964.  
  1965. áááIt  must  be  mentioned that every character entered into this window is
  1966. shown immediately  so that those things where it is better that they should
  1967. not  appear  on the screen (like passwords for a mailbox) should be entered
  1968. in another way.
  1969. áááThe content of every input line is interpreted as a command sequence and
  1970. therefore can also contain control characters.
  1971. áááIf a line taken from the input buffer is sent without change it is _not_
  1972. stored in the buffer again (`true history' as known from `ConMan').
  1973. áááThe  contents  of  the  input buffer are cleared automatically after the
  1974. window is closed.  Under no circumstances are the contents maintained until
  1975. the next call!
  1976.    Provided  that  the packet window is large enough, a list to contain the
  1977. command line history will be displayed.
  1978.  
  1979.  
  1980. ============================= System variables ============================
  1981. ===========================================================================
  1982. Information  which  is  to be available the next time the program is run is
  1983. placed  as  AmigaDOS  variables  in  the  directory `ENV:' and `ENVARC:' by
  1984. `term'.
  1985. áááThe  variables  used  by  `term'  can  be  used and manipulated by other
  1986. programs transparently. In detail these variables are:
  1987.  
  1988. TERMPATH...............áThe  name of the directory in which all information
  1989. ááááááááááááááááááááááááused  by  `term' is placed (Standard configuration,
  1990. áááááááááááááááááááááááátelephone  book,  etc.).   The  default  setting is
  1991. áááááááááááááááááááááááá`ENVARC:term'.
  1992.  
  1993. TERMWINDOW.............áThe  window definition which can also be entered in
  1994. ááááááááááááááááááááááááthe  program  via  the  menu function  `Set Console
  1995. ááááááááááááááááááááááááWindow'.
  1996.  
  1997. xpr... ................áThe  standard  settings  used for the corresponding
  1998. áááááááááááááááááááááááátransfer protocol (xprzmodem, xprkermit, etc.).
  1999.  
  2000.  
  2001. ============== An author's request & gift-ware-remuneration ===============
  2002. ===========================================================================
  2003. The  development  of  `term'  required conciderable expense.  The effort to
  2004. find  out  by  trial and error and with a little help from the DevCon-Disks
  2005. and the Includes & Autodocs the operating principles of some routines would
  2006. alone  be  worth  a remuneration to the author (it's simply bad luck if the
  2007. Atlanta-DevCon records arrive with considerable delay).
  2008. áááThe  author is susceptible to all kinds of donation and gifts so long as
  2009. it  is  assured  that  they are useful to him (these nice little sacks with
  2010. elephant  food  are  better  sent  to  the Hannover zoo).  Therefore anyone
  2011. pleased  by  `term'  or  who  works  with  the  source  code  is welcome to
  2012. remunerate  my  programming  efforts  as  he/she  thinks that it matches my
  2013. efforts  (If  you've got no ideas yet:  I am looking for old Infocom games:
  2014. "Arthur  and  the  quest  for the holy grail", "Border zone", "Bureacracy",
  2015. "Cutthroats",  "Leather  Goddesses of Phobos", "Nord and Bert couldn't make
  2016. head  or  tail  of  it",  "Plundered Hearts", "Seastalker", "Sherlock - The
  2017. Riddle of the Crown Jewels", and "Trinity"; MS-DOS and Atari ST versions of
  2018. the  text-only  games  are  welcome  as  well since the story format can be
  2019. converted  to  the  Amiga  -- old CinemaWare games -- with the exception of
  2020. `Defender  of  the  Crown'  and  `Sinbad'  -- the source code to `ARJ' or a
  2021. Modula-2 compiler) - a lot of thanks!
  2022.  
  2023.                                 My address:
  2024.  
  2025.                                Olaf Barthel
  2026.                              Brabeckstrasse 35
  2027.                             D-3000 Hannover 71
  2028.  
  2029.                         Federal Republic of Germany
  2030.  
  2031.                    Z-Net: O.BARTHEL@A-LINK-H
  2032.                   Usenet: o.barthel@a-link-h.comlink.de
  2033.                           olsen@sourcery.mxm.sub.org
  2034.  
  2035. áááWould  those  people  looking at the source code to extend it or do some
  2036. modifications  here  and there please contact me before publication so that
  2037. our efforts can be coordinated.
  2038. áááIf  someone  should  have  a  brilliant  idea  to  improve or extend the
  2039. structure and contents of this manual, he/she may do it with my blessing (I
  2040. haven't had the enthusiasm up to now to TeXify the text).
  2041.