droll 1.0rc5.4.0 → 1.0

data/COPYING

@@ -1,6 +1,5 @@
-The droll project is copyright 2010, 2011, and 2012 Chad Perrin, and may be
-distributed under the terms of the Open Works License.  See the owl.txt file
-for license text.
+The droll project is copyright 2010 Chad Perrin, and may be distributed under
+the terms of the Open Works License.  See the owl.txt file for license text.
 
 The Rubinius implementation of Ruby allows distribution under the terms of the
 MIT/X11 license.  See the [Rubinius project](http://rubini.us) for more details

data/README.md

@@ -1,23 +1,27 @@
-# droll
+# Droll
 
-Droll, for "d roll" (as in "die roll"), is a dice rolling library and a command
-line utility.  Drollbot is an IRC bot that uses the droll and Isaac libraries
-to provide dicebot functionality over IRC.
+This dice rolling simulator was designed as a digital aid for playing
+roleplaying games, and named "droll" as an abbreviation for "die roll" or "dice
+roller".  The term "droll" also seemed apt as a reference to its beginnings as
+an amusing little toy program, though it now offers reasonably sophisticated
+support for different dice-rolling techniques used in various RPGs.  It is a
+Ruby library with included command line interface (`droll`) and IRC dicebot
+(`drollbot`).
 
 At present, droll provides a number of different die rolling techniques,
 including simplistic roll-and-sum, various exploding roll schemes, counting
 dice that meet a threshhold, and rolling several dice then discarding some by
 threshhold before summing.  Threshholds are typically the highest possible
 number for the die type, or the maximum possible for the sum in some cases, or
-even the lowest possible number for the die type, though alternate thresholds
+even the lowest possible number for the die type, though alternate threshholds
 can be used.
 
 Use NdN as the pattern for normal die rolls (where N stands in for a number),
-and NxN for exploding die rolls.  Modifiers can be included as well: NdN+N or
-NdN-N.  Die codes, at this time, do not work if they have spaces in them.
-Certain die codes are rejected (i.e.  0x0).  Exploding is limited to an
-unreasonably high number (1000), to prevent crashing.  Specifying alternate
-thresholds uses a .N syntax (NxN.N).  Die values are chosen (pseudo)randomly
+and NxN for exploding die rolls, for instance.  Modifiers can be included as
+well: NdN+N or NdN-N.  Die codes, at this time, do not work if they have spaces
+in them.  Certain die codes are rejected (i.e.  0x0).  Exploding is limited to
+an unreasonably high number (1000), to prevent crashing.  Specifying alternate
+threshholds uses a .N syntax (NxN.N).  Die values are chosen (pseudo)randomly
 from numbers between 1 and N (the number following the x or d), or between 0
 and N if the N is preceded by a 0 character.  An example of the full
 sophistication of die code parsing is:
@@ -34,15 +38,28 @@ immediately rolled to handle exploding die values.
 
 ## installation
 
-If you already have Ruby installed with rubygems, installing droll should be
-easy.  Just use the gem command.  At present, because droll is in a pre-release
-state ("release candidate"), you need to use the `--pre` option to install from
-the RubyGems archive:
+Installing the Ruby programming language's runtime is a relatively simple
+operation, and a prerequisite for running droll (because it is a Ruby project).
+The "standard" reference implementation, often called MRI/YARV (for Matz' Ruby
+Implementation + Yet Another Ruby VM) is available in the default software
+management system of most open source Unix-like operating systems as well as
+Apple MacOS X, though you should make sure your system uses the 1.9 version of
+ruby instead of the older 1.8 version (see below).  For users of Microsoft
+Windows, the [RubyInstaller for Windows](http://rubyinstaller.org/) makes Ruby
+easy to install there, as well.
 
-    $ gem install droll --pre
+The normal way to install Ruby on most operating systems will also install the
+gems tool, which is a sort of software management system specific to Ruby
+tools, and is the way most Ruby libraries and applications are distributed,
+including droll.
 
-You can also download the gem package from the [Bitbucket repo][bitbucket] and
-use the gem command to install it:
+Once you have Ruby installed with rubygems, installing droll should be easy.
+Just use the gem command:
+
+    $ gem install droll
+
+You can also download the gem package from the [Bitbucket project][bitbucket]
+and use the gem command to install it:
 
     $ gem install droll-<version>.gem
 
@@ -60,6 +77,15 @@ systems, please feel free to submit patches to this README file via one of the
 approaches detailed in the **contributions** section at the bottom of this
 file.
 
+### Ruby 1.8
+
+Droll assumes Ruby 1.9.x, and some die code validation (for zero-based die
+codes, e.g. 1d05) does not work properly.  Normally, it will not install on a
+system using a version of Ruby older than 1.9, but this can be overridden if
+you wish by using the `-f` option with the `gem install` command:
+
+    $ gem install -f droll
+
 ## usage
 
 The following sections explain how to use the executable tools that come with
@@ -71,14 +97,14 @@ dicebot.
 
 Using the basic droll program from the command line is pretty simple:
 
-    > droll d20
+    $ droll d20
     d20: [15] + 0 = 15
-    > droll 2d4+3
+    $ droll 2d4+3
     2d4+3: [1, 2] + 3 = 6
-    > droll 1d10 2d03
+    $ droll 1d10 2d03
     1d10: [1] + 0 = 1
     2d03: [3, 2] + 0 = 5
-    > droll 4x05.4+7
+    $ droll 4x05.4+7
     4x05.4+7: [5, 2, 0, 4, 0, 1] + 7 = 19
 
 In each example, the numbers between `[brackets]`, separated by commas, are the
@@ -140,17 +166,13 @@ to see more information about configuring drollbot.
 
 ## license
 
-Droll project files may be redistributed under the terms of the Open Works
-License.  See owl.txt for license text.
-
-Also see the [OWL site][owl] for more details.
-
-The OWL was chosen with a conscious adherence to copyfree policies.  See the
-[Copyfree Initiative][copyfree] site for more details about the copyfree
-philosophy of licensing.
+Droll project files may be redistributed under the terms of the [Open Works
+License][owl].  The OWL was chosen with a conscious adherence to copyfree
+policies.  See the [Copyfree Initiative][copyfree] site for more details about
+the copyfree philosophy of licensing.
 
-See the COPYING file for more information about copyright and licensing for
-droll and the code associated with it.
+See the COPYING file in the project repository for more information about
+copyright and licensing for droll and the code associated with it.
 
 
 ## contributions
@@ -162,7 +184,7 @@ using the `export` command.  To produce a patch based on the most recent
 commits in your local clone of the project, this command should suffice to
 produce a usable patch for an update from the immediately previous commit:
 
-    > hg export tip
+    $ hg export tip
 
 * Patches may be submitted via the issue tracker, as a comment with attachment
   in response to whatever issue it fixes.
@@ -171,8 +193,8 @@ produce a usable patch for an update from the immediately previous commit:
 * Another way to submit contributions is to clone the project on
   [Bitbucket][bitbucket] and send a "pull request" from the clone when changes
   have been made.  The process of submitting contributions via fork and pull
-  request is described in a TechRepublic article: [*Contribute to Bitbucket
-  Projects Using Forks and Pull Requests*][forkpull].
+  request is described in a TechRepublic article:
+  [*Contribute to Bitbucket Projects Using Forks and Pull Requests*][forkpull].
 
 [owl]: http://owl.apotheon.org
 [copyfree]: http://copyfree.org

data/bin/droll

@@ -3,7 +3,7 @@ require 'optparse'
 require 'droll'
 
 help_text = {
-  :quiet  =>    'Suppress verbose output.',
+  :quiet    =>  'Suppress verbose output.',
   :help     =>  'Display this help text.',
   :syntax   =>  'Display comprehensive syntax help.',
   :version  =>  'Display version and license information.'

data/lib/droll.rb

@@ -136,7 +136,7 @@ This method returns the version number for the Droll gem.
 
 =end
 
-  def self.version; '1.0rc5.4.0'; end
+  def self.version; '1.0'; end
 
 =begin rdoc
 

metadata

@@ -1,8 +1,8 @@
 --- !ruby/object:Gem::Specification
 name: droll
 version: !ruby/object:Gem::Version
-  version: 1.0rc5.4.0
-  prerelease: 3
+  version: '1.0'
+  prerelease: 
 platform: ruby
 authors:
 - Chad Perrin
@@ -13,7 +13,7 @@ date: 2012-06-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: isaac
-  requirement: &11059500 !ruby/object:Gem::Requirement
+  requirement: &4302560 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -21,7 +21,7 @@ dependencies:
         version: '0.2'
   type: :runtime
   prerelease: false
-  version_requirements: *11059500
+  version_requirements: *4302560
 description: ! "    Droll is a Ruby library providing dice roller functionality, with
   a command\n    line utility and an IRC bot as included user interfaces.  It was
   created\n    with roleplaying gamers in mind, with a range of sophisticated capabilities\n
@@ -60,9 +60,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
-  - - ! '>'
+  - - ! '>='
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.15