home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 592b.lha / TermII / English / Documentation / PANEL.doc < prev    next >
Encoding:
Text File  |  1991-12-22  |  3.8 KB  |  117 lines
  1. June 21st 1991
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                                     Term II
  15.  
  16.                                   version 1.1
  17.  
  18.                         (c) 1990,1991 - Eric GONTIER
  19.  
  20.                                    PANEL.doc
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.             INTRODUCTION
  34.  
  35.                 The "panel" is a set of 25 buttons. The user can set a name
  36.                 and a Term II command to each button. The command can
  37.                 anything recognized by Term II, like sending string (with
  38.                 the "serial_send" command), or starting an ARexx script
  39.                 (with the "rexx" command). The panel is an XCMD (eXternal
  40.                 CoMmanD), that is a process which is going to run in the
  41.                 same time than the other Amiga processes (including Term II
  42.                 and/or other XCMDs)
  43.  
  44.  
  45.  
  46.  
  47.             STARTING THE PANEL
  48.  
  49.                 There are several ways to start the panel. However, to make
  50.                 it as easy as possible to used, there is a menu entry
  51.                 "Panel..." in the main menu (short or long menu) of Term II
  52.                 for an automatic start. The user can also start the panel
  53.                 with the "panel" command, which can be used from an ARexx
  54.                 script or even an other XCMD.
  55.  
  56.                 The panel can also be started "by hand" that is by typing
  57.                 "run panel" from the CLI (the panel program must be in the
  58.                 current directory, and Term II should have been already
  59.                 started). This will install the panel as an AmigaOS
  60.                 process, which is waiting for a signal from Term II to
  61.                 start. From Term, the user will wake up the panel with the
  62.                 command xcmd_start "PANEL". (see the file XCMD.doc for more
  63.                 informations on how to start an XCMD with the xcmd_start
  64.                 command, and how to write your own XCMDs).
  65.  
  66.                 Programmers should be awared that the message port used by
  67.                 the panel is called "PANEL".
  68.  
  69.                 The panel will not be loaded in memory until the user
  70.                 select it from Term. It will be unloaded automatically when
  71.                 quitting Term.
  72.  
  73.                 The panel will read the file called panel.config to
  74.                 initialize its buttons. It is a text file, which can be
  75.                 edited in any text editor. See the paragraph CONFIGURING
  76.                 THE PANEL.
  77.  
  78.  
  79.  
  80.  
  81.             USING THE PANEL
  82.  
  83.                 Using the panel is very simple : just click the button of
  84.                 your choice to execute the command which as been set to
  85.                 this button.
  86.  
  87.  
  88.  
  89.  
  90.             CONFIGURING THE PANEL
  91.  
  92.                 User will configure the panel with a text editor by editing
  93.                 the fille called "panel.config". In the Term II
  94.                 distribution, the panel has been configured for Calvacom, a
  95.                 French information service.
  96.  
  97.                 Each line of panel.config is corresponding to a button.
  98.                 Empty lines are ignored, heading spaces are ignored, and
  99.                 lines beginning with a # are comments.
  100.  
  101.                 Look at the following example :
  102.  
  103.                     Calva; serial_send "ATDT16143061111\n"
  104.  
  105.                 This creates a button called "Calva". If the user click it,
  106.                 Term II will excute the command :
  107.  
  108.                     serial_send "ATDT1614306111\n"
  109.  
  110.                 dialing the phone number to connect to Calvacom. The ";" is
  111.                 used to separate the button name to the command assigned to
  112.                 the same button.
  113.  
  114.                 It is possible with the "rexx" command to start ARexx
  115.                 script with a single click, allowing the building of more
  116.                 complex actions, like an automatic download of files.
  117.