                 LinPac - Packet Radio Terminal for Linux
               --------------------------------------------
                               Version 0.07

                  (c) 1998 - 1999 by Radek Burget OK2JBG


                               User  manual



Contents

1  What is LinPac
2  First configuration
3  LinPac controls
     3.1 Keyboard
     3.2 Entering commands
     3.3 Initiating the connection
     3.4 Receiving and sending files
     3.5 Remote commands
4  Variables
     4.1 Special variables
5  Station database
     5.1 The station.data file format
     5.2 The 'Name' command
     5.3 Using the database
6  About macros
     6.1 Creating macros
     6.2 Commands used in macros
     6.3 Special system macros
7  Creating new commands
8  Standard applications
     8.1 File transfer protocols
     8.2 Automatic password generation
     8.3 Utilities for mail exchange
     8.4 Mail client
     8.5 Logbook
9  Copying

Appendix A: List of LinPac commands



1  What is LinPac

  LinPac is an attempt to create the packet radio terminal for Linux that
allows wide configurability and easy addition of new functions and special
functions needed by the user. The aim was to minimize the amount of 'hard
coded' functions and create the complete set of applications that can be
easy expanded and/or completely reconfigured.

  All functions described in this manual agree with the standard
configuration that comes with the distribution package.


2  First configuration

  When linpac is started for the first time, it automaticaly creates the
directory called 'LinPac' in your home directory. This directory contains
your personal LinPac configuration. When creating this directory LinPac asks
for basic information and prepares a useable configuration for you.

  LinPac functions are based on the very simple interpreted language
(actually it's not a language, it's something like the batch files
in DOS). In the LinPac home directory there is the subdirectory 'macro',
that contains all the scripts written in this language, let's call
them macros. Each macro can be run in LinPac and it implements some
action. The simplest case of the macro is normal text file, that
is just printed to the screen (or sent to the peer) when executed.
The language is described in chapter 6.

  There is a macro called 'init.mac' in the macro directory. This macro is
executed each time LinPac is started and contains the commands to setup the
callsigns and other settings. You can modify this file to change the initial
configuration of LinPac.

  You may also want to change following files

  ctext.mac - this file is executed when the peer connects and should
              contain the greeting text
  quit.mac  - this is called when user enters the Quit command (end of
              connection). It should print some farewell and disconnect.
  info.mac  - contains the information about your system

After this you should be able to make your first connection.


3  LinPac controls

  After running LinPac the main screen apears. In the standard configuraion
it's divided to five parts (described from top of the screen to bottom):

  - QSO window : this window contains the text that came from the peer and
                 also the sent text and some special messages (different
                 text colours).
  - Status line: displays your callsign, current time and some information 
                 about the current connection.
  - Editor     : allows you to enter the text you want to send to the peer 
                 or the commands you want to execute
  - Channel list: displays the list of channels whith the callsign of
                 connected users. The currently selected channel is
                 highlighted.
  - Monitor    : displays the traffic on your radio ports

  LinPac is mostly driven by commands. The commands are entered using the
editor and must start with the colon (':') in the first column. Lines that
don't begin with the colon are sent to the peer.

  LinPac allows to make eight connections simultaneously. For each
connection one channel is used. You can switch between channels by pressing
the F1 - F8 keys. Each has its own QSO window, status line and the editor.
The channel list and the monitor are common for all the channles.

  There is a special channel invoked by presing F10. This channel has no QSO
window and doesn't allow to make a connection. The text written is sent out
immediately using UI frames (beacon).


3.1 Keyboard

Following list contains the important shortcuts:

Global:

 F1 - F8                    : switch to channel 1 - 8
 F10                        : switch to monitor
 Alt-X                      : end of LinPac

QSO Window

 PgUp, PgDn, ctrl-R, ctrl-V : scroll one page up / down
 ctrl-E, ctrl-X             : scroll one line up / down
 ctrl-B                     : skip to end of buffer

Editor:

 Cursor keys, Home, End,
 Backspace, Del             : text editing
 ctrl-Y                     : delete current line
 Enter                      : send current line

Some applications (e.g. mailer) can use the whole screen. On each channel
can run only one such application at the same time. It's
possible to switch to this application using Alt-<channel_number>
(e.g. Alt-5) and switch back to terminal using F1 - F10.


3.2 Entering commands

  Each command is called using its name. Some commands can be abbreviated.
In this manual the mandatory part is always written by capital letters. The
rest is optional.
  Some commands require some extra arguments. The arguments are written
