       ___.  ___.
       \_ |__\_ |__   ______         ______ ____  ____   ____   ____
        | __ \| __ \ /  ___/ ______ /  ___// ___\/ __ \ /    \_/ __ \
        | \_\ \ \_\ \\___ \ /_____/ \___ \\  \__\  ___/|   |  \  ___/
        |___  /___  /____  >       /____  >\___  >___  >___|  /\___  >
            \/    \/     \/             \/     \/    \/     \/     \/
                 bbs-scene.org global onelinerz perl script
     v2.3 by Frank Linhares aka netsurge / 19-12-10 / admin@bbs-scene.org
				
	 		   Install Instructions				
_ Overview _

The global onelinerz system is an Internet enabled multi bbs wall style
oneliners door.  Using the bbs-scene.org api, multiple bbses can share one
pool of onelinerz on their systems. Global Onelinerz supports Renegade pipe
codes for adding some colour to individual onelinerz.  ANSI support can be
turned on or off via the onelinerz.cfg file.

_ Prerequisites _

Since this is nothing more than a perl script you will need, well, perl. If 
your running *nix or bsd you should already have perl installed, if your 
running windows you can grab activeperl which can be downloaded from 
http://www.activestate.com/activeperl/

You will also need to have the XML::Simple and LWP::UserAgent perl modules 
installed. You can do this by going into CPAN and typing 'install XML::Simple'
and 'install LWP::UserAgent'.

Finally you will need an account on bbs-scene.org. Visit 
http://bbs-scene.org/users_Registration.php to register for a free account.

_ Usage _

Edit the configuration options in the onelinerz.cfg file.  Please remember to 
escape the @ in your email address with a /

The only command line option that onelinerz.pl requires is the alias of the 
user who is using it.  For example in synchronet the variable %a passes the 
users alias so you would setup the script like so:

	./onelinerz.pl %a

Check the manual for your bbs package to learn what variable is used for the 
users alias.

_ Getting Help _

This is just a simple demonstration of how to use the bbs-scene.org api to 
access the onelinerz.  Complete documentation on the api can be found at 
http://bbs-scene.org/api_docs.

Help on using this script can be obtained many ways.  Please visit 
http://bbs-scene.org/contact.php to find out more.
