ruby-fizzbuzz 0.0.6 → 0.7.0

checksums.yaml

@@ -1,15 +1,7 @@
 ---
-!binary "U0hBMQ==":
-  metadata.gz: !binary |-
-    MWYzNWE4ZTE5NzkyODAwMmM0ZjA5N2UxODZmYmUwNTNmZTI0N2YzNQ==
-  data.tar.gz: !binary |-
-    YWRjODkyYmU3MTFkNjQxMWVjOGUxNTQ0YTliZjkyOTgxMDIwMTk3Ng==
+SHA1:
+  metadata.gz: 15be72f9c77aaa84d7fa6f92403623aa38d62add
+  data.tar.gz: a7b92647afb2cf83ded7bd442829964b09a6a5e5
 SHA512:
-  metadata.gz: !binary |-
-    MzlmMzNmMDRkYzRmODUxMDRiMTZlNzZmZjMxY2YwYzQyMmVkYTU3YmJiODNk
-    OTM4OWZlYzQ5YjY4NDEzNGNiNzU5YWUxZDNkN2UwYTRmZDk5ZWJkODU4Y2Jm
-    Njc3MzVhNTRhNDc5ZGQ0OWFjYjAyM2MyMTM0ZmYxNDI1MmRlZmU=
-  data.tar.gz: !binary |-
-    ODE4OGU2ZTU5MTAzNDJkYjVmZGM5MzY1NzBiZWFlOGM3NThjMWY4MDhiNWE5
-    ZWYxYzljZjIzZDYyYzgyYTNkNTZkNTBlZjk5NjdiZGMwY2RlZTcyNWMwYzM5
-    ZjAxNDkxM2Y1ZGEwMThkYTI4NWM3MTUwMTRiOGVjNmViNDczMWQ=
+  metadata.gz: ca579ce7e2c92319421613c3f9aaaddff506a222682760d52c03701d53da730d0da195eb9d30c4adbc2b4f45e7ee2ab600f9c64a12060244fe069e3595c31550
+  data.tar.gz: ae2ba4d86ac6ba15ee7245535f5b797485aef4cee26f713fe3309db983002c0ad85e543b5589518cc2bfeabc2d3b0576f13580861abf3c28eb4d6bc1be275504

data/CHANGES