behind the command and are seperated by one or more spaces. If you want to
enter the argument containing more than one word, the argument must be
entered in quotation marks. Example:

:color red blue     - calls the 'color' command with two arguments - 'red'
                      and 'blue'
:color 'light red'  or
:color "light red"  - calls the 'color' command with one 
                      argument 'light red'

  Most of the command work on the currently selected channel. If you want to
execute the command on some other channel, you can enter the number of the
channel this way:

:connect@5 OK0PAB

In this case the 'connect' command is executed on channel 5.

The complete list of commands with descriptions is available in Appendix A.


3.3 Initiating the connection

  To initiate the connection the ':Connect' command is used. Just switch to
the channel you want to use by pressing F1 - F8 and enter the following
command:

:connect CALLSIGN

Replace the CALLSIGN with the real callsign of the station you want to
connect. The command can be abbteviated to the first leter only. Example:

:c OK0PAB

This command will initiate the connecting sequence to OK0PAB.
When your systems contains more than one radio port, you can specify its
name before the callsign like this:

:c 2:OK0PAB

This command will try to connect OK0PAB via port 2. When no port name is
used, the default one is considered. At the begining the default port is the
first port in the axports file. If you want to change the default port, just
use the command ':port'.

:port 2

This will change the default port name to '2'.

  The ':Disconnect' command is used to close the connection. It can be
abbreviated to ':d'.


3.4 Receiving and sending files
  
  The standard distrubution can receive files using plain text or binary
transfer and using file transfers protocols YAPP and Autobin. LinPac will
automaticaly start to receive the file when the peer begins to send using
the YAPP or Autobin protocols. The 7+ files are automaticaly saved too.
When you want to save the incomming text you have to use the command

:Write <filename>

The incomming text will be saved until you stop the saving using

:Write off

For receiving the plain binary file corresponding command 'WBin' can be
used. This way of transfering binary files is not recommended, use the
autobin or yapp protocol instead.

  There are following commands available for sending files:

:rprg <filename>   - sends the file using the Autobin protocol
:yput <filename>   - sends the file using the YAPP protocol
:rbin <filename>   - sends the binary file (no protocol - not recommended)
:read <filename>   - semds the text file


3.5 Remote commands

  LinPac allows the remote user to enter the commands. For remote control
all LinPac commands are available but there can be (and should be) some
restrictions for each user.

  The remote command must start with the // sequence. For example if some
connected users sends you a text '//info' your terminal will send back the
station information.

  The remote commands can be disabled using the command ':remote off' and
enabled by ':remote on'. You can also specify only some commands to be
available for remote users. The default list of available remote commands
is defined in the 'init.mac' file (the DEF_RCMD line). There is also the
posibility to enable various commands for each user. This is described in
the 'Station database' chapter.


4  Variables

  Each channel has its own set of variables. Some of the variables are used
to store the configuration data. User can create and remove the variables
and change the values of existing variables using following commands:

  :set <variable> <value>    - sets the value of the variable. If the
                               variable doesn't exist, new one is created.
  :get <variable>            - prints the value of the variable
  :unset <variable>          - removes the variable

Some examples:
  :set NAME John
  :set WHOLE_NAME 'John Williams'
  :get NAME
  :unset NAME

  The name of the variable can contain the specification of the channel. For
example the variable NAME@5 is the variable 'NAME' defined on channel 5.

  When LinPac founds the character '%' followed by the name of variable,
automaticaly replaces this text with the value of the variable. Considering
previous example the text %NAME will be replaced with John.


4.1  Special variables

  There are some special internal variables that don't allow changing their
