DragonFly On-Line Manual Pages

ROLL(1)               User Contributed Perl Documentation              ROLL(1)

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.)

       o   a is optional and defaults to 1; this is number of dice to roll.

       o   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
       o   Philip Newton <pne@cpan.org>

       o   Ricardo Signes <rjbs@cpan.org>

COPYRIGHT AND LICENSE
       This software is Copyright (c) 1999 by Philip Newton.

       This is free software, licensed under:

         The MIT (X11) License

perl v5.20.2                      2015-04-27                           ROLL(1)