@@ -1,55 +1,76 @@
+fizzbuzz (0.7.0)
+
+  * Added to_hash, as_json, to_json and from_json (singleton) to the FizzBuzz class.
+  * Add rudimentary Vagrantfile that can be used to build a development environment.
+  * Re-factored fizzbuzz (singleton) from the FizzBuzz class to speed it up.
+  * No longer use of Enumerable#entries in the Array integration, achieving better performance.
+  * Correctly return Enumerator when integrating with the Range class.
+  * Updated Rakefile to no longer run test before benchmark.
+  * Fixed benchmarks concerning Array and Range integration.
+  * Retired testing with Ruby 1.9.2 and 2.1.0, and added 2.1.5 on Travis CI.
+  * Fixed Travis CI build against Rubinius.
+  * Re-factored tests to utilise modern version of the "test-unit" Ruby gem.
+  * Fixed build to make it work with C++ compilers.
+  * Added the Guard Ruby gem for convenience, with an appropriate Guardfile.
+  * Added LLVM (clang) compiler to build with to Travis CI.
+  * Fixed version number to comply with Semantic Versioning 2 (http://semver.org/).
+  * Re-factored and cleaned up small portions of code and documentation.
+  * Removed BitDeli badge.
+
+-- Krzysztof Wilczynski <krzysztof.wilczynski@linux.com>  Mon, 15 Dec 2014 00:27:26 +0000
+
 fizzbuzz (0.0.6)
 
-  * Fixed issue reported by LLVM (clang);
-  * Updated development dependencies;
-  * Added Ruby 2.1.0 to Travis CI;
-  * Added BitDeli and Gemnasium integration;
-  * Re-factored and cleaned up small portions of code;
-  * Made Rake "test" task to be the default tasks;
+  * Fixed issue reported by LLVM (clang).
+  * Updated development dependencies.
+  * Added Ruby 2.1.0 to Travis CI.
+  * Added BitDeli and Gemnasium integration.
+  * Re-factored and cleaned up small portions of code.
+  * Made Rake "test" task to be the default tasks.
   * Updated the ".gitignore" file to cover Bundler, rbenv, etc.
 
 -- Krzysztof Wilczynski <krzysztof.wilczynski@linux.com>  Sun, 23 Feb 2014 13:52:08 +0000
 
 fizzbuzz (0.0.5)
 
-  * Added integration with Array and Range types;
+  * Added integration with Array and Range types.
   * Added simple benchmark.
 
 -- Krzysztof Wilczynski <krzysztof.wilczynski@linux.com>  Tue, 26 Nov 2013 12:40:34 +0000
 
 fizzbuzz (0.0.4)
 
-  * Retired support for Ruby 1.8.x (no support for MRI, Ruby Enterprise Edition and Rubinius);
-  * Added Coveralls and Code Climate integration (and hence improved code test coverage);
-  * Improved error handling and made code more resilient to errors;
+  * Retired support for Ruby 1.8.x (no support for MRI, Ruby Enterprise Edition and Rubinius).
+  * Added Coveralls and Code Climate integration (and hence improved code test coverage).
+  * Improved error handling and made code more resilient to errors.
   * Fixed formatting and white spaces.
 
 -- Krzysztof Wilczynski <krzysztof.wilczynski@linux.com>  Mon, 18 Nov 2013 11:22:26 +0000
 
 fizzbuzz (0.0.3)
 
-  * Added custom exceptions and improved error handling;
-  * Added more variety of Rubies on which tests are being run with Travis CI;
+  * Added custom exceptions and improved error handling.
+  * Added more variety of Rubies on which tests are being run with Travis CI.
   * Added project to Rubygems (http://rubygems.org) so it can be installed
-    with just "gem install ruby-fizzbuzz" command;
+    with just "gem install ruby-fizzbuzz" command.
   * Renamed project from "fizzbuzz" to "ruby-fizzbuzz" to avoid clashes with
-    other Ruby gems hosted on Rubygems web site;
+    other Ruby gems hosted on Rubygems web site.
   * Made "mkmf" in extconf.rb more user-friendly (it now reports missing
-    build-time dependencies better);
+    build-time dependencies better).
   * Split Ruby gem specification (or gemspec if you wish) away from Rakefile
-    into its own file (namely ruby-fizzbuzz.gemspec);
+    into its own file (namely ruby-fizzbuzz.gemspec).
   * Improved documentation and removed bunch of small code smells.
 
 -- Krzysztof Wilczynski <krzysztof.wilczynski@linux.com>  Sat, 31 Aug 2013 17:54:54 +0000
 
 fizzbuzz (0.0.2)
 
-  * Added is_fizz?, is_buzz? and is_fizzbuzz? singleton methods to FizzBuzz class;
+  * Added is_fizz?, is_buzz? and is_fizzbuzz? singleton methods to FizzBuzz class.
   * Added fizz?, buzz? and fizzbuzz? methods to the Integer class via a monkey-patch
-    for convenience;
+    for convenience.
   * Changed behaviour of the FizzBuzz#[] singleton method, so it will yield a FizzBuzz
-    result for a given arbitrary Integer value;
-  * Re-factored code to make it cleaner, and added more tests and improved coverage;
+    result for a given arbitrary Integer value.
+  * Re-factored code to make it cleaner, and added more tests and improved coverage.
   * Re-factored FizzBuzz so it now does not assume that we always want to calculate
     results from 1 to n -- it is now possible to calculate FizzBuzz results for given
     n, m values, where n denotes start and m denotes stop value.

data/CHANGES.rdoc

@@ -1,55 +1,76 @@
+fizzbuzz (0.7.0)
+
+  * Added to_hash, as_json, to_json and from_json (singleton) to the FizzBuzz class.
+  * Add rudimentary Vagrantfile that can be used to build a development environment.
+  * Re-factored fizzbuzz (singleton) from the FizzBuzz class to speed it up.
+  * No longer use of Enumerable#entries in the Array integration, achieving better performance.
+  * Correctly return Enumerator when integrating with the Range class.
+  * Updated Rakefile to no longer run test before benchmark.
+  * Fixed benchmarks concerning Array and Range integration.
+  * Retired testing with Ruby 1.9.2 and 2.1.0, and added 2.1.5 on Travis CI.
+  * Fixed Travis CI build against Rubinius.
+  * Re-factored tests to utilise modern version of the "test-unit" Ruby gem.
+  * Fixed build to make it work with C++ compilers.
+  * Added the Guard Ruby gem for convenience, with an appropriate Guardfile.
+  * Added LLVM (clang) compiler to build with to Travis CI.
+  * Fixed version number to comply with Semantic Versioning 2 (http://semver.org/).
+  * Re-factored and cleaned up small portions of code and documentation.
+  * Removed BitDeli badge.
+
+-- Krzysztof Wilczynski <krzysztof.wilczynski@linux.com>  Mon, 15 Dec 2014 00:27:26 +0000
+
 fizzbuzz (0.0.6)
 
-  * Fixed issue reported by LLVM (clang);
-  * Updated development dependencies;
-  * Added Ruby 2.1.0 to Travis CI;
-  * Added BitDeli and Gemnasium integration;
-  * Re-factored and cleaned up small portions of code;
-  * Made Rake "test" task to be the default tasks;
+  * Fixed issue reported by LLVM (clang).
+  * Updated development dependencies.
+  * Added Ruby 2.1.0 to Travis CI.
+  * Added BitDeli and Gemnasium integration.
+  * Re-factored and cleaned up small portions of code.
+  * Made Rake "test" task to be the default tasks.
   * Updated the ".gitignore" file to cover Bundler, rbenv, etc.
 
 -- Krzysztof Wilczynski <krzysztof.wilczynski@linux.com>  Sun, 23 Feb 2014 13:52:08 +0000
 
 fizzbuzz (0.0.5)
 
-  * Added integration with Array and Range types;
+  * Added integration with Array and Range types.
   * Added simple benchmark.
 
 -- Krzysztof Wilczynski <krzysztof.wilczynski@linux.com>  Tue, 26 Nov 2013 12:40:34 +0000
 
 fizzbuzz (0.0.4)
 
-  * Retired support for Ruby 1.8.x (no support for MRI, Ruby Enterprise Edition and Rubinius);
-  * Added Coveralls and Code Climate integration (and hence improved code test coverage);
-  * Improved error handling and made code more resilient to errors;
+  * Retired support for Ruby 1.8.x (no support for MRI, Ruby Enterprise Edition and Rubinius).
+  * Added Coveralls and Code Climate integration (and hence improved code test coverage).
+  * Improved error handling and made code more resilient to errors.
   * Fixed formatting and white spaces.
 
 -- Krzysztof Wilczynski <krzysztof.wilczynski@linux.com>  Mon, 18 Nov 2013 11:22:26 +0000
 
 fizzbuzz (0.0.3)
 
-  * Added custom exceptions and improved error handling;
-  * Added more variety of Rubies on which tests are being run with Travis CI;
+  * Added custom exceptions and improved error handling.
+  * Added more variety of Rubies on which tests are being run with Travis CI.
   * Added project to Rubygems (http://rubygems.org) so it can be installed
-    with just "gem install ruby-fizzbuzz" command;
+    with just "gem install ruby-fizzbuzz" command.
   * Renamed project from "fizzbuzz" to "ruby-fizzbuzz" to avoid clashes with
-    other Ruby gems hosted on Rubygems web site;
+    other Ruby gems hosted on Rubygems web site.
   * Made "mkmf" in extconf.rb more user-friendly (it now reports missing
-    build-time dependencies better);
+    build-time dependencies better).
   * Split Ruby gem specification (or gemspec if you wish) away from Rakefile
-    into its own file (namely ruby-fizzbuzz.gemspec);
+    into its own file (namely ruby-fizzbuzz.gemspec).
   * Improved documentation and removed bunch of small code smells.
 
 -- Krzysztof Wilczynski <krzysztof.wilczynski@linux.com>  Sat, 31 Aug 2013 17:54:54 +0000
 
 fizzbuzz (0.0.2)
 
-  * Added is_fizz?, is_buzz? and is_fizzbuzz? singleton methods to FizzBuzz class;
+  * Added is_fizz?, is_buzz? and is_fizzbuzz? singleton methods to FizzBuzz class.
   * Added fizz?, buzz? and fizzbuzz? methods to the Integer class via a monkey-patch
-    for convenience;
+    for convenience.
   * Changed behaviour of the FizzBuzz#[] singleton method, so it will yield a FizzBuzz
-    result for a given arbitrary Integer value;
-  * Re-factored code to make it cleaner, and added more tests and improved coverage;
+    result for a given arbitrary Integer value.
+  * Re-factored code to make it cleaner, and added more tests and improved coverage.
   * Re-factored FizzBuzz so it now does not assume that we always want to calculate
     results from 1 to n -- it is now possible to calculate FizzBuzz results for given
     n, m values, where n denotes start and m denotes stop value.

data/COPYRIGHT

@@ -1 +1 @@
-Copyright 2012-2013 Krzysztof Wilczynski
+Copyright 2012-2014 Krzysztof Wilczynski

data/README.rdoc

@@ -5,8 +5,8 @@ Written in C as an example of using Ruby's C API - with the support
 for arbitrary large numeric values via the Bignum class.
 
 {<img src="https://travis-ci.org/kwilczynski/ruby-fizzbuzz.png?branch=master" alt="Build Status"/>}[https://travis-ci.org/kwilczynski/ruby-fizzbuzz]
+{<img src="http://inch-ci.org/github/kwilczynski/ruby-fizzbuzz.svg?branch=master" alt="Documentation Status" />}[http://inch-ci.org/github/kwilczynski/ruby-fizzbuzz]
 {<img src="https://badge.fury.io/rb/ruby-fizzbuzz.png" alt="Gem Version" />}[http://badge.fury.io/rb/ruby-fizzbuzz]
 {<img src="https://coveralls.io/repos/kwilczynski/ruby-fizzbuzz/badge.png?branch=master" alt="Coverage Status" />}[https://coveralls.io/r/kwilczynski/ruby-fizzbuzz?branch=master]
-{<img src="https://codeclimate.com/github/kwilczynski/ruby-fizzbuzz.png" />}[https://codeclimate.com/github/kwilczynski/ruby-fizzbuzz]
+{<img src="https://codeclimate.com/github/kwilczynski/ruby-fizzbuzz.png" alt="Code Quality" />}[https://codeclimate.com/github/kwilczynski/ruby-fizzbuzz]
 {<img src="https://gemnasium.com/kwilczynski/ruby-fizzbuzz.png" alt="Dependency Status" />}[https://gemnasium.com/kwilczynski/ruby-fizzbuzz]
-{<img src="https://d2weczhvl823v0.cloudfront.net/kwilczynski/ruby-fizzbuzz/trend.png" alt="Bitdeli Badge" />}[https://bitdeli.com/free]

data/Rakefile

@@ -5,7 +5,7 @@
 #
 # Rakefile
 #
-# Copyright 2012-2013 Krzysztof Wilczynski
+# Copyright 2012-2014 Krzysztof Wilczynski
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -70,10 +70,8 @@ Rake::ExtensionTask.new('fizzbuzz', gem) do |e|
   e.lib_dir = 'lib/fizzbuzz'
 end
 
-Rake::Task[:test].prerequisites << :compile
-
 desc 'Run benchmarks'
-task :benchmark, [:first] => :test do |t,argument|
+task :benchmark, [:first] do |t,argument|
   glob = File.expand_path("../benchmark/*.rb", __FILE__)
   Dir[glob].each do |f|
     process = ['ruby', f]
@@ -90,6 +88,9 @@ task :benchmark, [:first] => :test do |t,argument|
   end
 end
 
+Rake::Task[:test].prerequisites << :clobber
+Rake::Task[:test].prerequisites << :compile
+
 task :default => :test
 
 # vim: set ts=2 sw=2 sts=2 et :

data/TODO

@@ -1,11 +1,11 @@
-fizzbuzz (0.0.8)
+fizzbuzz (0.9.0)
 
   * Improve github project page;
   * Re-factor unit tests to make them more idiomatic (maybe move to Rspec and BDD?).
 
--- Krzysztof Wilczynski <krzysztof.wilczynski@linux.com>  Sun, 23 Feb 2014 13:52:08 +0000
+-- Krzysztof Wilczynski <krzysztof.wilczynski@linux.com>  Mon, 15 Dec 2014 00:27:26 +0000
 
-fizzbuzz (0.0.7)
+fizzbuzz (0.8.0)
 
   * Move to YARD from RDoc (as RDoc is very bad, really);
   * Add pure-Ruby implementation;
@@ -13,4 +13,4 @@ fizzbuzz (0.0.7)
   * Add Doxygen style comments for other functions in the source code;
   * Improve documentation i.e. source code commenting, README file, etc.
 
--- Krzysztof Wilczynski <krzysztof.wilczynski@linux.com>  Sun, 23 Feb 2014 13:52:08 +0000
+-- Krzysztof Wilczynski <krzysztof.wilczynski@linux.com>  Mon, 15 Dec 2014 00:27:26 +0000

data/VERSION

@@ -1 +1 @@
-0.0.6
+0.7.0

data/benchmark/benchmark_fizzbuzz.rb

@@ -5,7 +5,7 @@
 #
 # benchmark_fizzbuzz.rb
 #
-# Copyright 2012-2013 Krzysztof Wilczynski
+# Copyright 2012-2014 Krzysztof Wilczynski
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -37,7 +37,7 @@ CAPTION = "%8s%12s%11s%10s\n" % %w(User System Total Real)
 n = (ARGV.shift || 1_000_000).to_i
 
 start   = Time.now
-array   = (1 .. n).to_a
+array   = (1..n).to_a
 reports = []
 
 puts "FizzBuzz #{FizzBuzz::VERSION}, n = #{n}\n\n"
@@ -76,11 +76,11 @@ Benchmark.benchmark(CAPTION, 24) do |bm|
   end
 
   reports << bm.report('Array#fizzbuzz') do
-    (1 .. n).fizzbuzz
+    array.fizzbuzz
   end
 
   reports << bm.report('Range#fizzbuzz') do
-    array.fizzbuzz
+    (1..n).fizzbuzz {|i| i }
   end
 
   []

data/bin/fizzbuzz

@@ -7,7 +7,7 @@
 #
 # fizzbuzz
 #
-# Copyright 2012-2013 Krzysztof Wilczynski
+# Copyright 2012-2014 Krzysztof Wilczynski
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/ext/fizzbuzz/common.h

@@ -3,7 +3,7 @@
 /*
  * common.h
  *
- * Copyright 2012-2013 Krzysztof Wilczynski
+ * Copyright 2012-2014 Krzysztof Wilczynski
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

data/ext/fizzbuzz/extconf.rb

@@ -5,7 +5,7 @@
 #
 # extconf.rb
 #
-# Copyright 2012-2013 Krzysztof Wilczynski
+# Copyright 2012-2014 Krzysztof Wilczynski
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -24,10 +24,17 @@ require 'mkmf'
 
 RbConfig::MAKEFILE_CONFIG['CC'] = ENV['CC'] if ENV['CC']
 
+$CFLAGS << ' -std=c99 -g -Wall -Wextra -pedantic'
+
+unless RbConfig::CONFIG['host_os'][/darwin/]
+  $LDFLAGS << ' -Wl,--as-needed'
+end
+
 $LDFLAGS << " %s" % ENV['LDFLAGS'] if ENV['LDFLAGS']
 
-$CFLAGS << " %s" % ENV['CFLAGS'] if ENV['CFLAGS']
-$CFLAGS << ' -std=c99 -g -Wall -Wextra -pedantic'
+%w(CFLAGS CXXFLAGS CPPFLAGS).each do |variable|
+    $CFLAGS << " %s" % ENV[variable] if ENV[variable]
+end
 
 unless have_header('ruby.h')
   abort <<-EOS

data/ext/fizzbuzz/fizzbuzz.c

@@ -3,7 +3,7 @@
 /*
  * fizzbuzz.c
  *
- * Copyright 2012-2013 Krzysztof Wilczynski
+ * Copyright 2012-2014 Krzysztof Wilczynski
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -18,6 +18,10 @@
  * limitations under the License.
  */
 
+#if defined(__cplusplus)
+extern "C" {
+#endif
+
 #include <fizzbuzz.h>
 
 ID id_at_start, id_at_stop;
@@ -49,7 +53,7 @@ static VALUE fizzbuzz_range_error(VALUE klass, VALUE start, VALUE stop,
  *
  * Returns a new _FizzBuzz_.
  *
- * The given +start+ and +stop+ values must be of an integer type and
+ * The given +start+ and +stop+ values must be of an _Integer_ type and
  * will establish a +range+ within which calculation of any relevant
  * _FizzBuzz_ results will have place.
  *
@@ -64,7 +68,7 @@ static VALUE fizzbuzz_range_error(VALUE klass, VALUE start, VALUE stop,
  * exception.
  *
  * Will raise a <i>FizzBuzz::TypeError</i> exception if given value of either
- * +start+ or +stop+ is not an _Integer_ or _Bignum_ type.
+ * +start+ or +stop+ is not an _Fixnum_ or _Bignum_ type.
  *
  * See also: FizzBuzz::fizzbuzz and FizzBuzz::[]
  */
@@ -119,7 +123,7 @@ rb_fb_get_start(VALUE object)
  *    fb.start                    #=> 15
  *
  * Will raise a <i>FizzBuzz::TypeError</i> exception if given value is not
- * an _Integer_ or _Bignum_ type.
+ * an _Fixnum_ or _Bignum_ type.
  */
 VALUE
 rb_fb_set_start(VALUE object, VALUE value)
@@ -165,7 +169,7 @@ rb_fb_get_stop(VALUE object)
  *    fb.stop                     #=> 15
  *
  * Will raise a <i>FizzBuzz::TypeError</i> exception if given value is not
- * an _Integer_ or _Bignum_ type.
+ * an _Fixnum_ or _Bignum_ type.
  */
 VALUE
 rb_fb_set_stop(VALUE object, VALUE value)
@@ -211,6 +215,11 @@ rb_fb_array(VALUE object)
  * Example:
  *
  *    fb = FizzBuzz.new(1, 15)   #=> #<FizzBuzz:0xf722f8ec @stop=15, @start=1>
+ *    fb.each                    #=> #<Enumerator: #<FizzBuzz:0x007fc5139e5540 @start=1, @stop=15>:each>
+ *
+ * Example:
+ *
+ *    fb = FizzBuzz.new(1, 15)   #=> #<FizzBuzz:0xf722f8ec @stop=15, @start=1>
  *    fb.each {|value| puts "Got #{value}" }
  *
  * Produces:
@@ -248,9 +257,14 @@ rb_fb_enumerator(VALUE object)
  * from +start+ to +stop+ in an <i>reverse order</i>, passing the value
  * as a parameter to the block.
  *
+ * If no block is given, an +Enumerator+ is returned instead.
+ *
  * Example:
  *
- * If no block is given, an +Enumerator+ is returned instead.
+ *    fb = FizzBuzz.new(1, 15)   #=> #<FizzBuzz:0xf722f8ec @stop=15, @start=1>
+ *    fb.each                    #=> #<Enumerator: #<FizzBuzz:0x007fc513a0de00 @start=1, @stop=15>:reverse_each>
+ *
+ * Example:
  *
  *    fb = FizzBuzz.new(1, 15)   #=> #<FizzBuzz:0xb7308664 @stop=15, @start=1>
  *    fb.reverse_each {|value| puts "Got #{value}" }
@@ -295,7 +309,7 @@ rb_fb_reverse_enumerator(VALUE object)
  *    FizzBuzz.is_fizz?(15)   #=> false
  *
  * Will raise a <i>FizzBuzz::TypeError</i> exception if given value is not
- * an _Integer_ or _Bignum_ type.
+ * an _Fixnum_ or _Bignum_ type.
  *
  * See also: FizzBuzz::[]
  */
@@ -322,7 +336,7 @@ rb_fb_is_fizz(VALUE object, VALUE value)
  *    FizzBuzz.is_buzz?(15)   #=> false
  *
  * Will raise a <i>FizzBuzz::TypeError</i> exception if given value is not
- * an _Integer_ or _Bignum_ type.
+ * an _Fixnum_ or _Bignum_ type.
  *
  * See also: FizzBuzz::[]
  */
@@ -349,7 +363,7 @@ rb_fb_is_buzz(VALUE object, VALUE value)
  *    FizzBuzz.is_fizzbuzz?(15)   #=> true
  *
  * Will raise a <i>FizzBuzz::TypeError</i> exception if given value is not
- * an _Integer_ or _Bignum_ type.
+ * an _Fixnum_ or _Bignum_ type.
  *
  * See also: FizzBuzz::[]
  */
@@ -379,7 +393,7 @@ rb_fb_is_fizzbuzz(VALUE object, VALUE value)
  *    FizzBuzz[15]   #=> "FizzBuzz"
  *
  * Will raise a <i>FizzBuzz::TypeError</i> exception if given value is not
- * an _Integer_ or _Bignum_ type.
+ * an _Fixnum_ or _Bignum_ type.
  *
  * See also: FizzBuzz::is_fizz?, FizzBuzz::is_buzz? and FizzBuzz::is_fizzbuzz?
  */
@@ -407,6 +421,12 @@ fizzbuzz_evaluate(VALUE value)
     assert((score >= 0 && score <= 3) && \
             "Score value out of bounds, must be between 0 and 3 inclusive");
 
+    /*
+     * The CSTR2RVAL macro uses rb_str_new2(const char *) which is
+     * rather slow due to all the heavy lifting done internally by
+     * str_new0(VALUE, const char *, long, int) to allocate space
+     * for the new String object, etc.
+     */
     return score < 1 ? value : CSTR2RVAL(word(score));
 }
 
@@ -554,4 +574,8 @@ Init_fizzbuzz(void)
     rb_define_singleton_method(rb_cFizzBuzz, "[]", RUBY_METHOD_FUNC(rb_fb_square), 1);
 }
 
+#if defined(__cplusplus)
+}
+#endif
+
 /* vim: set ts=8 sw=4 sts=2 et : */