value. Their value is set and changed directly by LinPac and this variables
can be used to add some actual information to the text. The list follows:

 %V             - LinPac version (e.g. 0.04)
 %C             - The callsign of connected station
 %N             - The name of connected station (when known), else is
                  replaced by the contents of %U macro
 %Y		- Channel callsign (mycall)
 %K		- Current channel number
 %T             - Current time
 %D             - Current date
 %B             - Audible bell
 %Z             - Current time zone
 %U             - The text used when the name is unknown. This can contain
                  other macros (typicaly %C).
 %P		- The port number
 %M		- The number of connected users
 %A		- The time since the last operator activity
 %_		- End of line (CR)
 %<		- Contents of the last line received, this is cleared by
                  reading
 %#number       - Replaced by a character with an ASCII value <number>
                  (e.g. %#27 means ESC)
 %(command)     - Replaced by the command result.
 %[expression]  - Replaced by the result of mathematical expression

Variables for use in macros only:

 %R             - the number of macro arguments (up to 9)
 %0             - the name of the macro
 %1 - %9        - macro arguments

For example try to write following text in the editor and press enter:

The time is %T and the date is %D.


5  Station database

  The station database holds various information about known stations. All
the information is stored in the 'station.data' file and can be changed
using the normal text editor or using the LinPac 'Name' command.

5.1 The station.data file format

  The information about each station is written in the paragraph starting
with the station callsign in the square brackets. Each line in the paragraph
contains one defininion like

<item_name>=<value>

The typical station information can look like this:

[OK0NMA]
NAME=PC/FlexNet Brno
TYPE=FLEXNET
LOC=JN89HE
QRG=144.8125 MHz
SYSNUM=85946

  There are no mandatory items, the user can add various items depending on
what information he wants to store. Current LinPac distribution uses
following item names for standard information:

NAME - Text information about the station, or the operator's name. LinPac
       shows this information when connected to that station.
LOC  - QRA locator of the station. Shown after connect too.
TYPE - The type of the station. For standard stations the types FLEXNET,
       THENET, FBB, BAYBOX, DIEBOX, TNOS, JNOS, DXC and TERM for user
       terminals are recomended, but you can add any other type.
LANG - The language to communicate with the station. This is currently
       supported by the macros only. When this item is set, LinPac will try
       to find the macro in the directory macro/<LANG>/.
NICKNAME - The nickname of operator.

The standard LinPac configuration also uses this item names:

TERM - What type of terminal is used. If 'ansi' is set, LinPac switches to
       the ansi-color mode after connecting this station.
ENC  - The character encoding. Used to automaticaly switch to the i/o
       character conversion.
RCMD - The list of enabled remote commands for this station
QRG  - The user frequency. Used by the logbook.
SYSNUM and PWD - Sysop password for the station. See chapter 8.2 for more
                 information.

5.2 The 'Name' command

  The 'Name' command is used to modify the station database. Running the
command without arguments results printing the name of currently connected
station. The arguments are used to modify the data:

<name>            - modify the NAME item
-l <locator>      - modify the LOC item
-t <type>         -            TYPE
-L <language>     -            LANG
-n <nickname>     -            NICKNAME
-s <item>=<value> - modify other item

The command 'Name -i' prints all information about the station. When you
need to change the information about other than connected station add the
argument -c <callsign>.

Examples:
 :Name John
 :Name -c OK2JBG -l JN89HF Radek
 :Name -i


5.3 Using the database

  After any connection establishes, LinPac reads the information about the
connected station from the database and creates the set of variables with
names STN_<database_item_name> containing the values of the items. This
variables can be used in macros as described below.


6  About macros

6.1 Creating macros

  The macro is a LinPac command that is created using the macro language and
uses other LinPac commands to perform some action. The macro can be defined
by creating the file macro/<command_name>.mac. It's possible to define the
abbreviated form of the command, this is described in chapter 'Creating new
commands'. There are two ways to define a macro:

a) Text macros
  This way is suitable for commands which are intended to produce a larger
text output (for example station information). When executing this macro,
each line that doesn't start with ':' is printed (sent out). All commands
must start with the colon. This is suitable for modifying the text output
using the IF ~ ELSE ~ ENDIF commands or for including some other commands.

b) Command macros
  A command macro must start with the line
:MACRO <name>
  Each line of a command macro is interpreted as a command (doesn't start
with the colon and doesn't need to start at the begining of line). The text
output is provided by the 'echo' command. This way is more synoptical and
allows including the comments that must start with the sequence ';;' and end
with the end of line.

The macro is called with its name. When the first arguments starts with the
'@' symbol the macro is executed from the specified label. For example
the command ':convers @SEND' will execute the macro 'convers.mac' from the
label 'SEND' (see next chapter to see how to define the label).


6.2 Commands used in macros

  The macro can contain all the LinPac and user defined commands. There are
also some special commands that can be used in macros only:

  MACRO [name]
    Start of the command script definition (see previous section).

  LABEL <label_name>
    Creates a label with specified name. In the command scripts the
    notation :<label_name> can be used.

  GOTO <label_name>
    Jump to specified label.

  IF ~ ELSE ~ ENDIF
    Conditional commands. There are two ways to specify a condition:

    - normal notation (for more than one command)
      IF <condition>
       .
       .
       (commands to be done when the codition is true)
       .
       .
      ELSE
       .
       .
       (commands to be done when the condition is false)
       .
       .
      ENDIF
      The ELSE part is not necessary - the IF ~ ENDIF notation is possible.

    - abreviated notation (for one conditional command)

      IF (<condition>) command

      The parentheses are necessary in this case.

  Following example shows how to use conditions and how to use the data from
station database. We want to create the macro, that will greet the operator
of connected station with his nickname or with his name, if the nickname is
not defined.

a) The solution using the text macro (the comments are actually not allowed
in the text macro, they are here for explanation only)

