INSTALLATION

    There are different installation procedures depending on whether 
    Okami is used with UUCP, SOUP, NOS or any other SLIP/PPP program, 
    or with the Unix newsreader tin.


UUCP INSTALLATION
    
    To install: just copy all OKAMI files to a directory and edit o.inf.
    Set "mode" to 0 (default) in o.inf. OKAMI is expressly designed to be
    used with Hermes, which creates the necessary directory hierarchy
    itself.

    Copy all mail from the home directories to the OKAMI news directory
    and starT oimport after polling with uucico.


SOUP INSTALLATION

    Copy all OKAMI files to a directory. Create a (sub)directory "news",
    as well as (sub)directories for SOUP import and export files.

    Edit o.inf with a text editor. Carefully follow the instructions.
    Especially: don't forget to set "mode" to 1.

    Start oimport.ttp to import SOUP packets. The directory hierarchy
    in directory "news" is constructed automatically.


NOS INSTALLATION

    Copy all OKAMI files to a directory. Create a (sub)directory "news".
    This is the equivalent of the NOS directory \spool\articles, so
    here's where the file "batch.txt" must be. Create a (sub)directory
    "mail", the equivalent of the NOS directory \spool\mail, i.e. the
    place where the mail file(s) "user.txt" must end up. In case you
    have a site with multiple users, all users must be listed in a
    file called "passwd" ("etcpasswd" in o.inf).

    Edit o.inf with a text editor. Set "mode" to 2 and carefully
    follow the other instructions.

    After polling" with NOS, or POPWatch and NEWSWatch, start 
    oimport.ttp to import news and mail.
    The directory hierarchy in directory "news" is constructed
    automatically.


TIN INSTALLATION

    This is just a variant of UUCP, but without uucico and certainly
    without Hermes. Accordingly, "mode" in o.inf must be set to 0
    (default value).

    Copy all O files to a directory. Create the (sub)directories
    "news" and "mail". Create a file called "news.def" in directory
    "news" containing the names of all the subscribed-to newsgroups,
    each group on a different line (don't forget, later, to specify
    the path to this file in o.inf: "merc.newsdef"). The directory
    "mail" is where the incoming Unix mail box file must be deposited
    and its path must be specified after "maildir" in o.inf. Create a
    (sub)directory "mqueue" for outgoing mail and news ("mqueuedir" in
    o.inf). Lastly, if there's more than one mail user on your system,
    they must be listed in a file called "passwd" ("etcpasswd" in
    o.inf).

    It is recommended to compress mail and news gathered on the host
    in a zip packet: if unpacked on the Atari with stzip (using option
    -r), the necessary directory hierarchy will be created
    automatically.


GETTING STARTED

    After installation, make sure that the configuration file o.inf is
    in the same directory as OKAMI and its auxiliary programs, or that 
    its path is set in the environment variable O_INF. An alternative is
    to specify the path on the command line with option -F.

    Run oimport.ttp to import the first messages. A list of options can 
    be obtained by running the program with flag -?

    Start o.prg. Mail messages and newsgroup articles should now be
    accessible.

    If o.prg is called from the command line with the name of a
    newsgroup, it will open with that newsgroup in a window. Called
    with "m", it will open Mail.$LOGNAME, i.e. the mail group of
    current user. When "a" is passed as a parameter,
    Mail.$LOGNAME.archive (mail archive group of current user) will be
    opened. If o.prg is started with group name "o", the Outbound
    group will be opened, and with "O", the Outbound.archive group of
    the current user will be opened.

    If o.prg is started with an email address as parameter, a mail
    message to this address is written, after which the program is
    terminated automatically. Email addresses are defined by strings
    containing "@" (strings that do not contain "@" will be
    interpreted as group names, and the corresponding group - if it
    exists - will be opened. If the address is only a name (addressees
    in local networks or aliases) it must end in "@". For instance, if
    o.prg is called with the parameter "wr@", a mail message to "wr"
    will be written, and if "wr" is specified in the alias file, it
    will be expanded at export.

    Use oexpire.ttp for deleting and archiving expired messages (for
    UUCP users: not the Hermes expire program). After polling,
    oimport.ttp must be called.

    IMPORTANT: always update O using programs of the same version. Do
    not use O programs of different versions with one another. Version
    numbers can be obtained by calling the program with flag "-v".
    