Roll README

Roll was written with Linux in mind.  If there is some reason why you can't get it to compile on your *nix box, email me.  I'll look into it.  It should work on just about any system.  

COPYRIGHT

Roll and all examples are (c) copyright 1999 Jeff Frasca <ph43drus@home.com> and are covered by the GPL.  A copy of the license can be found in the file named 'GPL' at the top of the source tree.

INSTALLATION:

Pretty simple:

 $ vi Makefile
Change the variable SCRIPTS, it is set to .BitchX, just set it to whatever directory your client uses.  Leave it be if you use BitchX.
 $ make
(as root)
 # make install
 $ vi ~/$SCRIPTDIR/rb.bx 
If you happen to want to uncomment some perfectly fine functionality (left off for sanity's sake, I'll explain in a minute).


Roll:

This is a dice program I wrote for two reasons a) I was learning how to program and b) it would be handy to have for gaming online.  It has plenty of idiot proofing built into it, but it is not idiot proof (when you make better idiot proofing, they will build a better idiot).  The general synopsis of the command goes something along the lines of this:
    roll [-i name] [-p] [-h] [--ircmode name] [--pedantic] 
	[--help] <dice> [dice ...]

	<dice> is in the format of ndx, where n is the number of times to roll,
		and x is the number of sides the dice to roll has.
		You can also add/subtract/multiply by constants or dice.
		The default behavior is to ignore operator precedence.
        -i  IRC mode, requires the name arg, also --ircmode
	-p  Pedantic, this switch causes roll to give multiplication precedence
		over addition/subtraction (ie, it obeys long standing\n
		mathematical standards when -p is specified).
		Also --pedantic
	-h  Prints this message, also --help

EXAMPLES
	roll 3d6
		rolls a six sided die three times.

	roll 1d6+1
		rolls a six sided die 1 time, and adds one.

	roll 2d4+6d6+8
		rolls a four sided die twice, rolls a six sided six times, 
		adds them together and then adds 8.

	roll 1d4*10+10 
		rolls a four sided die, multiplies it by 10, and then adds 10.

	roll 1d4+10*10
		rolls a four sided die, adds 10 and then multiplies by 10.
	roll -p 1d4+10*10
		rolls a four sided die and adds 100 (the 10*10 is calculated 
		before the addition, because of the -p switch)

BUGS

What bugs?  They are called _features_, no actually, if you run into any problems, email me.  Although, it is pretty flawless, if I may say so myself.