:if %(exist STN_NICKNAME) == 1      ;; when NICKNAME is defined
Hello %STN_NICKNAME                 ;; greet with the nickname
:else                               ;; else (not defined)
Hello %N !                          ;; greet with the name
:endif                              ;; (following commands are always executed)
You have connected to %Y at %T.     ;; Say your callsign and current time

b) The solution using the command macro

:macro GREETING                     ;; start the command macro
if %(exist STN_NICKNAME) == 1       ;; when NICKNAME is defined
  echo Hello %STN_NICKNAME          ;; greet with the nickname
else                                ;; else (not defined)
  echo Hello %N !                   ;; greet with the name
endif                               ;; (following commands are always executed)
echo You have connected to %Y at %T.     ;; Say your callsign and current time


6.3 Special system macros

  There are some special macros that are executed automaticaly by LinPac in
some cases:

init.mac  - This is executed when LinPac is started and its function is to
            set the callsigns, screen options, and some other parametres.

cinit.mac - This is executed always when some connection establishes.
            The distribution version of this macro sets the channel
            parametres in order to station settings in station database
            (allowed remote commands, i/o encoding, terminal type) and
            executes the logbook command to sign a start of connection.
            LinPac always passes two arguments to this macro. The first 
            (%1) argument is the callsign of connected station and the
            second (%2) argument is the callsign of the previously connected
            station that provides the connection or it's empty in case
            of direct connection.

ctext.mac - This macro is executed when some station connects to the
            terminal. It should print some greeting text. No arguments are
            passed.

cexit.mac - This is executed always when some connection closes. The
            distribution version of this macro just executes the logbook
            command to sign the end of the connection and clears the list of
            allowed remote commands. There is always one argument passed by 
            LinPac (%1) and contains the callsign of the disconnected
            station.


7  Creating new commands

  New command can be represented by the macro or by the external program
(standard linux program or special LinPac application). Macros are
placed in the $LINPACDIR/macro directory and external programs are placed
int the $LINPACDIR/bin directory. In both of this directories is the file
'commands' that contains the list of commands in that directory. You should
specify here the name of the file, the name of the command in LinPac (use
capital letters to specify the mandatory part of the command). It's not
necessary to include the macros here, if you don't want to define the
abbreviation.
  In case of external programs there is also the possibility to specify the
program flags. Currently this flags are supported:

A - Ascii mode program. LinPac provide the CR <-> LF conversion when
    communicating with this program. This is the default setting.
B - Binary mode. Disables the conversions.
C - Leaves the stdout stream of the program on the console and reads its
    stderr stream instead.
S - Reads both stdin and stderr streams of the program (shell mode).
L - Local. This program is never available as the remote command.
R - This program is always run as the remote commands (its messages are
    always sent out).
P - LinPac removes the paths from filenames that are passed as the argument
    of this command when the FIXPATH command is on. This is the security 
    option.


8  Standard applications

8.1 File transfer protocols

  At present LinPac supports two protocols for transfering files:

  - Autobin - very simple protocol suitable for short files
  - YAPP    - very sophisticated transfer protocol that provides better
              error detection and is able to resume previously interrupted
              transfer

  Usage of this protocols is described in chapter 3.4.

  LinPac can also automaticaly save incomming 7+ files. After saving all
parts of file LinPac tries to call the '7plus' program to decode the file.
Received 7+ files are not removed automaticaly.

8.2 Automatic password generation

  LinPac can automaticaly answer the password requests from following
systems: F6FBB BBS (MD2 or MD5 password), FLEXNET (older versions, the 
'magic' numbers system and newer TheNet-like system) and THENET.
  Each station you want authorize to must have the entry in the station
database. For password generation following fields must be set:

  TYPE=<station_type>
  PWD=<your_password> or
  SYSNUM=<magic_number>

  Known station types are:

  FBB     - An F6FBB BBS. The PWD field must contain your password.
  THENET  - A TheNet node. Again the PWD must contain the password.
  FLEXNET - FlexNet node. If the magic number algorithm is used (older
            versions of flexdigi) the SYSNUM field must contain your magic
            number and the PWD field mustn't be set. When the TheNet
            algorithm is used (newer versions of flexdigi), the PWD field
            must contain the password and the SYSNUM field mustn't be used.

  In case of FBB the authorization algorithm can be choosed by setting
