----------------------------------------------------------------------------- Pebble: Perl Babel Linux Client ----------------------------------------------------------------------------- Thanks for downloading Pebble! Please read all of this file before attempting to install or use Pebble. ----------------------------------------------------------------------------- Installation directory layout: ----------------------------------------------------------------------------- ./ ./README This File. ./README.pebbleconfig Information about the Configuration Scripts ./pebbleinstall.pl Simple Installation Script. ./files ./files/pebble.pl Main Perl script. ./files/pebbleconfig.pl config file generation. ./files/pbbs.pm object handling communication with XML BBS. ./files/pconnection.pm object handling most socket communication. ./files/pcurses.pm object handling user interface. ./files/puserlist.pm object handling the userlist data structure. ./files/pxmlsectionparser.pm object for parsing XML bbs sections. ./files/pconfigo.pm object for parsing the config files. ./files/pconstants.pm module containing Xurble & Pebble constants. ./files/puser.pm object handling user data structure. ./files/pxmldiscussionparser.pm object for parsing XML bbs discussions. ./modules ./modules/TermReadKey-2.18.tar.gz Perl Term::ReadKey module. ./modules/Curses-1.06.tar.gz Perl Curses module. ./modules/XML-Parser.2.30.tar.gz Perl XML Parser module. ----------------------------------------------------------------------------- Pre-requistes ----------------------------------------------------------------------------- Pebble requires a working install of Perl (v5+) and a number of Perl modules: XML::Parser. Term::ReadKey Curses and their pre-requisites. Without these, Pebble cannot function at all. These modules are supplied with this tar. If you are unsure how to install them, drop me an email, or ask your system administrator. ----------------------------------------------------------------------------- Installation ----------------------------------------------------------------------------- 1: Untar the archive. 2: Run the pebbleinstall script. (perl pebbleinstall.pl) This should ask you a couple of questions about the location of your Perl binary and the directory to which you wish to install Pebble. The default installation directory is /usr/local/pebble. You must have the necessary privs to create this directory. If not, change this to install somewhere where you have the privs. 3: The script will then test to see if you have the pre-requisite modules installed. If you do not have all the modules, you will be dumped out of the script and instructed to install them. 4: The script will then copy out the files into your chose installation directory. 5: Once this is complete, you will need to run the pebbleconfig.pl script which has been deposited into the your installation directory. This will create the pebble.config file necessary for running Pebble. ----------------------------------------------------------------------------- Running Pebble ----------------------------------------------------------------------------- Once you have installed and created a config file, run pebble by changing to the install directory and typing: perl pebble.pl You should then have to select a profile (setup with pebbleconfig.pl and then, all going well, you'll be asked for a username and password. All going well, you'll be logged in. If you don't have an account, go to http://babel.shef.ac.uk:81/jsp/reg.jsp and fill out the form. It should take a little while to process (they are personally vetted by the Board Managers, but in the mean while login with the username guest, password guest, to have a play. ----------------------------------------------------------------------------- Simple Commands: ----------------------------------------------------------------------------- s - send r - reply u - update userlist i - change visibility p - Change Popname b - BabelMail h - help m - menu rotates a - Toggle Away Status n - message history l - re-parse conf file q - quit e = examine user a = Toggle Away Status ] = read bbs = scroll message list up = scroll message list down = scroll userlist up = scroll userlist dowm ----------------------------------------------------------------------------- SYSOP Commands: ----------------------------------------------------------------------------- alt-b - Big Brother alt-i - Invis Other User alt-z - Zap User alt-s - Send System Message alt-g - Create Group ----------------------------------------------------------------------------- URLS: ----------------------------------------------------------------------------- Babel Homepages: http://babel.shef.ac.uk Babel Registration Page: http://babel.shef.ac.uk:81/jsp/reg.jsp Babel Web Proxy: http://babel.shef.ac.uk:81 USIT Committee Pages: http://usit.shef.ac.uk My homepage: http://www.boreworms.com/kelly CVS http://www.cvshome.org CVS Documentation http://www.cvshome.org/docs/manual/cvs.html ----------------------------------------------------------------------------- Thanks to: ----------------------------------------------------------------------------- G - For writing Babel, Xurble and lots of inspiration. Gwendolyn -| Sabrina | Asmodai |--- For technical help, advice and encouragement. TyRaNiD | Dangermouse -| Gonzo - For the odd bug fix and testing. William Setzer - For helping me with (and writing) the Perl Curses Module All the Japhs on comp.lang.perl.misc even if you piss me off a lot. any one missing who thinks they should be here? email me :) ----------------------------------------------------------------------------- Support: ----------------------------------------------------------------------------- Get any bug notifications or requests for support to me and I'll do my best to help. I can't guarantee any fixes for compiled versions of Pebble using Perl2Exe. Babel: Jester Email: kelly@boreworms.com ICQ: 38994129 Yahoo IM: delanthear MSN Messenger: kelly@boreworms.com Snail: Are you kidding? ----------------------------------------------------------------------------- Contributing: ----------------------------------------------------------------------------- If you want help with this and fancy bug-fixing/enhancing, please take the time to have a look through the .pl and .pm files in this distro. If thats not put you off, then go and read this: http://www.cvshome.org/docs/manual/cvs.html That should tell you about CVS and how to use it. Then drop me an email to kelly@boreworms.com and I'll sort you out with a CVS account so you can check out the latest code versions. ----------------------------------------------------------------------------- Other Babel Clients: ----------------------------------------------------------------------------- If you like this one, or even if you don't, you should check some of these out. Babble: 32bit Visual Basic Client. Author: G URL: http://www.wearegeeks.pwp.blueyonder.co.uk/usit/clients/babble/index.html Cypher: Platform Independant Java Client. Author: Dangermouse URL: http://pipthepixie.tripod.com/cypher/ B2K: 32bit Visual Basic Client Author: Sabrina URL: http://www.b2k.info/ B4L/X4L: C *NIX Client Author: TyRaNiD URL: http://www.wearegeeks.pwp.blueyonder.co.uk/usit/clients/x4l/index.html ----------------------------------------------------------------------------- Babel Clients on the way: ----------------------------------------------------------------------------- Babel Explorer by Pornstar Browser by ??? BatOX by Gwendolyn Egg! by ??? Rubel by TyRaNiD ----------------------------------------------------------------------------- Last Updated: 09/03/2002 22:17 by Kdorset ----------------------------------------------------------------------------- CVS Variables: ----------------------------------------------------------------------------- $Id$ $Author$ $Date$ $Header$ $Name$ -----------------------------------------------------------------------------