Falcon CBCS LogTag V1.00
                         ~~~~~~~~~~~~~~~~~~~~~~~~~~
                    (c) David Dustin / KAOS Productions



                               20 July, 1992




Preface
~~~~~~~
    The programs and files in this distribution are freely distributable,
but are also Copyright (c) David Dustin.  They may be freely distributed as
long as no more than a minimum fee is charged to cover time and copying
costs.

    It may not altered or in anyway backward engineered.  Premission is
given for this distribution archive to be placed into Public-Domain
collections such as the Amiga Library run by Fred Fish.

    If you do decide to make use of LogTag, you are suggested to send any
form of donation or gift as payment.  This will get you the latest version
of LogTag, and also any other programs I have released.

    Written in 100% pure assembly using Devpac 3.02.  The source code is
available from me if you decide to register LogTag.


    If you do have any suggestions, bug notes or ideas about this program,
or if you would like to donate something, please let me know.


    Write to me at the following address:

                                David Dustin
                                PO Box 4129
                              Palmerston North
                                NEW ZEALAND


    Or I can be contacted via:
                             INFA  3:771/425




Contents
~~~~~~~~
    1.     An introduction
    2.     Usage
    3.     History
    4.     Credits / Copyrights



1. An Introduction
~~~~~~~~~~~~~~~~~~
    This program was written because the information output into the UserLog
by Falcon CBCS was not enough for me, or my friends who use Falcon.

    LogTag works on both Kickstart/Workbench 1.3 and 2.0, and can only be
used from the CLI/Shell.



2.  Usage
~~~~~~~~~
    UserList can only be either used from the CLI.

   The usage is:

                           LOGTAG <comment line>

    There is no point in doing this in the normal CLI/Shell.  LogTag is
designed to be placed in a script to execute a custom function from within
Falcon.  It allows you to know what the user has done while they were online
(eg.  Played a Door Game).  LotTag also adds the date and time as if it were
a normal Falcon entry.
    LogTag entries are identifed by a '>' as the first character of the
line, so you can easily spot the new lines.  One word of warning.  You can
only have a maximum of 60 characters as the comment.

    Firstly, make sure that you are currently in the directory that has the
Falcon.cfg file in it (the BBS root directory).  LogTag reads this config
file, and finds where the log file is stored.  If you aren't using a log
file, then LogTag just exits out.

    Now you will have to modify how you run your programs, so that you can
include the new command.  In the Menus.BBS data file, you would might have a
line like this to run a game or program:

          S CON MC "DOORS:Space/Space \"«FULLNAME»\" DOORS:Space/"


    This runs the SpaceEmpire door game.  I have replaced this with the
following line:

       S CON MC "Execute DOORS:Space.bat \"«FULLNAME»\" DOORS:Space/"

and for my Space.bat I have:

.key arg1 arg2					;as many args as needed
LogTag Played a game of SpaceEmpire		;add a comment to the logfile
DOORS:Space/Space <arg1> <arg2>			;run the game (with args)


    This will run your door as normal, but will also add the comment line
into the logfile.



3.  History
~~~~~~~~~~~
V1.0
    First release.


28-Jan-1996
    Released into the public domain by the author Dave Dustin



4.  Credits / Copyrights
~~~~~~~~~~~~~~~~~~~~~~~~
    Main code                   - David Dustin
    Ideas                       - Renze de Ruiter


    LogTag                      - (c) 1992 David Dustin
    Falcon CBCS                 - (c) 1988-91 Brian Fehdrau
    Devpac 3.02                 - (c) 1991 HiSoft
    Kickstart/Workbench         - (c) 1985-91 Commodore-Amiga, Inc.