the MD field in the station database:

  MD=5    - this value will select the MD5 algorithm
  MD=2    - this value will select the MD2 algorithm

  When no value is set, MD2 algorithm is used.

  After connecting to the station you want authorize to the authorization
sequence begins with the ':PW' command. LinPac will send the authorization
command to the station and tries to answer the authorization request using
your password. If the password is correct, authorization should finish
succesfuly.
  
8.3 Utilities for mail exchange

  LinPac contains some utilities for exchanging mail with the F6FBB BBS.
For the proper function of this utilities following variables must be
created in channel 0:

  HOME_BBS  - The AX.25 path to the home BBS including the port name. For
              example 'kiss:OK0PAB OK0NMA' is the BBS OK0PAB which can be
              connected on port 'kiss' via the node OK0NMA.
  HOME_ADDR - The full hierarchical address of the BBS. For example
              "OK0PAB.#MOR.CZE.EU".

  For setting the variable the ':SET' command can be used. For example:

:set HOME_BBS@0 "kiss:OK0PAB OK0NMA"

  The reccomended place to set this variables is the startup macro
'init.mac'. The default version of this macro contains an example of setting
this variables.
  After setting this variables following commands are available:

  :GETMSG <message_number> [<message_number> ...]
    Reads specified messages from the BBS and stores them into
  /var/ax25/mail/<BBS_callsign>/<message_number>. The directory for the BBS
  must be created before using this command (use capital letters for the BBS
  callsgin).

  :SP <address> or :SB <address>
    This commands can be used for creating new private message or the
  bulletin. The usage is the same as at the FBB BBS.

  :FORWARD
    Transfers all new messages to the BBS.

  :DELMSG <message_number>
    Marks the message for delete.

  :PACK
    Deletes all marked messages.


8.4 Mail client

  This application allows full screen message editing and browsing. It
provides the frontend to mail exchange utilities. Mail client is started
by the ':MAIL' command. After the program is started the H key shows the
operating instructions.

8.5 Logbook

  Logbook is a simple application that is started from the cinit.mac and
cexit.mac scripts (at the begining and at the end of each connection). It
creates the file in the 'log' directory for each callsign and writes here
the time when the connections were started and finished and the QRG.
  The QRG is taken from the QRG field of the station entry in station 
database. If the station has no QRG defined, the value from the QRG@0 
variable is taken.


9  Copying

LinPac is Copyright (c) 1998-1999 by Radek Burget, OK2JBG

This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the Free
Software Foundation;

This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
more details (contained in file 'license').

You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 675 Mass
Ave, Cambridge, MA 02139, USA.

----------------------------------------------------------------------------

Appendix A - LinPac commands

1) Built-in commands

 a) action commands

  ABort [address]
    Cancels an action. Some commands are cancelled without specifying any
address (e.g. autobin). Addresses for some commands:

                 action           address for abort
              ---------------------------------------------
               autobin RX/TX         autobin (or no addres)
               yapp RX/TX            yapp (or no addres)
               7plus autosave        7plus (or no addres)
               read/RBin             read (or no addres)
               write/WBin            write (or no addres)
               forward               forward (mandatory)

