facets 2.9.3 → 3.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 04425cff670267fec297484f50e19edbb8a22fc8
+  data.tar.gz: 19b9480ec202b072704267dc8760209cb6648338
+SHA512:
+  metadata.gz: e36beb518158636837793bcab25e5c004cfd904d8e78f865099ff5b904ee562f04078d3d6ff5e10a7ab02b225de49d3ba51365fdc3538d50725855b0a5830baf
+  data.tar.gz: 13b826e5a84e8c7b91562c2df850eb16972a843dc6f6546f7f0aaf34a548d9db2c3d27935ea39a98573700d65cfe3bbdac183f8df2cdb1b66b68ee4faa9d8e54

data/.index

@@ -0,0 +1,76 @@
+---
+revision: 2013
+type: ruby
+sources:
+- Indexfile
+- Gemfile
+authors:
+- name: Thomas Sawyer
+  email: transfire@gmail.com
+organizations:
+- name: Rubyworks
+requirements:
+- groups:
+  - test
+  version: '>= 0'
+  name: lemon
+- groups:
+  - test
+  version: '>= 0'
+  name: qed
+- groups:
+  - test
+  version: '>= 0'
+  name: rubytest-cli
+- groups:
+  - test
+  version: '>= 0'
+  name: rake
+- groups:
+  - test
+  version: '>= 0'
+  name: simplecov
+conflicts: []
+alternatives: []
+resources:
+- type: home
+  uri: http://rubyworks.github.com/facets
+  label: Homepage
+- type: code
+  uri: http://github.com/rubyworks/facets
+  label: Source Code
+- type: docs
+  uri: http://rubyworks.github.com/facets/learn.html
+  label: Documentation
+- type: wiki
+  uri: http://wiki.github.com/rubyworks/facets
+  label: User Guide
+- type: talk
+  uri: http://groups.google.com/group/facets-universal
+repositories:
+- name: upstream
+  scm: git
+  uri: git@github.com:rubyworks/facets.git
+categories: []
+copyrights:
+- holder: Rubyworks
+  year: '2004'
+  license: BSD-2-Clause
+customs: []
+paths:
+  load:
+  - lib/core
+  - lib/standard
+name: facets
+title: Ruby Facets
+version: 3.0.0
+summary: The orginal well curated collection of extension methods for Ruby.
+slogan: ALL YOUR BASE ARE BELONG TO RUBY!
+description: Facets is the premier collection of extension methods for the Ruby programming
+  language. Facets extensions are unique by virtue of thier atomicity. They are stored
+  in individual files allowing for highly granular control of requirements. In addition,
+  Facets includes a few additional classes and mixins suitable to wide variety of
+  applications.
+scm_uri: https://github.com/rubyworks/facets/tree/master
+created: '2004-12-16'
+date: '2014-12-20'

data/CONTRIBUTE.md

