Provided by: seyon_2.20c-30_i386 bug

NAME

       Seyon - X11 Telecommunications Package.

SYNOPSIS

       seyon [-option ...] [-toolkit_option ...] [-- -emulator_option ...]

DESCRIPTION

       Seyon  is a complete full-featured telecommunications package for the X
       Window System. Some of its features are:

              *  Dialing  directory  that  supports  an  unlimited  number  of
              entries.  The  directory is fully mouse-driven and features call
              progress monitoring,  dial  timeout,  automatic  redial,  multi-
              number  dialing,  and  circular  redial  queue. Each item in the
              dialing directory can be configured with its own baud rate,  bit
              mask,  and script file.  The dialing directory uses a plain-text
              phone book that can be edited  from  withen  Seyon.  Seyon  also
              supports manual dialing.

              * Terminal emulation window supporting DEC VT02, Tektronix 4014,
              and ANSI. Seyon delegates its terminal emulation  to  xterm,  so
              all the familiar xterm functions such as the scroll-back buffer,
              cut-and-paste utility, and  visual  bell  are  availabe  through
              Seyon’s  terminal  emulation window. Using xterm also means that
              Seyon has a more complete emulation of VT102 than other any Unix
              or  DOS  telecommunications  program.  Other  terminal emulation
              programs can also be used with Seyon to suit  the  user’s  need;
              for  example,  color  xterm can be used to provide emulation for
              color ANSI (popular on many BBS systems), and xvt can be used if
              memory is a bit tight.

              * Script language to automate tedious tasks such as logging into
              remote hosts. Seyon’s script interpreter uses  plain-text  files
              and  has  a  syntax  similar  to  that  of  sh, with a few extra
              addtions.  It  supports  many  familiar   statements   such   as
              conditional  branching  by  if-else and looping by goto. Scripts
              may be assigned to items in the dialing directory for  automatic
              execution after a connection is made.

              *   Unlimited   number  of  slots  for  external  file  transfer
              protocols.  Protocols are activated from a mouse-driven transfer
              console that uses a plain-text file, editable from withen Seyon,
              for protocol configuration. Seyon prompts the user for filenames
              only  if  the  chosen  protocol  requires  filenames  or  if the
              transfer operation is an upload, for which  Seyon  also  accepts
              wildcards.  Multiple  download  directories can be specified for
              the different transfer slots.

              * Support  for  Zmodem  auto-download.  Seyon  detects  incoming
              Zmodem  signature  and  automatically activates a user-specified
              zmodem protocol to receive incoming files. Zmodem transfers  can
              thus be completely automatic and require no user intervention.

              *  Translation  modes.  Seyon can perfrom useful trasnlations on
              the user’s input. From example, Seyon can translate backspace to
              delete  (useful on may Unix systems), newline to carriage return
              (useful  on  many  BBS  hosts),  and  my  favorite,   meta   key
              tranlation:  to  send  keys  pressed while the meta (ALT) key is
              held down as an escape (ESC) followed  by  the  key  press.  The
              latter  mode simulates the meta key on hosts that do not support
              8-bit-clean connections and makes possible the use of  the  meta
              key in programs like Emacs on such hosts.

              * Other features: interactive setting of program parameters, on-
              line help, software  (XONN/XOFF)  and  hardware  (RTS/CTS)  flow
              control,  session  capture to a file, and temporary running of a
              local shell in the terminal emulation window.

       Seyon is intended to  be  both  simple  and  extensively  configurable.
       Almost  every  aspect  of  Seyon can be configured via the resources to
       suit the user’s taste.

OPTIONS

       Besides the toolkit options, Seyon recognizes  the  following  command-
       line switches:

       -modems <device-list>
              Overrides  the resource modems. Refer to the description of that
              resource below.  Unlike the resource, however, the list here has
              to be quoted if it consists of more than one entry.

       -emulator <terminal-emulation-program>
              Instructs  Seyon  to  use  the specified program as the terminal
              emulator.  If Seyon fails to execute that program, it will  fall
              back  to  xterm.  If this option is not given, Seyon will try to
              use seyon-emu, which should be a link to your favorite  terminal
              emulation program. Seyon will fall back to xterm in this case as
              well if it fails to execute seyon-emu.

       --     This switch instructs Seyon to pass the rest of the command-line
              to  the  terminal  emulation program. All options following this
              switch will be passed  blindly  to  the  emulator.  This  switch
              cannot be combined with -noemulator.

       -nodefargs
              Seyon  usually  invokes the terminal emulation program with some
              options to set the application name and window and  icon  titles
              (those   are   -name  Seyon  -T  "Seyon  Terminal  Emulator"  -n
              Terminal). If this switch is given, Seyon will  not  pass  those
              options  to  the  emulator.   This  is  to  accommodate terminal
              emulation programs that use a different command-line syntax than
              xterm  --  like  xvt, cmdtool, shelltool, ..etc. You can use the
              ’--’ switch to pass your own options to the emulator.

       -noemulator
              This option is valid only if Seyon  is  invoked  from  withen  a
              terminal  emulation  program in the foreground of an interactive
              shell session.  If given, Seyon will not launch a  new  terminal
              emulator,  but will use the existing one instead. You cannot use
              the ’--’ switch if this option is given.

       -script <script-file>
              Causes Seyon to  automatically  executes  the  specified  script
              after  the startup script is run. The specified script file will
              be  looked  for  according  to  the  rule  mentioned  under  the
              description of the resource scriptDirectory below.

       -entries <entries-list>
              Overrides   the   resource  defaultPhoneEntries.  Refer  to  the
              description  of  that  resource  below.  Unlike  the   resource,
              however,  the  list here has to be quoted if it consists of more
              than one entry.

       -dial, -nodial
              Overrides the resource dialAutoStart and sets it to ’on’ and  If
              both  -dial  and  -nodial are specified on the command-line, the
              override value will be set according to the last of the  two  on
              the command-line.

