961104
                        Doc for LastLogger V1.2
                       ~~~~~~~~~~~~~~~~~~~~~~~~~


COPYRIGHT:
~~~~~~~~~~
This program is XenoWare. If you own Xenolink Pro BBS you may use it
freely and spread it to other users of Xenolink, as long as the archive
remains in it's original state! Another requirement for using it more
than two weeks is that you send me a netmail telling me you're using it!


CHANGES V1.1 -> V1.2 (released 961104):
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* Sometimes my computer gurues on me...yes, it's sad but true! :-) When this
  happens no logout is written to the logfile, and this would mess up the
  textfile. This problem is now history!
* Big re-write for speed!!! The programme now loads the entire logfile to memory
  before scanning it, instead of like before reading one line at a time. This
  has lead to a significant increese in speed! I clocked the two versions with
  my timerprogramme, and came up with this result on a 500kB logfile:

  LastLogger V1.1: 14.32 seconds
  LastLogger V1.2:  5.07 seconds

  That's a speedincrease by 182 percent!!!
* Removed some code that stripped the rest of the location string after the
  first space. A name like "Lane Cove" would be only "Lane". Now it only strips
  after a comma, so a name like "Lane Cove, Australia" will only be "Lane Cove".
* Since no one ever sends me any netmails or emails telling me they use my
  programme, it's either that no one uses it (which makes it more or less
  unnescessary to release new updates), or it's because no one bothers with it!
  Therefor I've implemented a keyfile for using my programme after a specific
  date. The registration is TOTALLY FREE except for a netmail or an email with
  your name and request for registration. Send it to either of the two addresses
  stated below.


CHANGES V1.0 -> V1.1 (released 961015):
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* Didn't allocate enough memory.
* Probably a problem with handling of a large number of users. Now
  handles upto 5000 users (in theory atleast!)
* At recuest, added possiblity to use your own colours or no colours at
  all (NOANSI).
* Fixed a problem with fidosessions that 'Failed' which would mess up the
  list.
* Fixed a problem with fidosessions with 'Invalid session password' which would
  result in a 'Linkup failure' which would seriously mess up the list. These
  connections are now skipped and won't show in the list.

Version 1.0 released 960819
~~~~~~~~~~~~~~~~~~~~~~~~~~~


WHAT IS IT:
~~~~~~~~~~~
A programme to create a textfile showing the last 20 callers, either BBS
logins, or mailcalls.


INSTALLATION:
~~~~~~~~~~~~~
* Copy the library to your LIBS: path.
* Copy the programme to your path.
* Set the programme to run after or before any incoming call to the BBS.
  Why not in the Logout.1 and INBOUNDMAIL scripts?
* Edit your fakelogin source or any other menufile and add this line:
  TypeFile "LastCallers.txt"
* Edit the file LastLogger.env to your liking and copy it to your ENV:
  and/or ENVARC: directory. The file is like this:

  Line  Explination
  1.    ANSI/NOANSI
  2.    Colourstring for Numbering
  3.    Colourstring for Location
  4.    Colourstring for Name/System
  5.    Colourstring for Up - Dwn
  6.    Colourstring for In - Out

  If this file is left out, ANSI will be default, and default colours
  will be used.


USAGE:
~~~~~~
Run the programme without any arguments if you want to scan the
CALL-1.LOG logfile. It should be located in Xlog:. If not, enter the
complete path and name of the file to be scanned. In other words, if you
like to run it for CALL-2.LOG or any other call log, enter the path and
name of that file instead. You CAN use it on multiple nodes, just run it
on each and every logfile you've got, and in between the runs, rename
the created file (LastCallers.txt) to LastCallers1.txt for instance if
you run it for CALL-1.LOG and LastCallers2.txt for CALL-2.LOG!

Only problem would be if you run the programme in your INBOUNDMAIL
script and the incoming mailcall doesn't leave any mail. Then the script
won't be run, but then again, it will be fixed in the next call
probably!


REQUIREMENTS:
~~~~~~~~~~~~~
LIBS:hbasic2.library


FOUND A BUG?:
~~~~~~~~~~~~~
If you by any chance should find a bug or any other nasty creatures, you
can reach me at my BBS:

  Absolut BBS -  +46 44 247248.        Open 24h, every day of the week,
                                       every week of the year!

You can also reach me at the following address:

                                Ulf Nilsson
                                Fadriften 53
                                S-296 33 Ahus
                                   SWEDEN

(Not that I think anybody will actually write, but anyway...)

Or you can use my FidoNet address: 2:200/621.0
Or why not my E-mail address     : uni@absolut.ct.se


THANKS:
~~~~~~~
...goes to Xeno Inc for their wonderful work with Xenolink!


EPILOGUE:
~~~~~~~~~
You can always find updates (if there are any) on my BBS as soon as they are
finished. The number is listed above.

Until the next door/util, see ya all in Microcosmos!

Greetings..    __  __    _   __
               //  //    /\  //
             _//  //    //\\//
              \\_//lf _//  \/ilsson  ..SysOp Absolut BBS!