The most of other commands doesn't need any address.

  Connect [port:]call [digi [digi...]]
    Initiates a connection to specified station.

  Disconnect
    Disconnect actual channel.

  Echo <text>
    Prints (sends) specified text.

  FLUSH
    Flush an output buffer. (for example in scripts before disconnect or
    before requestig input)

  SYstem
    End of LinPac, cancels all connections.

  UNproto <text>
    Send specified text in an UI frame.

  VERsion
    Version information.

 b) Commands for variables handling

  SET <variable> <value>
    Assign a value to the variable. If the variable doesn't exist, it is
  created.

  UNSET <variable>
    Removes the variable.

  GET <variable>
    Returns the value of the variable. Usually is better to use macro
  %variable (see file macros.txt)

  EXISTs <variable>
    Rerurns 1 when variable exists, 0 when it doesn't exist.

 c) information commands

  ENVINFO
    Displays the actual information about the variable environment.

  PCALL
    Returns the physical callsign of the connected station (first station
  connected)
    
  UTCTime
    Returns actual UTC time (operating system value).

 d) setup commands
  
  CBell [on|off]
    When on then LinPac gives an audio signal when any station connects or
  disconnects.

  FIXPath [on|off]
    When FIXPath=ON then then the paths to files mentioned in parametres are
  ignored for external commands marked with a P flag. That means only the
  default paths are usable.

  INFOLEvel [0|1|2]
    Sets the mode of information line:
      0 - off (no connection info)
      1 - show importatnt informations
      2 - show all available informations

  KNax [on|off]
    Enable/disable sound signal when data is received.

  Language [language]
    Sets actual languge. At the time supported in scripts only.

  MYcall <call>
    Changes the channel callsign.

  REMote [on|off]
    Enables or disables remote commands.

  Port <port_name>
    Sets the default port for Connect command.

  TIMEZone [zone]
    Set the time zone. Used for information only, doesn't affect time.

  UNSrc [call]
    The source callsign for UI frames.

  UNDest [call]
    The destination address for UI frames.

  WAtch <port | 0> <pattern> <command/text>
    Starts to watch specified port (0 for all ports). When specified pattern
  is received then specified command is executed or text is sent. (commands 
  must start with a colon)


e) Screen control commands
  
  STATLINE <n>
    Places the status line to the n-th line of the screen.

  CHNLINE <n>
    Places the channel line to the n-th line of the screen.

  SWAPEDit
    Replaces the editor window with the QSO window and vice versa.

  INFOLine <nm> <text>
    Changes the specified info line text. If info line doesn't exist, it's
  created.

  REMOVEINFO <nm>
    Removes specified info line.

  TRanslate <table>
    Switches I/O character translation using specified table. Translation
  tables are stored in *.ctt files.

  TErm <type>
    Set the terminal type. If 'ansi' is entered then ANSI-color control
  sequences are interpreted.

  SCRLimit <low-limit> <high-limit>
    When the size of the window buffer exceeds the high limit, then the size
  of buffer is truncated to low-limit. The values are in bytes, default
  is 356352 and 524288 (384 and 512 kB).

  
f) system commands
  
  RESULT <text>
    Returns the text as the result of the script.


g) string commands

  STRMid <start> <length> <string>
    Returns the substring starting at <start> position and <length>
  characters long.

  STRLeft <length> <string>
    Returns the left substring of specified length.

  STRRight <length> <string>
    Returns the right substring of specified length.

  STRLen <string>
    Returns the length of the string.

  STRPos <substring> <string>
    Returns the position of the substring in the string or -1 when the string
  doesn't contain the substring.

  UPCASE <string>
    Returns the string converted into capital letters.

  
2) External commands

  Bell
    Calls the operator using an acoustic signal.

  Compose <p|b> <callsign>
    Create a private message or a bulletin for the callsign.

  DELMSG <message_number>
    Marks the message for delete.

  FORWARD
    Transmits all new messages to a BBS.

  GETMsg <numers>
    Reads the messages from BBS.

  MAIL
    Simple full-screen mail client.

  MHeard
    List of heard stations.

  Name
    Stores station name or changes a station database. (see Name -h)

  PACK
    Deletes all messages marked for delete.

  Read <filename>
    Sends specified text file.

  RPRg <filename>
    Transmits the file using Autobin protocol.

  RTt
    Measures the round trip time.

  WBin / RBin
    The same as Read / Write, but for binary files.

  Write <filename>
    Starts to write received text to the file.

  YPUT <filename>
    Transmits the file using the YAPP protocol.


3) Macros
  
  Activity
    Shows the time since the last operator activity.

  Conv
    Enter the conference.

  Info
    Local station information.

  Help
    Brief help.

  PW
    Starts the authorization to the BBS or the node.

  Quit
    Sends the quit text and disconnects.

  Users / CStatus
    List of connected users.


4) Commands for creating scripts

  MACRO [name]
    Start of the command script definition (see below).

  LABEL <label_name>
    Creates a label with specified name. In the command scripts the
    notation :<label_name> can be used.

  GOTO <label_name>
    Jump to specified label.

  IF ~ ELSE ~ ENDIF
    Conditional commands. There are two ways to specify a condition:

    - normal notation (for more than one command)
      IF <condition>
       .
       .
       (commands to be done when the codition is true)
       .
       .
      ELSE
       .
       .
       (commands to be done when the condition is false)
       .
       .
      ENDIF
      The ELSE part is not necesary - the IF ~ ENDIF notation is possible.

    - abreviated notation (for one conditional command)
      IF (<condition>) command
