Falcon CBCS Owner V1.00
                         ~~~~~~~~~~~~~~~~~~~~~~~~~
                              (c) David Dustin


                              16 August, 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.  Permission 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 Owner, you are suggested to send any
form of donation or gift as payment.  This will get you the latest version
of UserInfo, and also any other programs I have released.

    Written in 100% pure assembly using Devpac 3.02.  The source code, and
whatever information I have found out about the Falcon User.BBS datafile is
available from me if you decide to register Owner.


    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
                              30 Richmond Ave
                              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 there was no way for the user to see
who had uploaded a certain file onto my BBS.  This function is available on
almost all other BBS packages, except for Falcon.  So here is the latest in
my line of extras for Falcon.

    Owner works on both Kickstart/Workbench 1.3 and 2.x, and can only be
used from the CLI/Shell.



2.  Usage
~~~~~~~~~
    Owner can only used from the CLI.  It requires special arguments, passed
via the execution line in your Menus.BBS file.

    The most common use for this program is to include it as an option from
the file menu so that the users can get a bit of extra info about a certain
user.  Just make an entry in your Menus.BBS file like the one below and just
call the program.


           O CON MC "Owner «FILEPATH»«GETSTACK»«File to view? »"

    This will pass the full path of the current file area.  The second
option «GETSTACK» will ask you for the filename to get the info about.  You
can either enter the data in a stacked form or one line at a time.  Here is
an example:

    If you just entered O and then hit return, you would see:

Select: O
File to View? 

    You can now just type in the name of the file to scan.  The second
alternative is to type the name of the file to check straight after the
option (like so):

Select: O <file>

    The way the UpLoader is determined is the fact that Falcon places the
Users name into the Comment line of the file (starting at position 40).  If
no name can be found here, then Owner will say that the file was UpLoaded by
the SysOp.

    The Info line is taken from the Files.BBS text file in the directory the
file is kept in.



3.  History
~~~~~~~~~~~
V1.00	16 August 1992
    * First release.


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


4.  Credits / Copyrights
~~~~~~~~~~~~~~~~~~~~~~~~
    Main code                   - David Dustin

    UserInfo                    - (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.