

                       -------------------------
                            skUserMail  (tm)
                             Version 1.00e
                   a wcCode User Mail Address Lister
                          for Wildcat! 5 BBS
                       -------------------------


                     (c) Copyright 1996-1997 skWare
                          All Rights Reserved

                              skWare (tm)

                   Steve Davies (steve@welcom.gen.nz)                      
                   Kevin Murphy (kevin@welcom.gen.nz)

                 Documentation version 1.00e 22/06/1997

 *** By using this software you agree to the terms of the Software ***
 *** License Agreement and Disclaimer of Warranty. These are in the ***
        *** files license.txt and warranty.txt respectively. ***

Contents
--------
1.  Purpose
2.  Registration
3.  Files
4.  Installation Instructions

1.  Purpose
-----------
skUserMail is a program that will produce a HTML file that lists each
of your users so that people can send them mail.

skUserMail is designed to be run from wcRun and therefore can be setup
to run as an event as often as the Sysop wants.

2.  Registration
----------------

Please refer to the file register.txt for details on registration of
skUserMail.

3.  Files
---------
The following files are included in the archive that you downloaded.

skware.txt             <--- important information about skWare
config.txt             <--- information on configuration parameters
sysop.txt              <--- you are reading it now
history.txt            <--- the file that has notes about changes etc.
upgrade.txt            <--- notes about upgrading
register.txt           <--- the file that has notes about registration

skUserMail.wcx         <--- THE executable program for the game
skUserMail.bat         <--- an example batch file to run the program
file_id.diz            <--- Long program description
desc.sdi               <--- Short program description

feedback.txt            <--- information on sending feedback to skware
license.txt             <--- information on software license
warranty.txt            <--- information on software warranty

skusermail_*.htm        <--- various example html pages

4.  Installation Instructions
-----------------------------
- Package Installation

    1 - Create a subdirectory for skUserMail where you wish.  We suggest
        c:\wc5\skUserMail or something similar.

    2 - Extract all the files from the archive into this directory.
    
    3 - Move the following files into the wildcat home directory
        (eg: c:\wc5)

        skUserMail.wcx
        skUserMail.bat

    4 - All the other files in the archive are already in relative
        directories and should be move as follows:-

            http                    => c:\wc5\http
            http\skware_templates   => c:\wc5\http\skware_templates
            data                    => c:\wc5\data

    5 - Edit the skUserMail.cfg file as required following the comments
        in the example supplied. Replace SHAREWARE with your registration
        code once registered.


    6 - You will need to add a link on one or more of your html pages so
        that your users can access the output file. An example is:-

        <b><a href="/skUserMail/skUserMail.htm">
            skWare's User Mailing List</a></b>


    7 - You will need to edit the skusermail.bat file to suit your needs.

    8 - Its now ready. You can run the batch file manually to see the what
        the output is like. You may also want to set it up as an event that
        runs on a regular basis.

    9 - Once registered skusermail allows customisation of the headers
        and footers on the html ouput. To do this you need to edit the
        the template files found in the http\skware_templates directory.
        There are 54 files supplied and thess are described below:-

        skusermail_html_indexpage_header.htm
            - this is the top bit displayed before the top horizontal
              rule on the index page

        skusermail_html_indexpage_footer.htm
            - this is the bottom bit displayed after the bottom
              horizontal rule on the index page

        skusermail_html_address_header_?.htm (there are 26 of these)
            - this is the top bit displayed before the top horizontal
              rule on the address page relating to the letter in question

        skusermail_html_address_footer_?.htm (there are 26 of these)
            - this is the bottom bit displayed after the bottom horizontal
              rule on the address page relating to the letter in question

        If the files are not found internal defaults will be used.

========================================================================

          Copyright (C) skWare 1996-1997, all rights reserved

    skUserMail is a trademark of skWare.
    skWare is a tradmark of skWare.

    WildCat! is a trademark of Mustang Software Inc.

    Other products and corporate names may be trademarks or registered
    trademarks of other companies, and are used for illustrative
    purposes only, and to the owners benefit, without an intent to
    infringe.

========================================================================