RESOURCES

       Besides  the  toolkit resources, Seyon defines the following proprietry
       resources:

       autoZmodem (boolean)
              Specifies whether Seyon is  to  look  for  Zmodem  auto-download
              signature.   If  enabled,  Seyon  will  detect  incoming  Zmodem
              signature  and  execute  the  action  given  by   the   resource
              autoZmodemAction  (typically  to  start  a local rz). Otherwise,
              Zmodem signature will be ignored.  Default value: on

       autoZmodemAction (string)
              Specifies a simple or compound action that will be executed when
              Zmodem  auto-download signature is detected. This action will be
              executed only if the resource autoZmodem is enabled (see above).
              Refer  to  the section entitled SeQuickKeys for a description of
              available actions.  Default value: ShellCommand($rz);

       backspaceTranslation (boolean)
              Whether to translate user’s backspace to delete. When the remote
              host is a Unix system, it’s better to set this to on, since many
              Unix systems are not happy with backspace.  Default value: off

       captureFile (string)
              The name of capture file. Seyon will write session  captures  to
              this  file  when capture is enabled. This file will be placed in
              Seyon’s  default  directory.  The  capture  file  will  not   be
              overwritten  by  successive  capture sessions. Seyon will merely
              apped new capture to its end.  Default value: capture

       connectString (string)
              The modem connect string. This the  string  response  the  modem
              gives  when  a connection is made after dialing.  Default value:
              CONNECT

       defaultBits (int)
              The default number of bits (character size). Seyon will set  the
              number  of  bits  to  this  value on startup and will use it for
              items in the dialing directory for which no  such  parameter  is
              given. Valid values are 5, 6, 7, and 8.  Default value: 8

       defaultBPS (string)
              The  default  baud  rate.  Seyon  will set the baud rate to this
              value on startup and will  use  it  for  items  in  the  dialing
              directory for which no baud rate is given.  Default value: 9600

       defaultDirectory (string)
              Seyon’s  default  directory.  When  looking for its files, Seyon
              will  first  try  this  default  directory,  then  the   current
              directory.  Seyon  will  also  put  the  capture  file  in  this
              directory.  Default value: ~/.seyon

       defaultParity (int)
              The default parity. Seyon will set the parity to this  value  on
              startup  and  will use it for items in the dialing directory for
              which no such  parameter  is  given.  Valid  values  are  0  (no
              parity), 1 (odd parity), and 2 (even parity).  Default value: 0

       defaultPhoneEntries (int array)
              This  resource  specifies a list of numbers corresponding to the
              order the entries in the dialing directory appear at. Seyon will
              highlight  (select)  those  entries  on startup and whenever you
              click ‘‘Default’’ from the dialing directory. This is useful  if
              there  is  a  set of entries that you most frequesntly dial that
              want to be highlghted automatically instead of doing that  every
              time  by  hand.  You  can override this resource by the -entries
              command-line switch.  Unlike the command-line  switch,  however,
              the  list here should not be quoted. Phonebook entries numbering
              starts at one.  No default value.

       defaultStopBits (int)
              The default number of stop bits. Seyon will set  the  number  of
              stop  bits to this value on startup and will use it for items in
              the dialing directory for which  no  such  parameter  is  given.
              Valid values are 1 and 2.  Default value: 1

       dialAutoStart (boolean)
              This  resource  specifies  that  Seyon  should start dialing the
              entries specified by the resource  defaultPhoneEntries  (or  its
              override  command-line  switch)  on startup. Seyon will commence
              dialing those entries after executing the startup script and any
              script  specified  at the command line. A more convenient way of
              automatic dialing on startup is to use the override command-line
              switch  -dial, which overrides this resource and enables. If the
              resource is enabled, it can be disabled at the command  line  by
              the  override  switch -nodial. Refer to the description of these
              switches above.  Default value: off

       dialCancelString (string)
              The string Seyon sends to the modem to cancel dialing  while  in
              progress.  Default value: ^M

       dialDelay (int)
              How  long  in  seconds  Seyon should wait after no connection is
              made withen dialTimeOut before ciculating to  the  next  number.
              Default value: 10

       dialDirFormat (string)
              This is a format string that specifies the layout of the dialing
              direcotry. The default is ’%-15s %-15s %6s %1c%1c%1c %1c%1c  %s’
              (no  quotes).   Briefly:  the  fields  represent  the host name,
              number, the baud rate, bits, parity, stop bits, whether there is
              a custom prefix, suffix, and the script name. You can understand
              more what  each  field  refers  to  by  comparing  with  dialing
              directory,  fields that use the current setting (via the keyword
              CURRENT) are designated by a  question  mark.  Notice  that  you
              cannot  change  the  order  the  items  in the dialing directory
              appear at, only the format. For example, if the numbers you call
              are  all 7-digits, your host names are short, you never use baud
              rates above 9600, and you like dashes  between  the  baud  rate,
              bits,  parity,  and stop bits fields, then you may prefer to use
              the format string ’%-10s %-8s %5s-%1c-%1c-%1c %1c%1c %s’,  which
              would be narrower than the default format.  Default value: %-15s
              %-15s %6s %1c%1c%1c %1c%1c %s

       dialPrefix (string)
              The string Seyon sends to the modem before the phone number.  To
              use  pulse  dialing,  set  this  resource to .IR ATDP .  Default
              value: ATDT

       dialRepeat (int)
              How many times Seyon should try dialing  a  number.  Seyon  will
              give  up on dialing a number if no connection is made after this
              many tries.  Default value: 5

       dialSuffix (string)
              The string Seyon sends to the modem after the phone number. This
              string has to contain a carraige return or the number will never
              get sent to the mode.  Default value: ^M

       dialTimeOut (int)
              How long in seconds Seyon should wait for a connection  to  made
              after  dialing  is complete. Seyon will cancel the dialing if no
              connection is made withen this period.  Default value: 45

       exitConfirm (boolean)
              Whether Seyon should prompt for hanguping up before exiting.  If
              off-line  and the resource ignoreModemDCD is set to ’off’, Seyon
              will not prompt  for  hanging  up  upon  exiting  even  if  this
              resource is set to Default value: on

       funMessages (string array)
              The  fun  messages  to  be  displayed  when  Seyon  has no other
              important information to show. This should be a list of  double-
              quoted  [funny]  sentences.   Default  value:  varies,  version-
              dependent

       funMessagesInterval (int)
              The  temporal  interval  in  seconds  between   successive   fun
              messages.  Default value: 15

       idleGuard (boolean)
              If  set  to  on,  Seyon  will  send  a string to the remote host
              whenever the terminal session is idle (no keyboard input) for  a
              given  amount  of  time.  The  resources  idleGuardInterval  and
              idleGuardString specify the above time interval and  the  string
              to  be sent to the remote host when idle. It is useful to enable
              this features to keep the session alive when one  is  away  from
              the  computer  for  a  while  (e.g.   to  prevent  auto-logout).
              Default value: off

       idleGuardInterval (int)
              The amount of time in seconds Seyon is to consider  the  session
              idle when there is no keyboard activity at the terminal for that
              long.  Seyon will send a string to the remote  host  every  such
              interval as long as the session is idle.  Default value: 300

       idleGuardString (string)
              The  string  to  be  sent to the remote host when the session is
              idle.  This string will be sent at a regular interval as long as
              the  sesiion  remains  idle.  Note that the current translations
              will  be  used  in  sending  this  string;   for   example,   if
              backspaceTranslation   is   enabled,  then  the  default  string
              <Space><BS> will be sent as <Space><DEL>.  Default  value:  \s^H
              (space then backspace)

       ignoreModemDCD (boolean)
              If  this  resource  is  set to ’on’, the modem DCD (Data Carrier
              Detect) status will be ignored.  Some  of  the  consequences  of
              setting this to ´on´ is that Seyon will always prompt for hangup
              (if the resource exitConfirm is set to ’on’) even if  the  modem
              DCD  status  indicates  that it is off-line, and dialing will be
              attempted even if the modem DCD status indicates that it is  on-
              line.  It  is highly recommended that you keep this set to ’off’
              unless your modem does not honor  the  DCD  line.  Consult  your
              modem’s manual for more details.  Default value: off

       hangupBeforeDial (boolean)
              When set to on, Seyon will hangup the line (if connected) before
              dialing the phone number. Otherwise, the number will  be  dialed
              without  hanging  up,  and  it  is  the user’s responsibility to
              ensure that the line is  clear  (no  connection)  when  dialing.
              Default value: on

       hangupConfirm (boolean)
              Whether  Seyon should ask for confirmation before hanging up the
              phone Default value: on

       hangupViaDTR (boolean)
              When enabled, Seyon will hangup up the modem  by  dropping  DTR.
              This  is  much  quicker  than hanging up by sending a Hayes-like
              hangup string to the modem and waiting to allow for escape guard
              time.  However, some modems and serial drivers choke on dropping
              DTR and others just don’t hangup when  DTR  is  dropped,  so  in
              these  cases  it  should  be  disabled.  If disabled, Seyon will
              hangup the modem by sending the string specified by the resource
              modemAttentionString, followed by that specified by the resource
              modemHangupString.  Default value: off

       metaKeyTranslation (boolean)
              Whether to transmit keys pressed while the  meta  (ALT)  key  is
              held  down  as  an  escape (ESC) followed by the key press. Most
              hosts do not support 8-bit sessions, and hence do not  recognize
              the  meta  key.   Therefore,  this  translation  mode  has to be
              enabled when connected to such hosts to take  advantage  of  the
              meta  key  in  programs that make use of it like Emacs.  Default
              value: on

       modemAttentionString (string)
              The string to send to the modem to get its attention (switch  to
              command  mode). This string will be sent to the modem before the
              hangup string when hangupViaDTR is disabled.  Default value: +++

       modemHangupString (string)
              The  hangup  string  to  send  to the modem when hangupViaDTR is
              disabled.  Default value: ATH^M

       modems (string)
              A list of modem devies to use. Seyon will  try  modems  in  this
              list  one  after  the other until it finds an available modem or
              the list is exhausted.  No default value.

       modemStatusInterval (int)
              This resource controls the amount of time (in  seconds)  between
              updates  to  the modem status toggles (including the clock). The
              default is five seconds, but you can set it to  one  second  (or
              any  other  number)  if  you want the toggles to be updated more
              frequently. Even if you set this to a  large  number,  Seyon  is
              intellegent  enough  to update the toggles after each connect or
              hangup.  Default value: 5

       modemVMin (int)
              This resource specifies the minimum number  of  characters  that
              should be in the buffer before the read process is satified. The
              read process will wait until that number of incoming  characters
              is  in  the  buffer  or  0.1  second  has  elapsed  between  the
              receiption of two characters before displaying the data  in  the
              buffer.  This  results in the data being displayed in chunks and
              speeds up the  terminal  display.  The  speedup  would  be  most
              noticeable on slow machnes with fast modems.

              Leave  this resource at its default (1) or set it at a low value
              (6) if you have a slow modem (e.g. 2400bps). Otherwise you might
              set  it  to  the  maximum value, which is platform-dependent but
              generally 255. If you set it to  any  number  greater  than  the
              maximum  value,  it  will  be  truncated  to  the maximum value.
              Default value: 1

       newlineTranslation (string)
              When the  Enter  key  is  pressed,  newline  character  (\n)  is
              generated.   This  resource  determines  what  to translate this
              character  to.  Three  modes  are   possible:   no   translation
              (newline),  carriage  return  (\r),  and  carriage return / line
              feed. Unix systems usually expect newline or carrage return, DOS
              systems  expect  carraige return or carriage return / line feed.
              The three keywords corresponding to the above modes are nl,  cr,
              and cr/lf.  Default value: cr

       noConnectStringX [X = 1-4] (string)
              The  response  strings given by the modem when connection fails.
              Default  values:  NO   CARRIER,   NO   DIALTONE,   BUSY,   VOICE
              (respectively)

       phonelistFile (string)
              The  name  of  the  phone list (dialing directory) file. See the
              included example to learn how this  file  should  be  formatted.
              Default value: phonelist

       postConnectAction (string)
              Specifies  a  simple  or  compound  action that will be executed
              after a connection to a remote host is made. This action will be
              executed  before running any script attached to that host in the
              dialing directory. All actions  here  have  to  be  synchronous.
              Refer   to   the   section  entitled  SeQuickKeys  below  for  a
              description of available actions.  Default value: Beep();

       protocolsFile (string)
              The name of the protocols file. This file tells Seyon what  file
              transfer  protocols are available. The user will be promted with
              a list based on this file when file transfer is to be initiated.
              Default value: protocols

       quickKey?
              Refer to the section entitled SeQuickKeys below.

       rtsctsFlowControl (boolean)
              Whether Seyon should turn on RTS/CTS hardware flow control. Make
              sure the modem is set to use this as well.  Default value: off

       scriptDirectory (string)
              Seyon’s script directory. When looking for scripts,  Seyon  will
              first  try  this  script  directory, then the current directory.
              Default value: defaultDirectory

       showFunMessages (boolean)
              Whether to display  funny  messages  when  Seyon  has  no  other
              important information to show. Seyon will display those messages
              at an interval specified  by  the  funMessagesInterval  resource
              when  there  is  no other important information to convey to the
              user. To disable the display of fun messages, this resource  has
              be set to off.  Default value: on

       startupAction (string)
              Specifies  a  simple or compound action that will be executed on
              startup. This action is executed prior to running any script (in
              case  the  -script  switch is given) or dialing any entry of the
              dialing directory (in case the -dial  switch  is  given  or  the
              resource  dialAutoStart is enabled). You can make Seyon open the
              dialing directory automatically on startup by using  the  simple
              action  ‘‘OpenWidnow(Dial);’’  as  a constituent of this complex
              action stack.  Note that running the startup script  is  just  a
              special  case  of  this  resource. Refer to the section entitled
              SeQuickKeys for a description  of  available  actions.   Default
              value: RunScript(startup);

       startupFile (string)
              Seyon’s  startup  file.  Seyon will execute all commands in this
              file upon startup. This file can have any commands acceptable as
              script  commands. The most useful command to put here is the set
              command, to set the various communications parameters.   Default
              value: startup

       stripHighBit (boolean)
              Whether to strip the high (eights) bit from incoming characters.
              If set to on, the high bit of all incoming  characters  will  be
              stripped,  which  will  make an 8-N-1 setting behave like 7-N-1,
              even though eight bits are used  for  each  character.   Default
              value: off

       xonxoffFlowControl (boolean)
              Whether  Seyon  should  turn  on XON/XOFF software flow control.
              Default value: off

