white space only) are ignored.  Comments are lines whose firstnon-space character is a pound sign (#).The script processor reads each script line, ignoring leading whitespace, into \fIwords\fP. A word is defined as either:.IP.PD 0\(bu a sequence of characters delimited by white space, or.IP\(bu a sequence of characters enclosed in single or double quotes..PD.PThe first word of a script file is considered the \fIcommand word\fP.If the last character of the command word is a colon (:), the line isconsidered to be a \fIlabel\fP (the object of a \fIgoto\fP statement).Otherwise, it is assumed to be a script command and is interpreted assuch. Command words are case insensative.Some commands take one or more arguments. Each argument is parsed as asingle word as defined above.  If blanks are required in an argument,the argument must be quoted using single or double quotes.\" .SS Startup Scripts\"    When XCOMM is started up, it looks for the file ".xcomm" in the current\"    or $HOME directory.  If it is found, it is executed.  This is useful for\"    setting your "basic" parameters without having to recompile XCOMM.  For\"    example, your startup file may turn CIS <ENQ> mode off, set your baud\"    rate to 9600, and set 7BIT translation..SS Script Command ListBelow is the description of all commands that may be used in the Seyonscript language:.TP.BI "capture on|off" " (currently may not work)"The command \fIcapture on\fP will enable capture. All charactersreceived during \fIwaitfor\fP processing will be appended to the capturefile. The command \fIcapture off\fP will close the capture file.This setting does not currently extend to terminal mode. This may beoffered in a later release..TP.B debug on|offIf the argument is \fIon\fP, all subsequent command lines processedwill be displayed on the local screen. The exception to this is linescontaining a \fItransmit\fP command. These lines will just print\fITRANSMIT...\fP, so that passwords, etc. can be protected. If theargument is \fIoff\fP, scripts will execute quietly (this is thedefault setting)..TP.BI dial " <number>"Dial the specified number.  Seyon supports generic "Hayes" compatiblemodems for dialing.  Note that this command requires an actual phonenumber. The phonebook is not used for this function..TP.BI echo " <string>"Echos the given string to the terminal. Does not send it to themodem (use.I transmitfor that). If the string contains spaces, it must be quoted. Note thatunlike the shell command of the same name, this command does notaccepts the switch -n but always appends newline to the string..TP.B exitTerminates the script file prior to the end of file. Returns toterminal mode..TP.B flushFlushes the modem, i.e. discards data written to the modem but nottransmitted and data received but not read..TP.BI goto " <label>"Goes to the specified label in the script file and continues executionfrom that point. The label may either precede or follow the actual\fIgoto\fP statement. A label is any \fIcommand word\fP whose lastcharacter is a colon (:)..TP.B hanupHangups up the line and disconnects from the remote host..TP.BR if ", " else ", " endif.I Syntax: .nf\fIif\fP <condition>        <statements>[\fIelse\fP        <statements>]\fIendif\fP.fiConditionally executes statements based on specified condition. Seyonsupports the following conditions:.IP.PD 0\fIwaitfor\fP: true if the last \fIwaitfor\fP command was successful..IP\fIlinked\fP: true if this script was executed from the dialingdirectory..PDConditions may be negated using the prefix \fInot\fP or the character\fI!\fP: .IP.PD 0\fI!waitfor\fP: true If the last \fIwaitfor\fP command timed out..IP\fInot waitfor\fP: same as \fI!waitfor\fP above.PDThe \fIelse\fP and \fIendif\fP keywords must appear on their ownlines. \fIIf\fP statements may not be nested..TP.BI pause " <time>"Suspends execution of the script for the specified number of seconds.This is usually used for timing considerations; for example, waiting acouple of seconds after receiving the \fIconnect\fP message and typing^C to CompuServe..TP.B purgeReads and discards all data coming from the modem for the duration ofone second..TP .B quitTerminates the script and exits the whole program (returns to theshell)..TP.B redialRedials the last number dialed using the \fIdial\fP command..TP.BI send_breakSends a BREAK signal to te remote host..TP.BI set " <parameter> <value>"Sets the specified parameter to the given value. Can be used to setthe various communications parameters for each host. The follwoing isa list of the \fIset\fP keywords that Seyon recognizes. Keywordsmarked with an asterisk set the current parameter only, not thedefault one. Refer to the corresponig resource (in parentheses below)for details of the function of each keyword..PD 0.IP\" .IR port " (modem)"\" .IP.IR baud "* (defaultBPS)".IP.IR bits "* (defaultBits)".IP.IR parity "* (defaultParity)".IP.IR stopBits "* (defaultStopBits)".IP.IR stripHighBit " (stripHighBit)".IP.IR newlineTranslation " (newlineTranslation)".IP.IR del " (backspaceTranslation)".IP.IR meta_tr " (metaKeyTranslation)".IP.IR xoff " (xonxoffFlowControl)".IP.IR rtscts " (rtsctsFlowControl)".IP.IR autozm " (zmodemAutoDownload)".IP.IR idleGuard " (idleGuard)".PDBoolean keywords accept \fIon\fP or \fIoff\fP as their argument, otherkeywords accept the same arguments as the corresponding resources..TP.BI shell " <shell-command>"Executes the given shell command via the user's shell pointed to bythe SHELL environment variable, or /bin/sh if the environment variableSHELL is not set. Note that the command must be quoted if it consistsof more than one word. If the first non-space letter of the command isthe character '$', then standard input and standard output will beredirected to to the modem. This command can be used to execute anyexternal program from withen Seyon. \fIExample:\fP shell "cd /usr/dl;rz -vv"..TP.BI transmit " <text>"Transmits the specified text to the remote host. The text argumentshould be quoted (using single or double quotes) if there are spacesto be transmitted. The text is transmitted as is (no case conversionsare performed)..I Prefix characters:.IP.PD 0^ is the Control character prefix: the next character is made into acontrol character. For example, ^M is \fIcarriage return\fP (0x0D) and^J is \fInewline\fP (0x0A). .IP\\ is quote prefix: the next character is transmitted verbatim. Forexample, \\^ would transmit a literal ^..PD.TP.B tty on|offThis command specifies whether or not characters received from themodem will be displayed on the local terminal.  Since the only timethat the script processor looks at the receive queue is during\fIwaitfor\fP processing, the displays may look a bit erratic.Use the \fItty off\fP command to disable local display of receivedcharacters during script processing..TP .BI waitfor " <text> [timeout]"Waits for the specified text to appear from the modem. The textargument should be quoted (using single or double quotes) if there arespaces to be transmitted.Special characters are interpreted the same as for \fItransmit\fP.If the timeout argument is specified, Seyon will wait that number ofseconds for the string to appear.  If no timeout is given, Seyondefaults to 30 seconds.During \fIwaitfor\fP processing, characters received (up to andincluding the last character found in the text or in the timeout) canbe captured to a disk file (if \fIcapture on\fP is specified), and/ordisplayed to the screen (if \fItty on\fP is specified)..TP.BI when " [<string-to-expect> <string-to-send>]"Sends string-to-send whenever it encounters string-to-expect whilewaiting in a \fIwaitfor\fP command, whatever the number if timesstring-to-expect is encountered. This is is useful if the order of prompts expected is not known beforehand. For example, some BBS systems (notably PCBoard) change theprompts depeding on the time of call, and a complete script for suchboards cannot be written using \fIwaitfor\fP only. As many number of \fIwhen\fP commands as desired can be specified. A\fIwhen\fP command with no arguments clears all outstanding \fIwhen\fPcommands.  \fIwaitfor\fP commands take precedence over \fIwhen\fPcommands if they expect the same string.A typical use of this command would be:.nf        when "Continue?"       "y^M"        when "More?"           "n^M"        waitfor "BBS Command?"        when.fiThe above script keeps sending "y^M" to every Continue?" prompt and"n^M" to every "More?" prompt until the the string "BBS Command?" isencountered. The lasy \fIwhen\fP clears all outstanding \fIwhen\fPcommands..SH FILESThe default Seyon files are.IR startup ", " phonelist ", and " protocols .These have to be in the current directory, Seyon's defaultdirectory.RI ( ~/\.seyon "),"or the user's home directory. The default script directory is Seyon'sdefault directory. All of these files and directories can beoverridden by setting the appropriate resources. See the descriptionof those resources as well as the description of the files above..SH SEE ALSOxterm(1), resize(1).SH COPYRIGHTSeyon is Copyright (c) 1992-1993 of Muhammad M. Saggaf. Seyon is notpublic domain. Permission is granted to use and distribute Seyonfreely for any use and to sell it at any price without reference tothe copyright owner provided that in all above cases Seyon is intactand is not made part of any program either in whole or in part andthat this copyright notice is included with Seyon. Permission is alsogranted to modify the source as long as the modified source is notdistributed without prior consent of the author..SH BUGSThe script command 'set port' is not supported in this release. If theaction DialEntries is not the last in a compound action stack, actionsspecified by the resource postConnectAction may not work properly.If Seyon is hung, it can be made to exit cleanly by killing its mainprocess by signal 15 (SIGTERM) from another shell. Seyon's main processis the one that has the lowest PID (Process ID) number. For example,if ps shows:.nf         1100 p0 S     0:04 seyon -noemulator         1101 p0 S     0:00 seyon -noemulator         1102 p0 S     0:38 seyon -noemulator.fiThen ``kill -15 1100'' or ``kill 1100'' would cause Seyon clean up andexit gracefully..SH AUTHORMuhammad M. Saggaf, alsaggaf@mit.edu. Snail Mail: Muhammad Saggaf, Box9863, Dhahran 31311, SAUDI ARABIA. I apologize that I may not be ableto respond to all correspondence I receive.xcomm 2.2 was written by Eric Coe and Larry Gensch..SH ACKNOWLEDGEMENTDavid Boyce for helpuful suggestions, the Imake file, and patches forclean build under gcc \-Wall; Joaquim Jorge for the lex/yacc parsingroutines contributed by him; and the many people who sent me patchesfor various platforms: Fred Appleman (SVR4), atae@spva.dnet.nasa.gov(Ultrix), Alain Hebert (SVR3.2), Peter Davies (Sun Sparc), EricSchmidt (Apollo), David Sanderson (AIX), Jonathan Bayer (Sun), JeffJohnson (SVR4), Glenn Geers (SVR4-Esix), Tony Vincent-Sun-Vienna(Solaris), Bob Smith (SunOS 3.x and sgtty interface). (pardon me if Iforgot to mention you). I'm also thankful to all the nice people whosent me suggestions or bug reports.The MultiList widget used in the dialing directory is written by theFree Widget Foundation. You can get it and other FWF widgets by ftpfrom a.cs.uiuc.edu.