@@ -0,0 +1,78 @@
+# CONTRIBUTING TO FACETS
+
+* Facets methods must have no external dependencies. (The only possible
+  exception to this is if the functor gets spun-off as a separate gem along
+  with related methods, but for now that's not happening.)
+
+* Each method must be in it's own file of the same name. If the method ends
+  with `=` or `?` just leave it off the file name. 
+
+* On rare occasion two or more methods can be very tightly related. In these
+  cases the methods can all go in a single file under the name of the method
+  considered most significant. Usually files for the other methods should
+  still be created that simply require the main file.
+
+* Methods must be tested either via a Lemon unit test or a QED demo,
+  preferably both. The Lemon unit tests are for testing a method in
+  detail whereas the QED demos are for demonstrating usage.
+
+* Facets is divided into two parts, *core* and *standard* libraries.
+  All of the core library is loaded by default when using `require 'facets'`
+  (actually, almost all). The standard library (sometimes called the *more*
+  library) must be required per-script.
+
+* Some core methods are included on a *trial* basis, and these are not 
+  necessary loaded automatically with `require 'facets'`.
+
+* Standard libraries that are not extensions of existing standard libraries
+  do not have to be divvied up into individual method files. But note that
+  full classes and/or modules are less likely to make it into Facets, as
+  these sorts of additions to Facets are only for very basic sorts of things.
+  Otherwise they'd deserve their own gem.
+
+* When submitting new methods for consideration, it is best if each method
+  (or *tightly related* set of methods) is in it's own pull request. If you
+  have only one method to submit then a simple  commit will do the tirck. If
+  you have more than one it best to use separate branches. Let me emphasizes
+  this point because it makes it *much more likely* that your pull request
+  will be merged. If you submit a bunch of methods in a single pull request,
+  it is very likely that it will not be merged even if methods you submitted
+  are accepted!!!
+
+* Don't be discouraged when you get feedback about a method that isn't
+  all sunshine and roses. Facets has been around long enough now that 
+  it needs to maintain a certain degree of quality control, and that means
+  serious discernment about what goes into the library. That includes 
+  having in depth discussions the merits of methods, even about the best
+  name for a method --even if the functionality has been accepted the name
+  may not!
+
+* When making a commit, if the commit is only a documentation change, then
+  and `[doc]` to the end of the first line of commit message. If it is only
+  a change to tests then add `[test]`. If the change only effects build files
+  then add `[admin]`. For actual code changes, if the change is not somethng
+  anyone would notice, use `[tweak]` or `[minor]` (minor being slightly more
+  improtant than tweak). For typical code changes no comment tag is necessary.
+  If the change fixes a bug that was reported via the issue system be sure to
+  reference the issue id in the message using `#` and add `[bug]`. If a change
+  is a significant change to the API, then end the message with `[major]`.
+  These are all rules of thumb, and no expects them to be applied perfectly.
+
+## Documentation
+
+Facets started when the only choice for API documentation was RDoc. So originally
+that's how methods were documented. Since then both YARD and Tomdoc have come
+along. And some of these documentation styles have creeped into a number of
+methods. So right now, things are a bit messy. But going forward it looks like we 
+are going to settle on Tomdoc as the official documentation style (but using
+the tomparse gem's extensions). Using Tomdoc will give us reasonable
+interoperabiltiy with both RDoc and YARD, both of which now have support for
+Tomdoc (albeit support is not 100% the same, but hopefully it's close enough).
+
+Offically we publish documentation via rubydoc.info, which is the YARD server,
+and via the Facets website in Shomen JSON format.
+
+When writting documentation for a method it is best to give a simple summary 
+explaination, followed by some basic examples. Follow that up with deeper
+explaination if needed, including *when* and *why* the method could be useful.
+

data/HISTORY.md

@@ -0,0 +1,2459 @@
+# Facets Release History
+
+## 3.0.0 / 2014-11-11
+
+This major release has been a long time in coming --too long in fact. As with
+any "Point Oh" release, please expect a few hiccups and report them so we can
+get a solid 3.1 release out as soon as possible.
+
+This release is tailored for Ruby 2.0 and above. Ruby 1.9.x and older is no
+longer supported. If you still need to use Facets with Ruby 1.9.x or older
+then the excellent Backports project can be used to fill in the gaps. 
+
+Changes:
+
+* New Features
+
+  * Add Array#arrange
+  * Add Array#intersection
+  * Add Array#missing
+  * Add Array#uniqe_permutation
+  * Add Dir.lookup method
+  * Add Enumerator::Lazy#squeeze
+  * Add Hash#fetch_nested
+  * Add Kernel#instance_extract
+  * Add Math#EC for Euler's constant
+  * Add Pathname#chdir
+  * Add Pathname#readline
+  * Add Proc.wrap (may become `Kernel#Proc()`)
+  * Add Range#- and Range#+
+  * Add Regexp#to_proc
+  * Add String#each_match as alias for #mscan
+  * Add Time.current
+
+* Improved Features
+
+  * Enumerable#sum argument is initial value.
+  * Hash#collate can take multiple arguments.
+  * Hash#collate no longer flattens automatically.
+  * Time#past? and #future? use Time.current.
+  * Better ActiveSupport compatibility.
+
+* Renamed Features
+
+  * Rename Object#replace to Object#instance_replace.
+  * Rename Range#to_r to Range#to_rng, since #to_r is now for Rational.  
+
+* Bug Fixes
+
+  * Fix Platform#inspect.
+
+* Deprecated Features Now in Ruby
+
+  * Deprecate Array#combination (now in Ruby).
+  * Deprecate Array#index (now in Ruby).
+  * Deprecate Array#permutation (now in Ruby).
+  * Deprecate Array#product (now in Ruby).
+  * Deprecate Array#rotate (now in Ruby).
+  * Deprecate Array#rotate! (now in Ruby).
+  * Deprecate Array#select! (now in Ruby).
+  * Deprecate Binding#eval (now in Ruby).
+  * Deprecate Float#round_at (now in Ruby as #round).
+  * Deprecate Hash#select! (now in Ruby).
+  * Deprecate Integer#even? (now in Ruby).
+  * Deprecate Integer#odd? (now in Ruby).
+  * Deprecate Kernel#__callee__ (now in Ruby).
+  * Deprecate Kernel#__method__ (now in Ruby).
+  * Deprecate Kernel#source_location (now in Ruby).
+  * Deprecate NilClass#to_f (now in Ruby).
+  * Deprecate NilClass#to_h (now in Ruby).
+  * Deprecate Numeric#round_at (now in Ruby as #round).
+  * Deprecate Proc#curry (now in Ruby).
+  * Deprecate String#bytes (now in Ruby).
+  * Deprecate String#each_char (now in Ruby).
+  * Deprecate String#end_with (now in Ruby).
+  * Deprecate String#lines (now in Ruby).
+  * Deprecate String#start_with (now in Ruby).
+  * Deprecate Symbol#to_proc (now in Ruby).
+  * Deprecate UnboundMethod#name (now in Ruby).
+
+
+## 2.9.3 / 2011-12-31
+
+Happy New Year! Ruby Facets kicks off the year with a 2.9.x release.
+This release adds a number of new methods, a few general improvements
+and bug fixes, a couple of deprecations and finally settles the 
+project down to a two-part core/standard project organization.
+
+Changes:
+
+* New Features
+
+  * Add Hash#url_params. (Matt Kirk)
+  * Add Enumerable#hashify. (Ronen Barzel)
+  * Add String#briefcase, similar to #titlecase.
+  * Add Kernel#hierarchical_send (better replacement for preinitialize.rb).
+  * Add Class#hierarchically, which supports #hierarchical_send.
+  * Add Array#median, to get the sorted middle of an array.
+  * Add Math#percentile and Math#median.
+  * Add Instantiable mixin (returns from Mixers spin-off project).
+  * Add Equitable mixin (returns from Mixers spin-off project).
+  * Add Cloneable mixin (returns from Mixers spin-off project).
+  * Add Array#each_pair and #each_value.
+  * Add Numeric#positive? and #numeric?.
+  * Add Method#* and #^ composition methods. (Mike Burns)
+  * Add back Fixnum::MAX and MIN constants.
+  * Add Binding#with.
+
+* Improved Features
+
+  * Improve FileUtils#amass to be more robust.
+  * Improve String#snakecase to convert spaces to underscores.
+  * Improve String#camelcase to convert spaces to "camels".
+  * Improve String#snakecase to not handle path names (use #pathize).
+  * Improve String#camelcase to not handle module names (ise #modulize).
+  * Improve Numeric#approx? bu using ratio.
+
+* Renamed Features
+
+  * Rename Enumerable#has? to #incase?.
+
+* Bug Fixes
+
+  * Fix Hash#rekey to keep default_proc.
+  * Fix Binding#self to not be defined for Rubinius.
+
+* Deprecations
+
+  * Deprecate Preinitializable mixin.
+  * Deprecate main.rb, spun-off to `main_like_module` gem.
+
+* Implementation Details
+
+  * Reconsolidated library into just two parts, `core` and `standard`.
+  * The term "more" is just a synonym for "standard" now.
+  * Relative requires are being used more extensively.
+  * Collection scripts, e.g. `require 'facets'`, are static.
+
+
+## 2.9.2 / 2011-08-23
+
+The main purpose of this release is a fix for Module#redefine_method,
+so it will not conflict with ActiveSupport. Beyond that a handful of new
+methods have been added. This release also marks the start of using
+a src/ directory to generate the lib/ directory.
+
+Changes:
+
+* New Features
+
+  * Add Enumerable#map_with and alias #zip_map.
+  * Hash#delete_values returns removed keys (#12).
+  * Add clap-like command-line parser to Shellwords.
+  * Add Module#let, akin to RSpec's method.
+  * Add uncommon Module#method_clash method.
+  * Add uncommon Class#singleton? method.
+
+* Bug Fixes
+
+  * Fix Module#redefine_method to use #remove_method.
+  * Fix Kernel#object_hexid, or at least try to do so again.
+  * Fix Exception#detail to not return backtrace if nil.
+
+
+## 2.9.1 / 2011-01-30
+
+Primarily this release fixes a couple of small issues. But also a handful of
+new methods have been added.
+
+Changes:
+
+* New Features:
+
+  * Add FileTest#absolute? and #relative?
+  * Add FileTest#contains?
+  * Add FileTest#safe?
+  * Add FileUtils#amass
+  * Add FileUtils#outofdate
+  * Add FileUtils#stage
+  * Add Kernel#yes? and Kernel#no?
+  * Add Enumerable#has? (TOUR library)
+  * Add Digest#salted_digest, etc.
+  * Add Digest#base64digest (1.9.2 method)
+  * Add String#random_binary
+
+* Improved Features
+
+  * Better OS detection in Platform class and RBConfig module
+  * Moved CPU byte order methods from RBConfig to Platform class
+  * General improvements to Platform class API
+
+* Bug Fixes
+
+  * Module#redefine_method need not check pre-existence of method
+  * Fix string/unquote.rb recursive require
+  * Kernel#object_hexid varies on CPU arch, not Ruby version.
+
+
+## 2.9.0 / 2010-09-01
+
+This release is fairly extensive as it was originally intended to be v3.0.
+After further consideration it was decided to reserve v3.0 for the
+polish of real world feedback and more progressive changes. The primary
+focus of this release has been the completion of migrating Facets into a true
+extensions library. With this release almost all add-on classes and mixins
+have now been spun-off to other projects. Only the most general purposes
+add-on classes and mixins remain.
+
+A new TOUR library division has also been added to complement CORE and MORE.
+This division houses purely optional extensions. The new division serves
+a couple of useful purposes. In particular, it helps separates the standard
+library extensions from optional core extension in the RDocs and thus makes
+the perfect place to vet new extension ideas.
+
+One important change that will effect anyone using Facets along side
+ActiveSupport is that Facets no longer tries to conditionally avoid
+method overlaps with ActiveSupport. This is fine for the upcoming
+ActiveSupport 3.0 library which extends core classes directly instead of
+using mixins. One need only require 'facets' in the Rails config/preinitializer.rb
+file and ActiveSupport will take precedence over Facets. For older versions
+of ActiveSupport, the best approach is to cherry pick from Facets just the
+extensions you want, thus avoiding any conflicts. There are actually only a
+dozen or so overlaps and all are intended to compatible, but it doesn't hurt
+to be sure.
+
+Lastly, it is worth mentioning that this release has been more thuroughly
+tested than any version of Facets to date. Thanks to RVM this release runs
+green on Ruby 1.8.6, 1.8.7 and 1.9.2.
+
+Changes:
+
+* New Features
+
+  * Add Kernel#temporarily, set variables temporarily and eval block
+  * Add Kernel#deep_clone, a better alternative to #deep_copy
+  * Add Kernel#present? and Kernel#presence
+  * Add Kernel#not and #not?
+  * Add Array#extract_options!, for pulling options off argument list
+  * Add Regexp#|, operator for Regexp#union
+  * Add Array#percentile and Array#median
+  * Add Module#memo, for instance level memoization
+  * Add YAML.read method
+  * Add Pathname#include?
+  * Add Module#anonymous?
+  * Add Module#copy_inheritor
+  * Add Indexable#from and Indexable#upto
+  * Add Array#from and Array#thru
+  * Add NA class via na.rb
+  * Add Memoizable in memoizable.rb for a more robust memoization system
+  * Add Module#safe_memo in thread.rb for thread safe memoization
+  * Add Kernel#sandbox in thread.rb for threaded $SAFE=4 evaluation
+  * Add Hash#subset
+  * Add Kernel#Y to tour library
+  * Add numerous Math extensions
+
+* Deprecations
+
+  * Deprecate Module#attr_toggler as a YAGNI
+  * Deprecate Kernel#class_eval b/c of it's confusing behavior
+  * Deprecate Module#once is no longer an alias for #memoize
+  * Deprecate Integer#succ(n) (for compatibility reasons)
+  * Deprecate Stackable, it's method were moved to CORE
+  * Deprecate Kernel#populate and #set_from (use #assign and #assign_from)
+  * Deprecate Kernel#non_nil? since #not_nil? is enough
+  * Deprecate #__HERE__ b/c implementation was unreliable
+  * Deprecate Time#since, use #less instead
+  * Deprecate Time#advance, use #shift instead
+  * Deprecate Kernel#super_as (no good way to get callers method name)
+  * Deprecate Integer#clear_bit, use #bit_clear instead
+  * Deprecate Kernel#resc, use String#to_re or #to_rx instead
+  * Deprecate Module#modspace
+  * Deprecate Kernel#__ and class X for Proc#partial, use NA instead
+  * Deprecate autoreload.rb has been spun-off to a separate project
+  * Deprecate Module#nesting, b/c redundant and overlap with Module.nesting
+
+* Renamed Features
+
+  * Rename Module#parent            to Module#enclosure
+  * Rename Module#parents           to Module#enclosures
+  * Rename Module#parent_name       to Module#modname
+  * Rename Array#recurisvely        to Array#recurse  
+  * Rename Hash#recurisvely         to Hash#recurse
+  * Rename Enumerable#recursive     to Enumerable#recursively
+  * Rename Array#recursive          to Array#recursively
+  * Rename Hash#recursive           to Hash#recursively        
+  * Rename Kernel#silence_warnings  to Kernel#disable_warnings
+  * Rename Hash#recursive_merge     to Hash#deep_merge
+  * Rename Class#prepend            to Class#preallocate
+  * Rename File#atomic_write        to FileUtils#atomic_write
+  * Rename Module#conflict          to Module#method_clash
+  * Rename Class#inheritor          to Module#class_inheritor
+  * Rename Symbol#re_s              to Symbol#as_s
+  * Rename String#chars             to String#characters
+  * Rename String#outdent           to String#unindent
+  * Rename Time#round               to Time#round_to
+  * Rename Time#hence               to Time#shift (but keep aliases)
+  * Rename Hash#zipnew              to Hash#zip
+
+* Moved Libraries
+
+  * Move roman.rb to integer/roman and string/roman.rb
+  * Move blank.rb to kernel/blank.rb
+  * Move facets-live.rb to facets/auto_core.rb
+  * Move cattr.rb to MORE library
+  * Move duplicable.rb to kernel/dup.rb
+  * Move bitmask.rb to integer/bitmask.rb
+  * Move enumerable/divide.rb to array/divide.rb
+  * Move enumerable/split.rb to array/split.rb
+  * Move enumerable/entropy.rb to array/entropy.rb
+  * Move enumerable/probability.rb to array/probability.rb
+  * Move enumerable/duplicates.rb array/duplicates.rb
+  * Move module/enclosure.rb to optional TOUR libs
+  * Move kernel/instance_exec to option TOUR libs
+
+* Bug Fixes
+
+  * Fix Fixed Hash#rekey! from clobbering previous keys
+  * Fix Exception#raised? is a class method
+  * Fix Enumerator#fx should use #map instead of #each
+  * Fix String#splice needs String#store
+  * Fix Kernel#blank? empty condition was faulty
+  * Fix Comparable#bound needs clip.rb, not cap.rb
+  * Fix String#file needs to pass block
+  * Fix String#edit_distance use new encodings for Ruby 1.9
+
+* Improved Features
+
+  * New lib/tour division of libraries
+  * Module#class_extend dynamically creates append_features method
+  * Kernel#require_all is only for relative requires
+  * __DIR__ can take subdirectory arguments
+  * Hash#join has more sensible default separator (' ')
+  * Some OpEsc escapes have been renamed
+  * Kernel#assign does not accept a block
+  * Kernel#try is now like ActiveSupport's
+  * Improved #respond (which is like old #try)
+  * Remove all `if defined?(ActiveSupport)` conditions
+  * Use #random_range to support specialized Range#at_rand functionality
+  * Use Comparable.[] instead of Comparable()
+  * Array#rotate rotates in opposite direction than before (b/c or Ruby 1.9)
+
+
+## 2.8.4 / 2010-04-27
+
+A minor point release just to get a few improvements out there before
+endeavering into more extensive work for the next major release.
+
+* New Features
+
+  * Added #glob_relative to Pathname
+
+* Deprecations
+
+  * Deprecated BlankSlate (use BasicObject)
+  * Deprecate hashbuilder.rb
+  * Removed casting_hash.rb, moved to new library
+  * Removed opencollection.rb, moved to new library
+  * Removed ansicode.rb, use ansi gem
+
+* Bug Fixes
+
+  * changed Numeric#length to return self, not to_s.self
+  * Fix mispelling of Class#descendants
+
+* Other Improvements
+
+  * Range#at_rand has been optimized
+  * Kernel#singleton_class no longer can take a block
+  * Hash#to_proc takes response argument replacing #to_proc_with_response
+  * OpenHash becomes more like OpenObject and OpenObject becomes bare bones
+  * Range#at_rand optimized for Fixnum/Bignum instead of Integer
+
+
+## 2.8.3 / 2010-04-10
+
+New release which makes a few adjustments in Kernel core extensions,
+adds a few new extensions and additions, plus other small improvements.
+The biggest change is the addition of Recusor, which is created via
+Enumerable#recursive. This class is somewhat like Enumerator and
+provides a number of recursive methods.
+
+Changes:
+
+* 9 New Core Extensions
+
+  * Enumerable#recursive provides a number of other recursive methods.
+  * Enumerable#visit can be used to recursively iterate any Enumerable.
+  * Module#set has been added (from Sinatra).
+  * Symbol#/ is added to be like String#/.
+  * Struct#to_h is added and will ultimately replace Struct#attributes.
+  * ObjectSpace#reflect routes method calls to Kernel context.
+  * Hash#to_module converts a hash to mixin module (Jay Fields).
+  * Kernel#dup! is same as #try_dup from extlib.
+  * Add File#ext which is a useful variation of #extname (Lavir the Whiolet).
+
+* 3 Core Extensions Renamed
+
+  * Renamed #set_from to #assign_from (alias remains until Kernel#set is considerd).
+  * Renamed #populate to #assign and improve.
+  * Kernel#instance_vars is now Kernel#instance and also more useful.
+
+* 1 Core Deprecation
+
+  * Removed #instance_eval hack.
+
+* 2 Core Bug Fixes
+
+  * #map_with_index now uses #each_with_index.
+  * #to_proc_with_response spelling correction.
+
+* 1 Core Adjustment
+
+  * Aliased #metadef to #meta_def.
+
+* 3 New More Libraries
+
+  * casting_hash.rb provides CastingHash class, a hash with flexible keys and values.
+  * prepend.rb allows for AOP-like inclusion of modules.
+  * roman.rb provides simple roman numeral extensions to String and Integer.
+
+* 5 More Improvements
+
+  * Pathname#visit for iterating all entries beneath a path (chikamichi).
+  * Pathname#to_str, b/c Pathname is basically a type of String (from extlib).
+  * Range#at_rand in random.rb handles Float ranges (Lavir the Whiolet).
+  * FileUtils#cp_rx provides controlled copies.
+  * Stash class in stash.rb is improved and is now available as a stand-alone library.
+  * ioredirect.rb has been removed as IORedirect no longer worked.
+  * plugin_manager.rb has been removed. Use 'plugin' gem instead.
+
+
+## 2.8.2 / 2010-02-22
+
+This release fixes a bug by removing Numeric#size. Turns out that was a
+core method already. It includes an "auditing" of the core enumerable
+method which has led to a few modifications most noteable amoung them
+renaming #map_detect to #find_yield and #compact_map to #purge.
+
+Changes:
+
+* 7 New Core Extensions
+
+  * Add Enumerable#each_with_object.
+  * Add #collapse which is a shortcut for flatten.compact.
+  * Add Numeric#spacing (Mr. Groff)
+  * Add Array#uniq_by! to complement Enumerable#uniq_by.
+  * Add String#exclude? as opposite of #include?
+  * Add Enumerable#exclude? as opposite of #include?
+  * Add Proc#bind_to 
+
+* 2 Extensions Renamed
+
+  * Rename Enumerable#compact_map to #purge.
+  * Rename Enumerable#map_detect to #find_yield.
+
+* 4 Deprecations
+
+  * Deprecate #inject!/#injecting in favor of #filter.
+  * Deprecate Array#** as alias of #product.
+  * Remove Numeric#size, as it was already used by core.
+  * Spun tracepoint.rb off as a seprate library.
+
+* 3 Other Changes
+
+  * Integer#multiple? handles zero as an argument.
+  * facets.rb is now dynamically loaded instead of code generated.
+  * General imporvements to date.rb.
+
+
+## 2.8.1 / 2009-12-25
+
+This release simply fixes a few minor issues.
+
+Changes:
+
+* 1 New Standard Extension
+
+  * Added Pathname#glob_relative to pathanme.rb.
+
+* 3 Adjustments
+
+  * Loading string/tab.rb no longer loads margin.rb or expand_tab.rb.
+  * Fixed FileList method delegations.
+  * Numeric#length and #size return +self+, not +to_s.length+.
+
+
+## 2.8.0 / 2009-11-05
+
+Facets 2.8 effectively completes the MORE library clean-up which peaked
+with the previous 2.7 release. Another eight libraries have been deprecated,
+a few of them spun-off to a separate project. However, this verison also
+reverts a few of the deprecations made in the last version. These libs 
+will remain in Facets's MORE library for the forseeable future.
+
+This version effectively concludes the MORE library clean-up. The next, and
+last version before Facets 3.0, will focus on "auditing" the CORE library.
+
+Changes:
+
+* 6 Libraries "Undeprecated":
+
+  * ini.rb
+  * linkedlist.rb
+  * matcher.rb
+  * memoizer.rb
+  * roman.rb
+  * semaphore.rb
+
+* 5 Libraries Deprecated:
+
+  * fileable.rb    (too esoteric)
+  * ioredirect.rb  (needs better implementation)
+  * coroutine.rb   (because of Fiber)
+  * capsule.rb     (may be spun-off)
+  * recorder.rb    (may be spun-off)
+
+* 3 Libraries Spun-Off and Deprecated:
+
+  * ansicode.rb           ansi
+  * progressbar.rb        ansi
+  * logger.rb             ansi
+
+* Additonal Enhancements:
+
+  * Kernel#extend can now take a block
+  * Fixed kernel#d so it is useable
+  * Added Range#at_rand (thanks to Tyler Rick)
+  * Added Enumerable#map_detect (thanks to Scott Taylor)
+  * String#/ calls File.join
+  * Added String#newlines and String#cleanlines
+  * String#titlecase includes apostrophe in words
+  * BasicObject/BlankSlate is more compliant with 1.9.1 design
+  * Enumerable#count can take multiple items, treats as logical Or
+  * Class#class_extend extends class level, not class_eval
+  * Integer#succ(n) becomes Fixnum#succ(n), succ.rb
+  * Complete rewrite of Inheritor
+  * Shellwords extensions have been reworked
+  * Added String#similarity
+  * Added Levenshtein String#edit_distance method
+  * And other minor improvements (some thanks to ccjr)
+
+
+## 2.7.0 / 2009-08-01
+
+Facets 2.7 is the biggest release of Facets since 2.4. Rather then trickle-release these
+changes over the course of the 2.6.x series, I made the decision to let 2.7 have them
+all at once. In so doing this release nearly completes the process of trimming down
+the MORE library to its essentials. Over 40 high-level libraries have been spun-off
+as separate gems and/or deprecated. No doubt this is a big change for Facets, and the
+transition may be a bit bumpy over the short-term, but I am certain that in the long-run
+everyone involved will be better served. To help, I have listed the effected libraries
+and the alternate gems availble to take their place.
+
+A few other changes have also been made in the release that may also effect your code.
+In particular you should note that #class_extension has been renamed to #class_extend
+(require 'facets/class_extend'). In addition we have added a few new core methods such
+as Exception#raised? and Symbol#thrown?.
+
+Changes:
+
+* Spun-Off Projects
+
+These libraries have been deprectated from Facets entirely, but are available
+as separate gems (or soon will be).
+
+    LIBRARY               GEM
+    --------------------  ------------------------------
+    overload.rb           overload
+    binreadable.rb        binaryio
+    downloader.rb         downloader
+    xoxo.rb               xoxo
+    bicrypt.rb            bicrypt
+    typecast.rb           typecast
+    association.rb        association
+    syncarray.rb          sync
+    synchash.rb           sync
+    paramix.rb            paramix
+    crypt.rb              crypt3
+    lrucache.rb           lrucache
+    net/smtp_tls.rb       smtp_tls
+    advisable.rb          advisable
+    buildable.rb          buildable
+    memoizer.rb           memoizer
+    harray.rb             sparray
+    sparse_array.rb       sparray
+    iteration.rb          iteration
+    interval.rb           stick
+    infinity.rb           stick
+    pool.rb               pool
+    linkedlist.rb         linkedlist
+    semaphore.rb          semaphore
+    pqueue.rb             pqueue
+    censor.rb             language
+    matcher.rb            language
+    basex.rb              radix
+    minitar.rb            archive-tar-minitar -or- folio
+
+* Spun-Off But Still Available
+
+These libraries have been spun-off into stand-alone gems, but remain
+available via Facets too. Ultimately some of these will be removed
+from Facets too (in particular the ansi libraries).
+
+    LIBRARY               GEM
+    --------------------  ------------------------------
+    ansicode.rb           ansi
+    progressbar.rb        ansi
+    logger.rb             ansi
+    tracepoint.rb         tracepoint
+    dictionary.rb         dictionary
+    recorder.rb           recorder
+    ostructable.rb        ostructable -or- openhash
+    openobject.rb         openhash
+    opencollection.rb     openhash
+    opencascade.rb        openhash
+    openhash.rb           openhash
+    openmodule.rb         openmodule
+    fileable.rb           fileable
+    enumerablepass.rb     enumargs
+
+* Deprecations Without Current Replacement
+
+The libraries have been deprecated but do not yet have replacements.
+Seperate gems for these are planned though.
+
+    bbcode.rb
+    ini.rb
+    settings.rb
+    xmlhash.rb
+
+* Deprecations Merged Into CORE
+
+These libraries have been deprecated because their functionality was merged into
+the CORE library and/or made available in some another way.
+
+    1stclassmethod.rb   #method! and #instance_method! are now part of CORE.
+    elementor.rb        #per has been added to CORE.
+    elementwise.rb      #ewise has been added to CORE.
+    consoleutils.rb     #ask is in CORE, for the rest see Ansi or Clio project.
+    attr.rb             Added Module#attr_setter to CORE, and separated the rest in MORE.
+
+* General Deprecations
+
+These libraries have simply been deprecated because they were found lacking in
+some significant fashion.
+
+    nilstatus.rb        Poved rather useless, not to mention trivial.
+    heap.rb             Heap was just an alias for PQueue anyway. Use 'pqueue' instead.
+    dependency.rb       Other solutions exist that are much better (like Advisable).
+    classmethods.rb     #class_extend solution is more robust.
+    ziputils.rb         Have a look at Folio (gem install folio) for replacement.
+    unheritable.rb      Implementation is trivial and usefulness questionable.
+    instantise.rb       Replaced by instance_function.rb.
+
+* Other Enhancements
+
+  * Fixed Proc#curry to work with #define_method (Thanks to R.Potter)
+  * Module#class_extension has been renamed to #class_extend (require 'facets/class_extend').
+  * kernel#instance is no longer in core; now it is an extra monkey patch for #instance_eval.
+  * Kernel#this has been removed. It is equivalent to 'method(__method__)'.
+  * BlankSlate is now an alias for BasicObject, and will be deprecated in the future.
+  * Kernel#method! and Module#instance_method! now use a global variable for their cache.
+  * #object_state (old name was #state) has been added to core.
+
+
+## 2.6.0 / 2009-07-03
+
+Facets 2.6.0 removes htmlfilter.rb and cssfilter.rb due to licensing
+incompatability. These scripts are now available as a separate package
+called 'htmlfilter'. Also removed are a few MORE libs that were too
+expiremental and/or not robust enough. Effectively this finishes up
+the "spring cleaning" of the MORE lib mentioned a few releases back.
+
+But it also marks a new start in trimming MORE down further. We have
+decided to do this for three reasons 1) Some of the MORE libs would
+be better served as separate projects. 2) Facets will become a tighter
+library, primarily focused on extensions. And 3) all libraries involved
+will become easier to maintain and thus more robust in the long run.
+
+This release also fixes an important arity bug with the recently added
+Module#extend method --one of the very few actual core overrides in Facets.
+
+Changes:
+
+* 7 Major Enhancements
+
+  * Removed htmlfilter.rb due to licensing issues.
+  * Also removed cssfilter.rb ('gem install htmlfilter' now)
+  * Removed rwdelegator.rb, simply not a robust solution.
+  * Removed buildable.rb, api is too confusing.
+  * Removed meta.rb which was not very useful and too expiremental anyway.
+  * Removed prototype.rb, which needs it's own project.
+
+* 3 Minor Enhancements
+
+  * Removed Kernel#__HERE__ as it simply cannot work.
+    (Ruby 1.9.2 will offer #source_location for the same, btw)
+  * Returned binding/opvars to core.
+  * Added Integer#length as suggested by Victor H. Goff III.
+
+* 1 Bug Fix
+
+  * Fixed arity issue with Module#extend.
+
+
+## 2.5.2 / 2009-04-07
+
+Facets 2.5.2 is a simple maintentance release which fixed a few issues
+in the new to_hash.rb library. This release also added String#lowercase
+and String#uppercae.
+
+Changes:
+
+* 1 Major Enhancement
+
+  * added string/uppercase and lowercase
+
+* 1 Minor Enhancement
+
+  * adjustments to to_hash.rb
+
+
+## 2.5.1 / 2009-03-05
+
+Facets 2.5.1 fixes a few bugs, makes some small but nice additions
+and improves 1.9 compatibility.
+
+The most important addition to make note of is Object#extend, which has
+been overridden to allow a block parameter. This is one of only two or three
+actual "monkey patches" in all of Facets. The block, when provided,
+is used to create an annonymous module which then extends the reciever.
+This is a "good practice" way to extend objects, rather than using class_eval
+on the singleton class.
+
+Special thanks to Erik Veenstra, Pit Capitan and especially Sandor Szücs
+for their contributions to this release.
+
+Changes:
+
+* 7 Major Enhancements
+
+  * added Hash#group_by_value (thanks to Erik Veenstra)
+  * added String#file
+  * added Hash#new_with (Pit Capitan)
+  * added module/extend.rb, now can take a block.
+  * added hook.rb
+  * added to_h_auto
+  * overhauled to_hash.rb, now has multiple methods
+
+* 10 Bug Fixes
+
+  * corrected ostruct.rb to test for frozen state on updates
+  * fixed String#left_align
+  * fixed conflict between test_name.rb and test_arguments.rb
+  * fixed Enumreable#split when reciever is empty array
+  * fixed coruption of reciever by Hash#collate (thanks to Tilo Sloboda)
+  * fixed Array#to_h, h={} was not initialized
+  * fixed test of Module#conflict according ruby19
+  * fixed Hash#dearray_singluar_values
+  * association.rb stores reference when using #new
+  * changed Array#product to make it compatible to ruby 19, deleted block parameter
+
+* 5 Minor Enhancements
+
+  * split enumerable/collect into map_with_index and compact_map
+  * improved Array#to_h for 1.9 using flatten(1)
+  * Dictionary#replace can take regular Hash too
+  * move test_to_hash.rb from more to core
+  * Doc'd that UnboundMethod#name returns Symbol in 1.9, but String in 1.8
+
+
+## 2.5.0 / 2008-11-23
+
+Facets 2.5.0 is an important milestone in the development of Facets.
+
+This release has been tested against Rails' ActiveSupport library.
+As long as Facets is loaded after ActiveSupport, everything
+should work fine. Of course, there's no counting for real world
+trials, but all ActiveSupport testcases pass under this scenario.
+
+Secondly, this release is the first of two (or three) down-scaling
+releases intended to remove all the remaining "excess" from the
+library. This is being done for a variety of reasons. Some scripts
+are substantial enough to be one their own and have been spun-off
+into separate largely compatible projects. In this release:
+
+  If you were using...   Use this project instead...
+
+    annotations.rb         Anise
+
+    bytes.rb               RichUnits
+    times.rb
+
+    command.rb             Clio
+    consoleutils.rb
+
+A few others scripts have been deprecated, without an alternative
+recourse, simply because they were too weak, such as  uploadutils.rb,
+or highly experimental, such as chain.rb and eventhook.rb.
+
+Although this release constitutes an over all slimming down of Facets,
+two excellent new libraries have been added.
+
+1) *ini.rb* by Jeena Paradies. While YAML is frequently used by
+Rubyists for configuration files, a full-on serializer like YAML
+is often overkill. INI files provide a lightweight solution
+specifically geared for configuration.
+
+2) *filter.rb* by Brian Candler offers lazy evaluation chains of
+Enumerable methods. This is an elegant way to optimize contiguous
+maps, selections, etc. --effective even on infinite enumerators.
+(Note, the name of this library may be changed in the next release.)
+
+While work remains to be done, I am happy to say, Facets is
+finally beginning to approach the level of solidity I set out to
+achieve just over a year ago. Thank the Maker!
+
+Special thanks to Brian Candler, Jeena Paradies and Tyler Rick.
+
+Changes:
+
+* 9 Major Changes
+
+  * added Brian Candler's Enumerator::Filter
+  * added sparse_array.rb (was old harray.rb)
+  * added Jeena Paradies' ini.rb
+  * renamed CacheDelegator to Memoizer
+  * renamed DictionaryMatcher to just Matcher
+  * deprecated bytes.rb and times.rb (use RichUnits instead)
+  * deprecated uploadutils.rb; ziputils.rb will be (use Folio)
+  * deprecated annotations.rb (use Anise instead)
+  * deprecated command.rb and consoleutils.rb (use Clio instead)
+
+* 5 Minor Changes
+
+  * deprecated chain.rb (very expiremental)
+  * deprecated eventhook.rb (moved to ToadCode project)
+  * deprecated tagiter.rb (moved to ToadCode project)
+  * moved Hash#symolize_keys and #stringify_keys to core lib
+    (still recommend #rekey instead though)
+  * switched to git as of 2.4.5
+
+* 4 Bug Fixes
+
+  * memoize.rb, cache was at class-level, now at instance-level
+  * binding/caller.rb, fixed require for callstack.rb
+  * fixed missing require in string/tabto.rb
+  * Fixed some bugs with Time#ago/Time#hence not changing years
+    correctly when you changed months.
+    (For example, Time.utc(2008, 1, 1).ago(12, :months) incorrectly
+    returned 2009-01-01 instead of 2007-01-01.)
+    Changed Time#ago/Time#hence to still work if passed negative number.
+
+
+## 2.4.5 / 2008-10-02
+
+Facets 2.4.5 is a maintaince release. This release is notable however in that
+it will likely be the last that to use SVN. Facets will be switching to Git.
+Also, some libraries that have been flagged "to be deprecated" for some time
+will finally be so.
+
+Changes:
+
+* 8 Major Enhancements
+
+  * Re-added date.rb to lore library, and removed from core.  (#r1014)
+  * Much improved date.rb extension now in Lore library.  (#r1027)
+  * Deprecated kernel/suppress. Use Exception.suppress from now on.  (#r1040)
+  * Deprecated string/style.rb. Use English project instead.  (#r1074)
+  * Console namespace is no longer supported (for Ansicode).  (#r1077)
+  * enumerable/mode.rb, Enumerable#mode returns array since there can be more than one.  (#r1079)
+  * OpenCascade automatically creates nodes, use foo? to query.  (#r1056)
+  * Change #index_of to #index which now takes a block.
+
+* 14 Minor Enhancements
+
+  * OpenStruct.new can now take a default block, like Hash.new.
+  * Moved variablize methods out of metaid.rb and into separate files (string/ and symbol/).  (#r1042)
+  * Added Time#advance.  (#r1046)
+  * Speed up of Integer odd/even methods.  (#r1057)
+  * Array#index now takes a block (this is a core override).  (#r1059)
+  * Spilt file/write.rb into separate method files (append, create, writelines).  (#r1073)
+  * Modified Enumerable#split to behave like String#split.  (#r1076)
+  * hash/op.rb, split into separate method files.  (#r1081)
+  * Added string/modulize. string/methodize handles path names now too.  (#r1085)
+  * Class#cattr is now part of core.  (#r1089)
+  * Modified Enumerable#split to behave like String#split.  [minor]
+  * Removed Rope class. If anything this will have a separate project.
+  * Added doc/news.html and doc/authors.html to website (temporarily?).
+  * Added zlib.rb to Lore library.
+
+* 7 Bug Fixes
+
+  * OpenStruct#to_h dups internal table.  (#r1015)
+  * Fixed require of string/xor in bicrypt.rb.  (#r1039)
+  * integer/odd.rb, fixed Ruby 1.9 condition.  (#r1080)
+  * class/cattr_*.rb fix require bug
+  * opencascade.rb, fixed bug when accessing sub-hash.
+  * typecast.rb, fixed require for string/methodize.
+  * Fixed Pathname#glob to ensure use of ::File.
+
+
+## 2.4.4 / 2008-09-01
+
+Facets 2.4.4 includes a major bug fix that caused Facets not to load properly,
+having to do with a Time extension. The problem has been fixed. In addition,
+this release put Facets only a few pending adjustments away from full
+Rails/ActiveSupport compatibility.
+
+Changes:
+
+* 10 Major Enhancements
+
+  * Added string/mask providing powerful string manipulation.  (#997)
+  * BasicObject is now just a synonm for BlankSlate unless Ruby 1.9.  (#1000)
+  * Added Symbol#plain?, Symbol#query? and Symbol#setter?  (#1011)
+  * Removed Time#to_date.
+    * Due to clobberd RI Docs (!) this should have been in Lore lib date.rb
+    * Moved to Lore date.rb. (#1012)
+  * Re-added date.rb to lore library, and removed from core.  (#1014)
+  * Much improved date.rb extension now in Lore library.  (#1027)
+  * Deprecated kernel/suppress. Use Exception.suppress from now on.  (#1040)
+  * Improved date.rb and moved to LORE library, and removed from CORE.  [major]
+  * Deprecated kernel/suppress. Use Exception.suppress from now on.  [major]
+  * Deprecated String#to_time.
+    * This method reqiures the loading of a number of other standard libs.
+    * We can reconsider adding it again if we decide these other libs should be core.
+    * Or if we find a more suitable way to define the method.
+
+* 17 Minor Enhancements
+
+  * Moved style.rb to string/stylize.rb  (#998)
+  * Renamed string/subtract to string/op_sub.
+    Old name will remain for time being for compatability. (#1002)
+  * Module#instance_method_define? now only applies to public methods.  (#1003)
+  * Array#index accepts a block (one of the few core overrides).  (#1004)
+  * Moved Hash#<< from hash/update.rb to hash/op_push.rb  (#1005)
+  * Add facets class files (eg. facets/string) have been made dynamic.  (#1013)
+  * Moved variablize methods out of metaid.rb and into separate files (string/ and symbol/).  (#1042)
+  * Added Time#advance.  (#1046)
+  * Added qua_class.rb. Yea. It really is my favorite.
+  * Added simple functional test that loads all of Facets.
+  * Added a benchmark for measuring how fast Facets loads. (Core < 1sec!)
+  * Made Module#alias_method_chain a public method (for better Rails support).
+  * Wrapped Nilclass#to_f in 1.9 condition.
+  * float/round.rb redirects to numeric/round.rb.
+  * numeric/float.rb holds rounding methods for all classed Numeric, Integer and Float.
+  * Replaced Kernel#instance_exec with Mauricio's version.
+  * Improved String#each_char to work like Ruby 1.9.
+    * This loads strscan.rb.
+    * It is wrapped in a 1.9 condition.
+
+* 8 Bug Fixes
+
+  * Hash#<< now returns self  (#1001)
+  * OpenStruct#to_h dups internal table.  (#1015)
+  * Fixed require of string/xor in bicrypt.rb.  (#1039)
+  * Fixed facets.rb to use relative paths.
+  * Fixed cgi.rb (CGI is a class not a module).
+  * OpenStruct#to_h dups internal table.  [bug]
+  * Fixed require of string/xor in bicrypt.rb.  [bug]
+  * date.rb (stamp) fixed ref to constant FORMAT.
+
+
+## 2.4.3 / 2008-08-14
+
+Facets is almost fully interoperable with ActiveSupport and Ruby 1.9.
+We will continue to improve this interoperability in upcoming releases.
+
+As a REMINDER, Facets 2.4+ now encourages:
+
+  require 'facets'
+
+This is better than cherry-picking methods. It may seem counter-intuitive,
+but it actually proves more advantages to do this for the sake of
+improved interoperability. The practice of cherry-picking can become
+problematic if other dependent libraries have cherry-picked different
+methods. In those cases these distinctions go unaccounted and untested.
+
+Note that this release does not include a setup.rb script. We are working
+on a new version of this script, which we plan to include in the next release.
+
+This release give special thanks to the following people for their contributions:
+Ken Bloom, Nick Caruso, Evgeniy Dolzhenko, Andy Freeman, Tomasz Muras and Dave Myron.
+And of course, to anyone else I failed to mention that has contributed.
+
+(NOTE: 2.4.3's changes may actually be long to 2.4.2. Notice the releases are
+only two days apart. There was an issue with 2.4.2 and it had to be replaced
+immediately. So take the distinct with a grain of salt.)
+
+Changes:
+
+* Additions
+
+  * Add Time#trunc and Time#round to Core.
+  * Add Array#recursively and fixed bug in Hash#recursively.
+  * Add Kernel#instance method which provides a fluent interface to private object space.
+  * Add Symbol#plain?, Symbol#query? and Symbol#setter?
+  * Add Hash#symbolize_keys and #stringify_keys.
+  * Add File#split_root.
+  * Add #glob and #glob_first as extensions to Pathname.
+  * Add NilClass#ergo whic points back to kernel/ergo.
+  * Add #bump method to VersionNumber class.
+  * Add String#mask providing powerful string manipulation.
+  * Add Ken Bloom's DictionaryMatcher class (will be renamed in future version)
+
+* Deprecations
+
+  * Deprecate Hash#keys_to_s and Hash#keys_to_sym.
+    * These are the original versions of these methods.
+    * But now we can use #rekey(:to_s) and #rekey(:to_sym) instead.
+  * Deprecat ruby.rb, which was a sort 1.9 compatibility layer.
+
+* 22 Major Enhancements
+
+  * Changed File#rewrite to not use the in-place change of the string.
+  * Renamed Class#to_pathname and #to_methodname to #pathize and #methodize.
+  * Removed Console:: namespace for ANSICode.
+  * Moved Mentalguy's lazy.rb to core!
+  * Added Indexable and Stackable to core.
+  * BasicObject is now just a synonm for BlankSlate unless Ruby 1.9.  [major]
+  * Moved Indexable and Stackable to core.
+  * Renamed arguments.rb and CLI::Arguments to argvector.rb and Argvector.
+  * Added optional argument to Dictionary#first and #last.
+  * Moved binding/opvars from core to more.
+
+* 19 Minor Enhancements
+
+  * Improved File#rootname --it is now more robust.
+  * Made FileUtils#whereis a module_function again.
+  * Created Lore library to house extensions to Ruby's standard library.
+  * Re-added facets class files (eg. facets/string) and are now dynamic.
+  * Added block to Array#index.
+    * This is one of the few core overrides in Facets.
+    * It is a feature already in Ruby 1.9.
+  * Added Jim Weirich's BlankSlate class.
+    * This is a temporary measure be compatible w/ AcitveSupport's BasicObject.
+  * Split kernel/load.rb into require_all.rb and require_local.rb.
+  * Split module/alias.rb up into alias_accessor, alias_module_function and alias_method_chain.
+  * Renamed string/subtract to string/op_sub.
+    Old name will remain for time being for compatability. [minor]
+  * Moved style.rb to string/stylize.rb  [minor]
+  * Added warning to bytes to use RichUnits instead.
+  * Updated warn line fore eventual deprecation of fileshell and arguments.*
+  * Added facets-load.rb to allow old school cherry picking.*
+    * Between 2.0 and 2.4 require 'facets' simply added core to LOAD_PATH.
+    * Starting with 2.4 it loads all of core automatically instead.
+    * facets-load.rb provides a way to use the old behavior.
+          require 'facets-load.rb
+          require 'kernel/with'
+          require 'symbol/to_proc'
+    * This adds the path to the end of LOAD_PATH to prevent any load conflicts.
+
+* 5 Bug Fixes
+
+  * Fixed Time#hence changed years when changing months.
+  * Fixed Time#hence to flip year correctly when adding months.
+  * Hash#<< returns self
+  * Fixed String#pathize.
+  * Module#instance_method_defined? now only applies to public methods.
+
+* Administrative Enhancements
+
+  * While not perceptible to an end user, there are now 3 divisions: lib/core, lib/lore, lib/more.
+  * Modified script/test to display $LOAD_PATH before running tests.
+
+## 2.4.2 / 2008-08-12
+
+Just some more of those great old work your ass off changes.
+
+Changes:
+
+* Major Enhancements
+
+  * Added Ken Bloom's DictionaryMatcher class from Ruby Quiz #103.
+    (Note this class will probably be renamed in the future.)
+  * Changed File#rewrite to not use the inplace change of the string.
+    * If you were using the function, change your code to use File#rewrite! instead.
+    * Or, modify your code ot use the new behavior.
+    * This change can make for a slippery bug, so be sure to check for it!
+  * Moved live.rb to facets-live.rb.
+  * Added kernel/instance method which provides a fluent interface to private object space.
+
+* 5 Minor Enhancements
+
+  * Added sow generation forms.
+  * Spilt Time#trunc into separate file.
+  * Remove old log files --shouldn't version control these.
+  * Added note to FileList to add glob options parameter.
+  * Added optional argument to Dictionary#first and #last.
+
+* Other Enhancements
+
+  * Move "lore" tests to test/lore (lore are extensions to Ruby's standard lib).
+  * Added test/core, test/lore and test/more.
+  * Added time/test_round.rb
+  * Added array/recursively.
+  * Added time/round.
+  * Time#to_date makes the public (it already existed in Ruby!)
+  * Fixed Time#hence to flip year correctly when adding months.
+  * Work on documentation using new Sow system.
+  * Moved meta.rb to more/kernel/meta.rb and merged facets/core.rb into facets.rb.
+  * Added more/kernel directory --hey not every extension can be core.
+  * Adjusted loadpath and moved lazy.rb to core!
+  * Moved remaing files to subdirectory locations.
+  * Moved most core libs to core/.
+  * Move most more files to the more directory.
+  * Added lore and more directories.
+  * Added facets/core directory. Yes, I'm spiliting the lib again.
+    * Loadpath will be used, so user inteface will stay the same.
+    * Setup.rb will be adjusted to recognaize loadpath.
+  * Removed Rope class. If anything this will have a separate project.
+  * Moved setup.rb to script/setup.
+    * This will either be replaced with configure/install scripts.
+    * Or, depend on a separate ruby setup.rb project.
+  * Added recorder.rb to consider in work directory.
+  * Added admin directory.
+  * Added "TO BE DEPRECATED" message to ruby.rb.
+  * Added all methods from ruby.rb as individual core methods.
+    * These are the methods that overlap with 1.9.
+    * They are encased in 'unless RUBY_VERSION' caluses.
+  * Imporved file/rootname --now much more robust.
+  * Added Kernel#to_yamlfrag to yaml.rb as way to output yaml w/o the "---" header.
+    * Perhaps not the most robust solution, but okay for now.
+    * Maybe a poor name for the method, but you got a better one?
+  * Made FileUtils#whereis a module_function again like it used to be. Because:
+    (1) that seems to be the way most other FileUtils methods are (cd, mkdir, cp, ...) and the most
+        obvious way that users would WANT to use FileUtils: FileUtils.whereis("ruby").
+    (2) I see module_function used in other comparible parts of Facets: UploadUtils, ConsoleUtils,
+        ZipUtils, FileUtils#safe_ln, ...
+    (3) My code that relied on the old module_function behavior was breaking
+        What were you thinking changing it?? ;)
+
+
+## 2.4.1 / 2008-04-03
+
+This release takes aim at improving compatability with ActiveSupport.
+It also reintroduces an improved paramix.rb.
+
+Changes:
+
+* 4 Major Enhancements
+
+  * A much improved paramix.rb has been returned to the library.
+    * There a no longer capitialize module methods at all.
+    * Use Module#[] and mixin_params[] instead.
+  * Deprecated behavior.rb. It was not robust.
+  * Added basex.rb, for working in any encoding base using any character set (base62 is the default).
+
+* 3 Minor Enhancements
+
+  * Comparing to ActiveSupport, found 63 extension clashes, but most are due to 1.9 features.
+    The rest should be compatible.
+  * Reatomized a number of Kernel and String methods. Reatomization is nearly complete.
+  * Continued work on reatomizing core extensions (nearly complete now).
+
+
+## 2.4.0 / 2008-03-24
+
+Facets 2.4 is a major step forward for Facets. It is perhaps the release
+that 2.0 should have been, but of course it took the actual 2.0 release
+to make 2.4 possible. Some annoyances you may have encountered in updating
+your code to 2.0 are now fixed. And from 2.4 on, Facets will now be
+settling down into simple refinement release cycles for a while.
+
+The main change under the hood is to bring everything up to the top
+lib/facets/ directory. No longer are the libraries sorted by category.
+I had done so for a long time to make it easier to track the various libs,
+but in the end it was only making it more diffcult to deal with build tools
+and packaging.
+
+For the end-user, the largest change is a new emphisis on:
+
+  require 'facets'
+
+This is better than cherry-picking methods. It may seem counter-
+intuitive, but it actually proves more advantantages to do this
+for the sake of interoperability than the practice of cherry-picking.
+The reason is simply because others may have cherry-picked different
+methods, and those distinctions go unaccounted and untested.
+
+Also with this release, to bolster the use of require 'facets',
+some lack-luster extensions have been deprecated and namespace usage
+has been improved. In addition, we are getting very close to full
+ActiveSupport, and Ruby 1.9, interoperability. Expect this
+to be complete in the next minor release or two.
+
+Changes:
+
+* Enhancements
+
+  * String#to_re and String#to_rx have swapped default behaviors. #to_rx escapes, #to_re does not.
+  * The Console namespace is being deprecated. command.rb and arguments.rb now use CLI naemspace.
+  * #compare_on and #equate_on are now "mixin methods" Comparable() and Equateable().
+  * Enumerable#product, #combintations and #permutations have change to be Ruby 1.9 compatible.
+  * thread.rb, map_send, et al, block is passed to send instead of yielding on result.
+  * namespace.rb has been renamed to methodspace.rb.
+  * Ruby 1.9 defined a new Proc#curry method, so Facets version has been made compatible.
+  * The old curry method is now called #partial, as in "partial application".
+  * Deprecated interface.rb. Perhaps a better approach but nonetheless extraneous.
+  * Deprecated paramix.rb. A better way is to use a capitialized methods. (Perhaps a lib for that?)
+  * Brought back a few web related libs, htmlfilter.rb and cssfilter.rb in particular.
+  * camelcase and snakecase are core extensions. For specialized styles use String#style in style.rb.
+  * Renamed ArgVector to CLI::Arguments
+  * Moved one_nine.rb to ruby.rb
+  * Moved test/test_one_nine.rb to test/test_ruby.rb.
+  * Updated requires for "one_nine" to just "ruby" b/c of backports to 1.8.7.
+  * Added warning to Rick Kilmers's unit system.
+    * Moving Rich Kilmers's units system to it's own package.
+    * Three are alternate unit systems available and Facets should work with any of them.
+    * Will keep a fair amount of the Time extensions though.
+  * Moved nil/status.rb to nilstatus.rb
+  * Got rid of Method#curry and Method#partial since they just convert to Procs.
+  * Made op_esc.rb a separate module rather thanan extension.
+  * Deprecated with_reader, with_writer and with_accessor for attr_singleton_reader, &c.
+  * Deprecated Hash#pairs_at. Use Hash#slice instead from core.
+  * Fixed the namespaces of some extensions.
+  * Added prime directory and files.
+  * Removed all "prime" extension files.
+  * Move mattr to module.
+  * Fixed require bug in time methods.
+  * Reverted memomize.rb back to original code --will come back to later.
+  * Added stylizer.rb to replace stylize.rb
+  * Array #recursively is not only called #traverse.
+  * Added case/stylize methods to more/facets/string.
+  * Renamed more/string/facets/titlecase to captialize_all.
+  * Added uri and xoxo tests.
+  * Progressive work on memoize and elementor.
+  * Functor no longer privatizes =, == and =~.
+  * Properly split conversion.rb.
+  * Some string methods extracted from stylize.rb.
+  * Moved random.rb to more/.
+  * Renamed namespace.eb to methodspace.rb.
+  * Moved autoreload to more/facets/kernel.
+  * Removed old curry.rb.
+  * Added cgi.rb with some standard extensions.
+  * Deprecated paramix.rb.
+  * Added xmlhash.rb and returned uri.rb extensions to the library.
+  * Added #method_name to Date class.
+  * Remove cut-bases AOP, now in it's own library.
+  * Converted compare_on.rb to Paramtric Mixins.
+  * Split fileutils up into individual methods.
+  * Renamed console.rb to what it should be consoleutils.rb.
+  * Update to command.rb integrating MasterCommand and Command into a single class.
+  * Added options back into multiglob_r.
+  * Improved cloneable.rb to be a true deep dup/clone mixin using Ken Bloom's suggestion.
+  * Added tasksystem.rb.
+  * Added enumerable/combinations.
+  * Added openhash and tracepoint.
+
+* Bug Fixes
+
+  * Fixed bug with #peek in stackable.
+  * Fixed bug in Kernel#object_hexid.
+  * Fixed bug in multiglob_r so it will NOT follow symlinks.
+  * Fixed test_keyize.rb.
+
+* Adminstrative Changes
+
+  * This was a fairly large and fast-paced update, so unfortunately not all changes are listed this time.
+  * Added ri generation to setup.rb.
+  * Updated README and allowed doc/ to be included in package.
+  * Finally completed removal of all embedded tests.
+  * Organized all libs between core, more, class and mixin.
+
+
+## 2.3.0 / 2008-02-01
+
+Amoung other changes with this release, cloneable.rb is now a true deep
+dup/clone mixin; tracepoint.rb returns to the library.
+
+Changes:
+
+* 4 Major Enhancements
+
+  * Cloneable provides true deep cloning.
+  * Moved hash_keyize.rb to CORE as hash/keyize.rb.
+  * Added tracepoint.rb back to the library.
+  * Added hash/collate.
+
+* 3 Bug Fixes
+
+  * Fixed multiglob_r bug, so it will NOT follow symlinks.
+  * Added a couple of missing binding requires.
+  * Fixed test_keyize.rb.
+
+* 6 Admistrative Changes
+
+  * Reorganized library into smaller groups: core, more, class and mixin.
+  * Remove admin/svn subdir.
+  * Remove admin/log.
+  * Add admin tasks.
+  * Moved admin tasks to admin directory.
+  * Added admin directory.
+
+
+
+## 2.2.1 / 2007-12-22
+
+This release get rid of the underlying methods subdir.
+All method redirects are now in core, to ensure there
+are no more name clashes.
+
+Changes:
+
+* Method Renames
+
+  * Moved string/format.rb to string/wrap.rb.
+  * Updated String#brief.
+  * Moved binding/cflow.rb to caller.rb.
+  * Moved core hash/keyize to more.
+
+* Other Enhancements
+
+  * Fixed up binding extensions.
+
+* Administrative Adjustments
+
+  * Got rid of methods subdir. All method redirects are in core/.
+  * Moved doc/wiki to apiwiki b/c of Rubyforge's wiki.
+  * Removed doc/api dir.
+  * Added wiki.
+  * Renamed a couple test tasks.
+  * Update per-module/class files.
+  * Moved methods and groups task to trash.
+  * Added test class/remove_descendents.rb.
+  * Added all remaining per-method require libs from methods/ (will need to wrok through these over time).
+  * Added trash work directory.
+  * Adjust text according to per-method file changes.
+  * All hash method, but the conversion methods, are now represented in core/facets/hash.
+  * Added a few more Hash per-method files.
+  * Add per-method libs for hash.
+  * Updated facets/string.rb.
+  * Renamed ROLLRC to facets.roll.
+
+
+## 2.2.0 / 2007-12-13
+
+This release provides improved rdocs and prepares facets for use with Ruby 1.9.
+It also adds Matthew Harris' duration.rb library. Bug thanks to Matthew!
+
+Changes:
+
+* Additions
+
+  * Added Matthew Harris' Duration class.
+  * Added Hash#slice and Hash#except (didn't we have this before?)
+  * Added registerable.rb, updated history.
+  * Added #include_as to facets/namespace.rb.
+  * Added op.rb to string.rb.
+  * Added String/op.rb with String#- method.
+
+* Method Renames and Reorganizations
+
+  * The name Array#unzip didn't makes sense, it was renamed to #modulate (though #collate seems better?)
+  * Renamed Enumerable#collate to #mash (Map hASH); #collate and #graph remain aliases for the time being.
+  * Renamed accessor #attributes to #instance_attributes.
+  * Renamed Enumerable #collate to #mash. (old name, along with graph, will be an alias for time being)
+  * Divided enumerable/collect into split.rb and each.rb as well.
+  * Moved mapsend.rb to thread.rb.
+  * Updated mapsend.rb to focus on threads.
+  * Moved continuation extensions to more lib.
+
+* Deprecations
+
+  * Deprecated Module#include_and_extend. Just use both silly.
+  * More lib pp_s.rb has been removed. Use #pretty_inspect instead.
+  * Removed continuation from core.
+  * Removed pp_s.rb (use pretty_inspect) add continuation.rb.
+  * Remove kernel/require_esc.rb.
+
+* Other Enhancements
+
+  * integer/bitmask.rb has changed a bit --pun intended ;) Deprecated some methods and now use "~" instead of "-" to clear bits.
+  * Split binding extensions up a bit more finely --eval.rb sprouted here.rb, self.rb and defined.rb.
+  * Move Time#stamp out of conversion.rb and into time/ dir, and remove to_s alias.
+  * Preliminary addition of Matthew Harris' excellent duration.rb lib (will integrate with times.rb better in future).
+  * Minor edit to basicobject.rb in light of 1.9.
+  * Minor adjustments to lazy.rb to fix warnings by Ruby 1.9.
+  * Added if clauses to handle upcoming Ruby 1.9 gracefully. Facets should now be just about ready for use with 1.9.
+
+* Documentation Enhancements
+
+  * A lot of rdoc updates to core extensions --as promised ;)
+  * Just about every method now has at least a brief explinaiton and an example.
+
+* Administrative Adjustments
+
+  * Moved task/config.yaml to meta/ per new Ratch.
+  * Moved task/special to task/doc.
+  * Updated todo list (in dev/).
+  * Copied log/history.rd to CHANGES.
+  * Removed log/history.rd and log/todo.rd
+  * Fixed stylize.rb for use with 1.9 (fixed case statement).
+  * Separated kernel/returning, now that #tap will be in 1.9.
+  * Updated facets.rb for use with 1.9.
+  * Separated time/stamp.rb.
+  * Divided binding up into a few more pieces.
+  * Fixed kernel/instance to play nice with 1.9.
+  * Added test for string/op.rb.
+  * Added test_collect.rb split-offs and test_mash inplace of test_collate.
+  * Cleanup test headers.
+  * Added 1.9 check in continuation/create.rb.
+  * Add a couple new task for rdoc gen.
+  * Added nbsp to quickopts task.
+  * Work on website using siteparts.
+
+
+## 2.1.3 / 2007-11-28
+
+This release fixes four bugs --one being fairly serious, as it prevented
+require 'facets' from working at all.
+
+Changes:
+
+* 4 Bug Fixes
+
+  * Fixed oddity in Enumerable/collate.
+  * Fixed issue that prevented loading of facets.rb.
+  * Array#to_h used flatten, but it needed to be flatten(1).
+  * Move core/main.rb back to core/facets.rb as it conflicts with lib in more/.
+
+
+## 2.1.2 / 2007-11-22
+
+Changes:
+
+* Additions
+
+  * Added Exception#details.
+
+* General Enhancements
+
+  * Dir::multiglob no longer handels -/+ modifiers. Use FileList instead.
+
+* Administrative Adjustments
+
+  * Fixed task/install script.
+  * Improved task/changes.
+
+
+## 2.1.1 / 2007-11-16
+
+Changes:
+
+* Additions
+
+  * Added kernel/ergo.rb.
+  * Added pp_s.rb (Questionable addition, but we'll leave it for now.)
+  * Added validation.rb. This is here for Nitro's sake --better techinques may replace it in the future.
+  * Added Console::Logger to logger.rb (may be separated in future).
+  * Added option arity to command.rb.
+
+* Deprecations
+
+  * Removed tracepoint.rb.
+
+* Bug Fixes
+
+  * Fixed bug in command.rb that clobbered options.
+  * Fixed options bug in command.rb.
+
+
+## 2.1.0 / 2007-11-10
+
+Major changes include a new and much-improved command.rb, a new BiCrypt
+class for simple two-way crypotgraphy, as well as attr_reader!, 
+attr_writer! and attr_accessor! for flag attributes, plus 
+alias_xxx methods for all attr_xxx methods.
+
+Changes:
+
+* Additions
+1473