(This text can be exited by 'Q' or 'Escape')

After logging in, you will be asked for your terminal-emulation, default
is VT100 (compatible to VT102 (MS-Kermit) and xterm (X11)).

Next, you enter main menu. Pressing one of the highlighted keys in '[]'
starts the action cited right from it:

------

'?' (show Help):
  A short help is shown

'A' (show Manual):
  This text is shown

'I' (system configuration):
  Change to system-menu (description follows)

'D' (list directory):
  BBS always has a current directory, which contents can be listed by this
  command. On files, there date of creation, size in bytes, and name are
  shown, on a directory, '(Directory)' appears instead of date and size.
  The listing is shown by pager (description follows).

'C' (change directory):
  Changes current directory, only direct neighbordirectories can be reached.
  All possible destinations are listed in pager, by selecting one by pressing
  its according key current directory changes to it. There are two special
  names: '..' stands for the parent-directory and 'HOME' for your HOME-
  directory (it is the directory you enter on login).
  Some directories may be symbolic links, selecting one results in a longer
  jump, a return by selecting '..' will not work.
  After changing directory the real new directoryname is shown in the secound
  headerline and all directoties are listed to change further.
  To enter main menu, just press Return or Escape, the current directory is
  shown in a window.

'W' (directoryname):
  The (real) pathname of current directory is shown.

'S' (show file):
  Reading a arbitrary file inside current directory. First, all files are
  listed in pager, by pressing a key from '[]' the according file will be
  shown.

'G' (download files):
  First, all files of current directory are listed in pager, by pressing
  a key in '[]' the according file file will be selected, marked by a '*'
  on the left margin. If a already selected file is selected again, it will
  be unselected a.s.o. If all needed files selected quit by pressing 'Return'
  to start transfer (normally by Z-Modem).
  To select, regular expressions are allowed, wich can be entered after
  pressing '*'. A special meaning have: '*' matches any substring, '?' matches
  one char and '[]' matches any one char between the brackets (one some
  systems only '*' is available).

'P' (upload files):
  Uploads by Z-Modem are detected automatically if BBS is in main menu.
  In case of problems with this feature it can be disabled in menu 'System
  Configuration', every upload must then be started by 'P'.

'B' (BBS-System):
  Change to bbs-menu.

'Q' (exit program):
  For leaving BBS.

-----

Menu 'System Configuration' (key 'I'):
  Can be entered by pressing 'I' in main menu and leaved by pressing 'Q'.

'E' (show current settings):
  Shows current system configuration.

'L' (Language):
  Shows and let you change language.

'P' (change transmittion protocol):
  Shows and let you change transfer protocol.

'A' (automatic Z-Modem uploads):
  Z-Modem-uploads can be detected automatically if Z-Modem is current protocol
  and BBS is in main-menu. This feature can be enabled/disabled by this menu.

'F' (list files on change directory):
  Plain files may be listed by changing directory also. This feature can be
  enabled/disabled by this menu.

'T' (change terminaltype):
  For selecting terminal-emulation.

'N' (new password):
  For changing passwords. Only user with a seclevel > 0 can change their
  passwords. Sysop can change every users password.

-----

Menu 'BBS-System' (key 'B'):
  Can be entered by pressing 'B' in main menu and leavind by pressing 'Q'.
  
'T' (talking to another user):
  All users logged in are listed in pager. His username is shown and his
  tty and pid in brackets also. A talk can only be accepted if the recipient is
  in main menu. In the other case (e.g. transferring data) 'WORKING' is
  displayed after the bracket and a try to talk will be reserved and the
  recipient get a message if he enter main menu again. If he is already talking
  to another user, 'BUSY' appears after the bracket and a try to talk will be
  rejected.
  Pressing Escape in pager leaves it without action.
  Any try to talk can be aborted by pressing 'Q' by any party.
  If the recipient accept a talk (by pressing 'A'), a parted window appears.
  The upper window is for input echo, the bottom for remote party input echo.
  You cannot edit, only backspace (or delete) work.
  Pressing Escape quits a talk.

------

Some things are shown in a pager (e.g. this text), recognizable by its highlighted line on the bottom with the word 'Pager', in addition with
position in text and keys to page and quit, in some case with keys for
selections. Pressing 'Escape' aborts pager and its originating action.

Some messages appears in popup-windows.

After some idle time in a menu an autologout happens.

In main-menu must be a minimum-time between two keystrokes if Z-Modem-
Uploaddetection is active.


Program:
BBS is a free (GNU-Copyleft) program for UNIX for exchanging files by modems
(ttys) in an easy and secure manner.
Written in ANSI-C and still in progress.

Comments, bugreports to

Hinrich Eilts <eilts@tor.dialin.rrze.uni-erlangen.de>

(press 'Q')
