       ___.  ___.
       \_ |__\_ |__   ______         ______ ____  ____   ____   ____
        | __ \| __ \ /  ___/ ______ /  ___// ___\/ __ \ /    \_/ __ \
        | \_\ \ \_\ \\___ \ /_____/ \___ \\  \__\  ___/|   |  \  ___/
        |___  /___  /____  >       /____  >\___  >___  >___|  /\___  >
            \/    \/     \/             \/     \/    \/     \/     \/
                 bbs-scene.org global onelinerz perl script
     v2.1 by Frank Linhares aka netsurge / 13-11-10 / admin@bbs-scene.org
				
	 		               Install Instructions				
_ 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.