Contents

  # Some caution should be taken when using certain facets.
  # What follows ois list of such facets and the reasons
  # these particular facets should given special consideration.

  # Some facets require other files to be loaded first
  # that are not loaded automatically, like fileutils
  # (i.e. they are part of the standard lib, not core).
  # The file include all of the following.

  date/*
  fileutils/*
  ostruct/*
  logger/*
  gem/*

  # Others effect the system in slightly non-standard ways.
  # Though such changes are kept to a minumim and intended
  # to be backward compatible, there still may be edge cases
  # that could cause another library to misbehave. 
  # The following is a list known facets that may have 
  # this potential.

  array/op_fetch.rb
  array/op_store.rb
  binding/self/of_caller.rb
  hash/op_fetch.rb
  hash/op_store.rb
  numeric/succ.rb
  numeric/pred.rb
  string/succ.rb
  string/unpack.rb
  module/attr.rb
  #module/attr_reader.rb
  #module/attr_writer.rb
  #module/attr_accessor.rb

  # There are also some facets that are potentially unsafe b/c
  # they change Ruby's default behavior in a nonconvential
  # manner and hence are not designed to be backward compatible.
  # Using these with a pre-existent program may cause the program
  # to misbehave. So while they can be useful, be sure to 
  # understand exactly what they do before putting them to 
  # serious use.

  hash/each.rb
  module/methods.rb
  object/method.rb
  nilclass/op_fetch.rb
  nilclass/empty.rb
  nilclass/include.rb
  nilclass/size.rb
  nilclass/length.rb
  nilclass/method_missing.rb

Version data entries

3 entries across 3 versions & 1 rubygems

Version	Path
facets-1.4.4	WARNING
facets-1.4.5	doc/CAUTION
facets-1.7.0	doc/CAUTION