SEQUICKKEYS

       Seyon allows the user to have custom  buttons,  called  SeQuickKeys  (z
       quickies),  to  which  actions  can  be attached. SeQuickKeys provide a
       convenient way via which the user can invoke frequently-used operations
       by a singe mouse click. SeQuickKeys are specified through the resources
       quickKeyX, where X is an integer corresponding to the  order  at  which
       that  SeQuickKey is to appear on the command center.  Relevant subparts
       of that resource are visible, action, and label. Here is an example:

              Seyon*quickKey3.visible: on
              Seyon*quickKey3.action: FileTransfer(1,file); Beep();
              Seyon*quickKey3.label: Upload

       The first line specifies that SeQuickKey3 should be visible. The second
       line  specifies  the  action  bound  to the SeQuickKey (in this case, a
       compound action), and the third  line  specifies  the  label  for  that
       SeQuickKey’s  button. Other subparts can also be specified in a similar
       fashion (e.g.  background, foreground, ..etc.)

       Actions can be either simple or compound. A compound action consists of
       a  stack  of  simple  actions  and  can  be used as simple mini-script.
       Examples:

       · Set(idleGuard,on); DialEntries(Default);
       · Echo("Uploading files..."); Transmit(rz); \
             FieTransfer(1,"*.ico $HOME/acct.wks"); Echo(Done);
       · OpenWindow(Dial); DialEntries("2 5 6");
       · Echo("Goodbye.."); Hangup(); Quit();
       · Set(baud,9600); ManualDial("555-5555");
       · Echo("Will upload..."); ShellCommand("$sz *.wks");
       · Set(parity,0); RunScript(login.scr); Echo(Finished);

       The following is a list of actions Seyon currently supports.  Asterisks
       designate asynchronoous actions. Brackets designate optional arguments.

       Beep ();
              Rings the bell making a short beep.

       CloseWindow(window [,...]);
              Closes (dismisses) the given windows. Currenly  the  only  valid
              argument  to  this  action  is  Dial,  which  corresponds to the
              dialing idrectory window. Example: CloseWindow(Dial);

       DialEntries(entries-list);*
              Dials entries in the dialing directory corresponding by order to
              the  given  list.  Entries  will  be  dialed  as if the user had
              selected them on the dialing directory. Entries will  be  dialed
              without  opening  the  dialing directory. You can use the action
              ‘‘OpenWindow(Dial);’’ and stack the two actions  in  a  compound
              action if you want the dialing directory to be opened.

              The  list  must be quoted if it consists of more than one entry,
              and entries should be separated by white space, not commas.   If
              the list consists of just the word ‘‘Default’’, then the entries
              given by the resource defaultPhoneEntries will be dialed,  refer
              to the description of that resource for more details.

              The  most common use of this action is attach frequesntly-dialed
              hosts to SeQuickKeys, making dialing  those  hosts  a  one-click
              operation.  If  this action is not the last in a compound action
              stack, actions specified by the resource  postConnectAction  may
              not  work  properly.  Examples: DialEntries(2); DialEntries("2 4
              5"); DialEntries(Default);

       DivertFile([file]);*
              Sends the given file to the remote host as a text upload. If the
              optional argument ‘‘file’’ is not specified, Seyon will pop up a
              dialog box asking for the file name. In  the  latter  case  this
              action  is  similar  to  clicking  Divert  from the Misc window.
              Examples: DivertFile("/tmp/acct.wks"); DivertFile();

       Echo([string]);
              Echos the given string to the terminal. Does not send it to  the
              modem  (use  Transmit  for that). If the string consists of more
              than one word, it must be quoted. Note  that  unlike  the  shell
              command  of  the  same  name,  this command does not accepts the
              switch -n but always appends  newline  to  the  string.  If  the
              argument  is  omitted,  an  empty line will be echoed. Examples:
              Echo(Hello); Echo("Hello there"); Echo();

       FileTransfer(entry, [file-list]);*
              Executes the transfer protocol corresponding  by  order  in  the
              trasfer  console (protocols file) to ‘‘entry’’. If that protocol
              requires a file name and file-list is omitted, Seyon will pop up
              a  dialog  box  asking for the file. Otherwise file-list will be
              passed to that protocol. The list must be quotes if it  consists
              of  more  than  one  word and items in it should be separated by
              white space. It can contain  wild  cards  and  shell  variables.
              Examples:       FileTransfer(1);       FileTransfer(2,acct.wks);
              FileTransfer(2,"*.wks $HOME/acct.wks");

       Hangup();
              Disconnects the line. Does not pop up a confirmation box.

       IconifyWindow(window [,...]);
              Iconifies the given windows. Valid arguments to this action  are
              Main,  Dial, and Term, corresponding respectively to the command
              center, dialing directory, and terminal emulator  windows.  When
              the argument is Term, this action will work only if the terminal
              emulator sets the  envirenment  variable  WINDOWID,  like  xterm
              does.          Examples:          IconifyWindow(Main,Dial,Term);
              IconifyWindow(Dial);

       ManualDial([number]);*
              Dials a number as if the Manual button had been clicked from the
              dialing directory. If ‘‘number’’ is specified, it will be dialed
              directly and no dialog box will be  popped  up  asking  for  the
              number.  Examples: ManualDial(555-5555); ManualDial();

       Message([string]);
              Echos  the  given  string  to the message box of Seyon’s command
              center (main window). If the string consists of  more  than  one
              word,  it  must  be quoted. If the argument is omitted, an empty
              line will be echoed.  Examples:  Message(Hello);  Message("Hello
              there"); Message();

       OpenWindow(window [,...]);
              Opens  each  of the given windows by popping it if closed or de-
              iconifying it if in an iconic state.  Valid  arguments  to  this
              action  are  Main, Dial, and Term, corresponding respectively to
              the command center, dialing  directory,  and  terminal  emulator
              windows.  When  the argument is Term, this action will work only
              if the terminal emulator sets the envirenment variable WINDOWID,
              like    xterm   does.    Examples:   OpenWindow(Main,Dial,Term);
              OpenWindow(Dial);

       Quit();
              Exits Seyon completely and returns to the shell. Does not pop up
              a confirmation box.

       RunScript([script-name]);*
              Executes  the  script  given by the file script-name. The script
              will be executed as if the user had selected it via  the  Script
              button.  If  script-name is omitted, a dialog box will be popped
              up asking for the script name. This is a very versatile  action,
              as  many  remote and local commands or series of commands can be
              performed  by  attaching  appropriate  scripts  to  SeQuickKeys.
              Examples: RunScript(login.scr); RunScript();

       Set(parameter, value);
              Sets  the specified parameter to the given value. Can be used to
              set the various communications parameters. Available  parameters
              are   listed   under  the  script  command  ‘‘set’’.   Examples:
              Set(baud,9600); Set(parity,0); Set(idleGuard,off).

       ShellCommand(shell-command);*
              Executes the given shell command via the user’s shell pointed to
              by   the   SHELL   environment  variable,  or  /bin/sh  if  that
              environment variable is not set. Note that the command  must  be
              quoted  if  it consists of more than one word. If the first non-
              space letter  of  the  command  is  the  character  ‘‘$’’,  then
              standard  input and standard output will be redirected to to the
              modem. This action can be used to execute any  external  program
              from  withen Seyon. Example: ShellCommand(ls); ShellCommand("$cd
              $HOME; sz -vv *.wks");

       Transmit(string);
              Transmits the given string to the remote host. The  string  must
              be  quoted  if  it consists of more than one word. The string is
              transmitted as  is  (no  case  conversions  are  performed).  No
              newline  character or carriage return is appended to the string,
              use the prefix characters  for  that  (e.g.  ^M,  ^J).  See  the
              discripttion   of  the  script  command  ‘‘transmit’’  for  more
              details. Example: Transmit(ls^M); Transmit("ls -CF^M");

SCRIPT LANGUAGE

       Script files can automate some tedious tasks such  as  logging  into  a
       system.   A  script  file  is  an ascii text file and may be entered or
       edited using any standard text editor.

       The script file is read line by line.  Empty lines (consisting of white
       space  only)  are  ignored.   Comments  are lines whose first non-space
       character is a pound sign (#).

       The script processor reads each script  line,  ignoring  leading  white
       space, into words. A word is defined as either:

              · a sequence of characters delimited by white space, or
              ·  a sequence of characters enclosed in single or double quotes.

       The first word of a script file is considered the command word.  If the
       last  character  of  the  command  word  is  a  colon  (:), the line is
       considered to be a label (the object of a goto statement).   Otherwise,
       it  is  assumed  to  be  a  script  command and is interpreted as such.
       Command words are case insensative.

       Some commands take one or more arguments. Each argument is parsed as  a
       single  word  as defined above.  If blanks are required in an argument,
       the argument must be quoted using single or double quotes.

   Script Command List
       Below is the description of all commands that may be used in the  Seyon
       script language:

       capture on|off (currently may not work)
              The  command  capture  on  will  enable  capture. All characters
              received during waitfor  processing  will  be  appended  to  the
              capture  file.  The  command  capture off will close the capture
              file.  This setting does not currently extend to terminal  mode.
              This may be offered in a later release.

       debug on|off
              If  the  argument  is on, all subsequent command lines processed
              will be displayed on the local screen. The exception to this  is
              lines containing a transmit command. These lines will just print
              TRANSMIT..., so that passwords, etc. can be  protected.  If  the
              argument  is  off,  scripts  will  execute  quietly (this is the
              default setting).

       dial <number>
              Dial the  specified  number.   Seyon  supports  generic  "Hayes"
              compatible  modems for dialing.  Note that this command requires
              an actual phone number. The  phonebook  is  not  used  for  this
              function.

       echo <string>
              Echos  the given string to the terminal. Does not send it to the
              modem (use transmit for that). If the string contains spaces, it
              must  be  quoted. Note that unlike the shell command of the same
              name, this command does not accepts the  switch  -n  but  always
              appends newline to the string.

       exit   Terminates  the script file prior to the end of file. Returns to
              terminal mode.

       flush  Flushes the modem, i.e. discards data written to the  modem  but
              not transmitted and data received but not read.

       goto <label>
              Goes  to  the  specified  label in the script file and continues
              execution from that point.  The  label  may  either  precede  or
              follow  the  actual  goto statement. A label is any command word
              whose last character is a colon (:).

       hanup  Hangups up the line and disconnects from the remote host.

       if, else, endif
              Syntax:
              if <condition>
                      <statements>
              [else
                      <statements>]
              endif

              Conditionally executes statements based on specified  condition.
              Seyon supports the following conditions:

              waitfor: true if the last waitfor command was successful.
              linked:  true  if  this  script  was  executed  from the dialing
              directory.

              Conditions may be negated using the prefix not or the  character
              !:

              !waitfor: true If the last waitfor command timed out.
              not waitfor: same as !waitfor above

              The  else  and endif keywords must appear on their own lines. If
              statements may not be nested.

       pause <time>
              Suspends execution of the script for  the  specified  number  of
              seconds.   This  is  usually used for timing considerations; for
              example, waiting a couple of seconds after receiving the connect
              message and typing ^C to CompuServe.

       purge  Reads  and  discards  all  data  coming  from  the modem for the
              duration of one second.

       quit   Terminates the script and exits the whole  program  (returns  to
              the shell).

       redial Redials the last number dialed using the dial command.

       send_break
              Sends a BREAK signal to te remote host.

       set <parameter> <value>
              Sets  the specified parameter to the given value. Can be used to
              set the various communications parameters  for  each  host.  The
              follwoing  is  a list of the set keywords that Seyon recognizes.
              Keywords marked with an asterisk set the current parameter only,
              not  the  default  one.  Refer  to  the corresponig resource (in
              parentheses below) for details of the function of each  keyword.

              baud* (defaultBPS)
              bits* (defaultBits)
              parity* (defaultParity)
              stopBits* (defaultStopBits)
              stripHighBit (stripHighBit)
              newlineTranslation (newlineTranslation)
              del (backspaceTranslation)
              meta_tr (metaKeyTranslation)
              xoff (xonxoffFlowControl)
              rtscts (rtsctsFlowControl)
              autozm (zmodemAutoDownload)
              idleGuard (idleGuard)

              Boolean  keywords  accept  on  or  off  as their argument, other
              keywords  accept  the  same  arguments  as   the   corresponding
              resources.

       shell <shell-command>
              Executes the given shell command via the user’s shell pointed to
              by the SHELL environment variable, or /bin/sh if the environment
              variable  SHELL is not set. Note that the command must be quoted
              if it consists of more than one word.  If  the  first  non-space
              letter  of the command is the character ’$’, then standard input
              and standard output will be redirected to  to  the  modem.  This
              command  can be used to execute any external program from withen
              Seyon. Example: shell "cd /usr/dl; rz -vv".

       transmit <text>
              Transmits the specified  text  to  the  remote  host.  The  text
              argument  should  be  quoted  (using single or double quotes) if
              there are spaces to be transmitted. The text is  transmitted  as
              is (no case conversions are performed).

              Prefix characters:

              ^  is  the  Control character prefix: the next character is made
              into a control character. For example,  ^M  is  carriage  return
              (0x0D) and ^J is newline (0x0A).
              \  is  quote prefix: the next character is transmitted verbatim.
              For example, \^ would transmit a literal ^.

       tty on|off
              This command specifies whether or not characters  received  from
              the  modem  will  be displayed on the local terminal.  Since the
              only time that the script processor looks at the  receive  queue
              is  during  waitfor  processing,  the  displays  may  look a bit
              erratic.  Use the tty off command to disable  local  display  of
              received characters during script processing.

       waitfor <text> [timeout]
              Waits  for the specified text to appear from the modem. The text
              argument should be quoted (using single  or  double  quotes)  if
              there are spaces to be transmitted.

              Special characters are interpreted the same as for transmit.  If
              the timeout argument is specified, Seyon will wait  that  number
              of  seconds  for  the string to appear.  If no timeout is given,
              Seyon defaults to 30 seconds.

              During  waitfor  processing,  characters  received  (up  to  and
              including  the  last  character  found  in  the  text  or in the
              timeout) can be captured to  a  disk  file  (if  capture  on  is
              specified),  and/or  displayed  to  the  screen  (if  tty  on is
              specified).

       when [<string-to-expect> <string-to-send>]
              Sends string-to-send  whenever  it  encounters  string-to-expect
              while waiting in a waitfor command, whatever the number if times
              string-to-expect is encountered.

              This is is useful if the order of prompts expected is not  known
              before  hand.  For  example,  some BBS systems (notably PCBoard)
              change the prompts depeding on the time of call, and a  complete
              script for such boards cannot be written using waitfor only.

              As  many  number of when commands as desired can be specified. A
              when command with  no  arguments  clears  all  outstanding  when
              commands.   waitfor  commands take precedence over when commands
              if they expect the same string.

              A typical use of this command would be:

                      when "Continue?"       "y^M"
                      when "More?"           "n^M"
                      waitfor "BBS Command?"
                      when

              The above script keeps sending "y^M" to every Continue?"  prompt
              and  "n^M"  to  every  "More?"  prompt until the the string "BBS
              Command?" is encountered. The lasy when clears  all  outstanding
              when commands.

FILES

       The  default  Seyon files are startup, phonelist, and protocols.  These
       have  to  be  in  the  current  directory,  Seyon’s  default  directory
       (~/.seyon),  or the user’s home directory. The default script directory
       is Seyon’s default directory. All of these files and directories can be
       overridden by setting the appropriate resources. See the description of
       those resources as well as the description of the files above.

SEE ALSO

       xterm(1), resize(1)

COPYRIGHT

       Seyon is Copyright (c) 1992-1993 of Muhammad M. Saggaf.  Seyon  is  not
       public domain. Permission is granted to use and distribute Seyon freely
       for any use and to sell it  at  any  price  without  reference  to  the
       copyright owner provided that in all above cases Seyon is intact and is
       not made part of any program either in whole or in part and  that  this
       copyright  notice is included with Seyon. Permission is also granted to
       modify the source as long as the modified  source  is  not  distributed
       without prior consent of the author.

BUGS

       The  script command ’set port’ is not supported in this release. If the
       action DialEntries is not the last in a compound action stack,  actions
       specified by the resource postConnectAction may not work properly.

       If  Seyon  is  hung, it can be made to exit cleanly by killing its main
       process by signal 15 (SIGTERM) from another shell. Seyon’s main process
       is the one that has the lowest PID (Process ID) number. For example, if
       ps shows:

                1100 p0 S     0:04 seyon -noemulator
                1101 p0 S     0:00 seyon -noemulator
                1102 p0 S     0:38 seyon -noemulator

       Then ‘‘kill -15 1100’’ or ‘‘kill 1100’’ would cause Seyon clean up  and
       exit gracefully.

AUTHOR

       Muhammad  M. Saggaf, alsaggaf@mit.edu. Snail Mail: Muhammad Saggaf, Box
       9863, Dhahran 31311, SAUDI ARABIA. I apologize that I may not  be  able
       to respond to all correspondence I receive.

       xcomm 2.2 was written by Eric Coe and Larry Gensch.

ACKNOWLEDGEMENT

       David  Boyce  for helpuful suggestions, the Imake file, and patches for
       clean build under gcc -Wall; Joaquim Jorge  for  the  lex/yacc  parsing
       routines  contributed  by  him; and the many people who sent me patches
       for various platforms: Fred  Appleman  (SVR4),  atae@spva.dnet.nasa.gov
       (Ultrix), Alain Hebert (SVR3.2), Peter Davies (Sun Sparc), Eric Schmidt
       (Apollo), David Sanderson (AIX), Jonathan  Bayer  (Sun),  Jeff  Johnson
       (SVR4), Glenn Geers (SVR4-Esix), Tony Vincent-Sun-Vienna (Solaris), Bob
       Smith (SunOS 3.x and sgtty  interface).  (pardon  me  if  I  forgot  to
       mention  you).  I’m  also  thankful  to all the nice people who sent me
       suggestions or bug reports.

       The MultiList widget used in the dialing directory is  written  by  the
       Free  Widget  Foundation.  You  can get it and other FWF widgets by ftp
       from a.cs.uiuc.edu.

                                                                      SEYON(1)