NAME

roll - Command line interface for dice rolls

VERSION

version 0.045

SYNOPSIS

    # Evaluate these command line params
    roll 3d6 2d8

    echo "5d6" > f
    echo "2d4+1" >> f

    # Read the contents of 'f' from STDIN
    roll < f

    # Evaluate 1d100 and open file 'f'
    roll d% f

OVERVIEW

This is a command line interface to the Games::Dice library. It takes die rolling specifications in the form of adb[+-*/b]c.

(This specification may change a bit over time, but not radically.)

a is optional and defaults to 1; this is number of dice to roll.
b is the number of sides on each die. '%' is shorthand for 100.

The optional end modifies the sum of the rolls. 'b' means take the "best" c rolls and sum them. Also '/' truncates the result to an integer after division.

Dice specifications can be piped in, given on STDIN or as positional parameters from the command line.

If a positional parameter matches a file name, it will be opened and each line of the file evaluated.

AUTHORS

Philip Newton <pne@cpan.org>
Ricardo Signes <rjbs@cpan.org>

COPYRIGHT AND LICENSE

This is free software, licensed under:

  The MIT (X11) License