RubyGems - eymiha_util - Versions diffs - 0.1.6 → 1.0.0 - Mend

eymiha_util 0.1.6 → 1.0.0

Files changed (106) hide show

data/gem_package.rb +3 -3
data/html/classes/Eymiha.html +144 -0
data/html/classes/{BaseEnvelope.html → Eymiha/BaseEnvelope.html} +21 -21
data/html/classes/Eymiha/BaseEnvelope.src/M000010.html +18 -0
data/html/classes/Eymiha/BaseEnvelope.src/M000011.html +20 -0
data/html/classes/Eymiha/BaseEnvelope.src/M000012.html +18 -0
data/html/classes/{Enum.html → Eymiha/Enum.html} +5 -27
data/html/classes/{Envelope.html → Eymiha/Envelope.html} +52 -52
data/html/classes/Eymiha/Envelope.src/M000025.html +19 -0
data/html/classes/Eymiha/Envelope.src/M000026.html +19 -0
data/html/classes/Eymiha/Envelope.src/M000027.html +35 -0
data/html/classes/Eymiha/Envelope.src/M000028.html +19 -0
data/html/classes/Eymiha/Envelope.src/M000029.html +19 -0
data/html/classes/Eymiha/Envelope.src/M000030.html +26 -0
data/html/classes/Eymiha/Envelope.src/M000032.html +18 -0
data/html/classes/{EnvelopeException.html → Eymiha/EnvelopeException.html} +5 -5
data/html/classes/{ForwardReference.html → Eymiha/ForwardReference.html} +16 -16
data/html/classes/Eymiha/ForwardReference.src/M000033.html +21 -0
data/html/classes/Eymiha/ForwardReference.src/M000034.html +18 -0
data/html/classes/{ForwardReferencer.html → Eymiha/ForwardReferencer.html} +12 -5
data/html/classes/{ForwardReferencing.html → Eymiha/ForwardReferencing.html} +51 -51
data/html/classes/Eymiha/ForwardReferencing.src/M000001.html +20 -0
data/html/classes/Eymiha/ForwardReferencing.src/M000002.html +20 -0
data/html/classes/Eymiha/ForwardReferencing.src/M000003.html +20 -0
data/html/classes/Eymiha/ForwardReferencing.src/M000004.html +32 -0
data/html/classes/Eymiha/ForwardReferencing.src/M000005.html +18 -0
data/html/classes/Eymiha/ForwardReferencing.src/M000006.html +25 -0
data/html/classes/Eymiha/ForwardReferencing.src/M000007.html +18 -0
data/html/classes/Eymiha/ForwardReferencing.src/M000008.html +18 -0
data/html/classes/Eymiha/ForwardReferencing.src/M000009.html +18 -0
data/html/classes/{Histogram.html → Eymiha/Histogram.html} +65 -65
data/html/classes/Eymiha/Histogram.src/M000016.html +19 -0
data/html/classes/Eymiha/Histogram.src/M000017.html +21 -0
data/html/classes/Eymiha/Histogram.src/M000018.html +37 -0
data/html/classes/Eymiha/Histogram.src/M000019.html +18 -0
data/html/classes/{Histogram.src/M000015.html → Eymiha/Histogram.src/M000020.html} +5 -9
data/html/classes/Eymiha/Histogram.src/M000021.html +20 -0
data/html/classes/Eymiha/Histogram.src/M000022.html +20 -0
data/html/classes/Eymiha/Histogram.src/M000023.html +20 -0
data/html/classes/Eymiha/Histogram.src/M000024.html +24 -0
data/html/classes/{HistogramException.html → Eymiha/HistogramException.html} +5 -5
data/html/classes/{MethodicHash.html → Eymiha/MethodicHash.html} +22 -22
data/html/classes/Eymiha/MethodicHash.src/M000013.html +22 -0
data/html/classes/Eymiha/MethodicHash.src/M000014.html +23 -0
data/html/classes/Eymiha/MethodicHash.src/M000015.html +23 -0
data/html/created.rid +1 -1
data/html/files/lib/{enum_rb.html → eymiha/util/enum_rb.html} +3 -3
data/html/files/lib/{envelope_rb.html → eymiha/util/envelope_rb.html} +3 -3
data/html/files/lib/{forward_referencing_rb.html → eymiha/util/forward_referencing_rb.html} +6 -8
data/html/files/lib/{histogram_rb.html → eymiha/util/histogram_rb.html} +3 -3
data/html/files/lib/eymiha/util/methodic_hash_rb.html +101 -0
data/html/files/lib/eymiha/util_rb.html +112 -0
data/html/fr_class_index.html +11 -10
data/html/fr_file_index.html +6 -5
data/html/fr_method_index.html +34 -34
data/html/index.html +1 -1
data/lib/eymiha/util.rb +5 -0
data/lib/eymiha/util/enum.rb +59 -0
data/lib/eymiha/util/envelope.rb +130 -0
data/lib/eymiha/util/forward_referencing.rb +161 -0
data/lib/eymiha/util/histogram.rb +112 -0
data/lib/eymiha/util/methodic_hash.rb +70 -0
data/test/tc_enum.rb +1 -1
data/test/tc_envelope.rb +4 -2
data/test/tc_forward_referencing.rb +3 -1
data/test/tc_histogram.rb +3 -1
data/test/tc_methodic_hash.rb +4 -1
metadata +70 -62
data/html/classes/BaseEnvelope.src/M000001.html +0 -18
data/html/classes/BaseEnvelope.src/M000002.html +0 -20
data/html/classes/BaseEnvelope.src/M000003.html +0 -18
data/html/classes/Envelope.src/M000016.html +0 -19
data/html/classes/Envelope.src/M000017.html +0 -19
data/html/classes/Envelope.src/M000018.html +0 -35
data/html/classes/Envelope.src/M000019.html +0 -19
data/html/classes/Envelope.src/M000020.html +0 -19
data/html/classes/Envelope.src/M000021.html +0 -26
data/html/classes/Envelope.src/M000023.html +0 -18
data/html/classes/ForwardReference.src/M000024.html +0 -21
data/html/classes/ForwardReference.src/M000025.html +0 -18
data/html/classes/ForwardReferencing.src/M000026.html +0 -20
data/html/classes/ForwardReferencing.src/M000027.html +0 -20
data/html/classes/ForwardReferencing.src/M000028.html +0 -20
data/html/classes/ForwardReferencing.src/M000029.html +0 -32
data/html/classes/ForwardReferencing.src/M000030.html +0 -18
data/html/classes/ForwardReferencing.src/M000031.html +0 -25
data/html/classes/ForwardReferencing.src/M000032.html +0 -18
data/html/classes/ForwardReferencing.src/M000033.html +0 -18
data/html/classes/ForwardReferencing.src/M000034.html +0 -18
data/html/classes/Histogram.src/M000007.html +0 -19
data/html/classes/Histogram.src/M000008.html +0 -21
data/html/classes/Histogram.src/M000009.html +0 -37
data/html/classes/Histogram.src/M000010.html +0 -18
data/html/classes/Histogram.src/M000011.html +0 -20
data/html/classes/Histogram.src/M000012.html +0 -20
data/html/classes/Histogram.src/M000013.html +0 -20
data/html/classes/Histogram.src/M000014.html +0 -20
data/html/classes/MethodicHash.src/M000004.html +0 -22
data/html/classes/MethodicHash.src/M000005.html +0 -23
data/html/classes/MethodicHash.src/M000006.html +0 -23
data/html/files/lib/methodic_hash_rb.html +0 -140
data/lib/enum.rb +0 -57
data/lib/envelope.rb +0 -126
data/lib/forward_referencing.rb +0 -157
data/lib/histogram.rb +0 -109
data/lib/methodic_hash.rb +0 -66

data/html/classes/MethodicHash.src/M000005.html DELETED Viewed

@@ -1,23 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html>
-<head>
-  <title>delete (MethodicHash)</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
-</head>
-<body class="standalone-code">
-  <pre><span class="ruby-comment cmt"># File lib/methodic_hash.rb, line 46</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">delete</span>(<span class="ruby-identifier">key</span>,<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
-    <span class="ruby-identifier">values</span> = [<span class="ruby-identifier">key</span>.<span class="ruby-identifier">to_s</span>, <span class="ruby-identifier">key</span>.<span class="ruby-identifier">to_sym</span>].<span class="ruby-identifier">collect</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">k</span><span class="ruby-operator">|</span> <span class="ruby-keyword kw">super</span>(<span class="ruby-identifier">k</span>){ <span class="ruby-keyword kw">nil</span> } }.<span class="ruby-identifier">compact</span>
-    <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">values</span>.<span class="ruby-identifier">size</span>
-      <span class="ruby-keyword kw">when</span> <span class="ruby-value">0</span> <span class="ruby-keyword kw">then</span> <span class="ruby-keyword kw">super</span>(<span class="ruby-identifier">key</span>,<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
-      <span class="ruby-keyword kw">when</span> <span class="ruby-value">1</span> <span class="ruby-keyword kw">then</span> <span class="ruby-identifier">values</span>[<span class="ruby-value">0</span>]
-      <span class="ruby-keyword kw">when</span> <span class="ruby-value">2</span> <span class="ruby-keyword kw">then</span> <span class="ruby-identifier">values</span>
-    <span class="ruby-keyword kw">end</span>
-  <span class="ruby-keyword kw">end</span></pre>
-</body>
-</html>

data/html/classes/MethodicHash.src/M000006.html DELETED Viewed

@@ -1,23 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html>
-<head>
-  <title>method_missing (MethodicHash)</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
-</head>
-<body class="standalone-code">
-  <pre><span class="ruby-comment cmt"># File lib/methodic_hash.rb, line 57</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">method_missing</span>(<span class="ruby-identifier">method</span>,<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
-    <span class="ruby-identifier">string</span> = <span class="ruby-identifier">method</span>.<span class="ruby-identifier">to_s</span>
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">string</span>[<span class="ruby-identifier">string</span>.<span class="ruby-identifier">length</span><span class="ruby-operator">-</span><span class="ruby-value">1</span>,<span class="ruby-value">1</span>] <span class="ruby-operator">==</span> <span class="ruby-value str">'='</span>
-      <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">string</span>[<span class="ruby-value">0</span>,<span class="ruby-identifier">string</span>.<span class="ruby-identifier">length</span><span class="ruby-operator">-</span><span class="ruby-value">1</span>].<span class="ruby-identifier">to_sym</span>] = <span class="ruby-identifier">args</span>[<span class="ruby-value">0</span>]
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">method</span>]
-    <span class="ruby-keyword kw">end</span>
-  <span class="ruby-keyword kw">end</span></pre>
-</body>
-</html>

data/html/files/lib/methodic_hash_rb.html DELETED Viewed

@@ -1,140 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<head>
-  <title>File: methodic_hash.rb</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-  <meta http-equiv="Content-Script-Type" content="text/javascript" />
-  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
-  <script type="text/javascript">
-  // <![CDATA[
-  function popupCode( url ) {
-    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
-  }
-  function toggleCode( id ) {
-    if ( document.getElementById )
-      elem = document.getElementById( id );
-    else if ( document.all )
-      elem = eval( "document.all." + id );
-    else
-      return false;
-    elemStyle = elem.style;
-    if ( elemStyle.display != "block" ) {
-      elemStyle.display = "block"
-    } else {
-      elemStyle.display = "none"
-    }
-    return true;
-  }
-  // Make codeblocks hidden by default
-  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
-  // ]]>
-  </script>
-</head>
-<body>
-  <div id="fileHeader">
-    <h1>methodic_hash.rb</h1>
-    <table class="header-table">
-    <tr class="top-aligned-row">
-      <td><strong>Path:</strong></td>
-      <td>lib/methodic_hash.rb
-      </td>
-    </tr>
-    <tr class="top-aligned-row">
-      <td><strong>Last Update:</strong></td>
-      <td>Fri Jun 08 10:23:50 -0400 2007</td>
-    </tr>
-    </table>
-  </div>
-  <!-- banner header -->
-  <div id="bodyContent">
-  <div id="contextContent">
-    <div id="description">
-      <p>
-The <a href="../../classes/MethodicHash.html">MethodicHash</a> is some
-method_missing magic that uses method names as hash keys, so hash
-assignment and lookup appear to be attribute writing and reading. For
-instance, if
-</p>
-<pre>
-  mh = MethodicHash.new
-  mh['four']  = 'iv'
-  mh[:seven]  = 'vii'
-  mh.eighteen = 'xviii'
-</pre>
-<p>
-then
-</p>
-<pre>
-  mh['four']     ---&gt; 'iv'
-  mh[:four]      ---&gt; 'iv'
-  mh.four        ---&gt; 'iv'
-  mh['seven']    ---&gt; 'vii'
-  mh[:seven]     ---&gt; 'vii'
-  mh.seven       ---&gt; 'vii'
-  mh['eighteen'] ---&gt; 'xviii'
-  mh[:eighteen]  ---&gt; 'xviii'
-  mh.eighteen    ---&gt; 'xviii'
-</pre>
-<p>
-This allows access to simply declared facts to be embedded in Ruby code and
-leverages the possibility of hashing procs.
-</p>
-<p>
-Note that if the hash uses anything but strings or symbols as keys, the
-magic stands a good chance of failing, raising an error or acting in a
-bizarre manner. Note also that methods of the Hash cannot be used as
-&#8216;attribute&#8217; names.
-</p>
-    </div>
-   </div>
-  </div>
-    <!-- if includes -->
-    <div id="section">
-    <!-- if method_list -->
-  </div>
-<div id="validator-badges">
-  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
-</div>
-</body>
-</html>

data/lib/enum.rb DELETED Viewed

@@ -1,57 +0,0 @@
-# Enums are used to build a sets of enumerated values.
-#
-# Numeric and bitwise enums are provided, and include provisions for assigned
-# values and the allowance of gaps.
-#
-#   enum %w(N1 N2 +2 N3 N4 =7 N5 N6 3 N7)
-#
-# gives N1 = 0, N2 = 1, N3 = 4, N4 = 5, N5 = 7, N6 = 8 and N7 = 3
-#
-#   enum_bitwise %w(B1 B2 +2 B3 B4 =7 B5 B6 3 B7)
-#
-# gives B1 = 1, B2 = 2, B3 = 16, B4 = 32, B5 = 128, B6 = 256 and B7 = 8
-class Enum
-  private
-  def self.build(arguments = {})
-    code = <<EOF
-def #{arguments[:method]}(*args)
-  offset = 0
-  bias = 0
-  args.flatten.each_with_index do |const,i|
-    case const
-    when /^\\+(\\d+)$/
-      offset = $1.to_i
-      bias += 1
-    when /^(\\=)?(\\d+)$/
-      offset = $2.to_i - i
-    else
-      class_eval %(#{arguments[:enum_type]})
-    end
-  end
-end
-EOF
-    arguments[:object].class_eval(code)
-  end
-  numeric = '#{const} = #{i+offset-bias}'
-  bitwise = '#{const} = #{2**(i+offset-bias)}'
-  Enum.build({ :object => Object,
-               :method => "self.enum",
-               :enum_type => numeric })
-  Enum.build({ :object => Object,
-               :method => "self.bitwise_enum",
-               :enum_type => bitwise })
-  Enum.build({ :object => Module,
-               :method => "enum",
-               :enum_type => numeric })
-  Enum.build({ :object => Module,
-               :method => "bitwise_enum",
-               :enum_type => bitwise })
-end

data/lib/envelope.rb DELETED Viewed

@@ -1,126 +0,0 @@
-# Envelopes are useful when finding the boundaries of a set of instances.
-# They expand as new values are added, and keep track of how many items
-# have been added to construct them.
-# An EnvelopeException is generally raised when adding an object to an
-# instance that it does not know how to interpret, or when requesting
-# bounderies before any values have been added.
-class EnvelopeException < Exception
-end
-# A BaseEnvelope provides a means to keep and provide a count of objects that
-# have been added to an envelope.
-class BaseEnvelope
-  # Called when requesting envelope bounderies before any values have been
-  # added.
-  def raise_no_envelope
-    raise EnvelopeException, "No values are enveloped"
-  end
-  # Called when the value cannot be compared with the the boundaries of the
-  # instance.
-  def raise_no_compare(value=nil)
-    value = "'#{value}' " unless value == nil
-    raise EnvelopeException,
-      "The value #{value}cannot be compared with the envelope"
-  end
-  # count of added values reader.
-  attr_reader :count
-  # Returns a new instance with no values added.
-  def initialize
-    @count = 0
-  end
-end
-# An Envelope is the minimum envelope that will completely contain a set of
-# values. Values may be added to an instance, and it can return the number
-# of values considered so far and its high and low boundaries.
-#
-# Envelopes can be used to generate ranges, however the result may be of
-# limited utility if the types of values being enveloped don't play nicely
-# with ranges.
-class Envelope < BaseEnvelope
-  # Creates and returns an instance. If an argument is given, it is passed to
-  # the set method to initialize the new instance.
-  def initialize(value=nil)
-    super()
-    add(value) unless value == nil
-  end
-  # Returns a string representation of the instance.
-  def to_s
-    values = (count > 0)? "\n  high  #{high}\n  low   #{low}" : ""
-    "Envelope: count #{count}#{values}"
-  end
-  # Adds a value to the instance. When
-  # * x is an Envelope, it is coalesced into the instance.
-  # * otherwise, the envelope is extened to contain the value.
-  # * if the value cannot be compared to the boundaries, an EnvelopeException is raised.
-  # The modified instance is returned.
-  def add(value)
-    if value.kind_of? Envelope
-      count = value.count
-      if (count > 0)
-        add value.high
-        add value.low
-        @count += (count-2)
-      end
-      self
-    else
-      begin
-        @high = value if (@count == 0 || value > @high)
-        @low = value if (@count == 0 || value < @low)
-        @count += 1
-        self
-      rescue
-        raise_no_compare value
-      end
-    end
-  end
-  # Returns the high boundary of the instance.
-  # * if there are no boundaries, an EnvelopeException is raised.
-  def high
-    raise_no_envelope if @count == 0
-    @high
-  end
-  # Returns the low boundary of the instance.
-  # * if there are no boundaries, an EnvelopeException is raised.
-  def low
-    raise_no_envelope if @count == 0
-    @low
-  end
-  # Returns true if the instance completely contains the argument:
-  # * value is an Envelope, its high and low are contained.
-  # * otherwise, the value is contained.
-  # * if the value cannot be compared to the boundaries, an EnvelopeException is raised.
-  def contains?(value)
-    if value.kind_of? Envelope
-      (contains? value.high) && (contains? value.low)
-    else
-      begin
-        (value >= low) && (value <= high)
-      rescue
-        raise_no_compare value
-      end
-    end
-  end
-  alias === contains?
-  # Returns an inclusive range from the low to high boundaries
-  def to_range
-    low..high
-  end
-end

data/lib/forward_referencing.rb DELETED Viewed

@@ -1,157 +0,0 @@
-# Forward referencing is one of those painful problems in programming - if
-# you try to use something before it's defined, trouble ensues. Using the
-# ForwardReferencing module and the ForwardReference class can let you
-# gracefully recover from problems caused by forward references in data and
-# processing.
-require 'eymiha'
-# The ForwardReferencing module can be mixed into a class to allow it to
-# capture and resolve ForwardReferences.
-module ForwardReferencing
-  # An array containing the set of unresolved forward references.
-  attr_reader :forward_references
-  # To be called from the initializer of the includer, this sets up the forward
-  # reference capture and resolution mechanisms.
-  def start_forward_referencing
-    forward_references_clear
-    @had_forward_reference_resolution = false
-    @forward_reference_resolver = nil
-  end
-  # To be called when a section of code that could contain a forward reference
-  # is entered. The method returns a newly created ForwardReference with the
-  # given dependency that can be jumped to during resolution.
-  def create_forward_reference(dependency=nil,context=nil)
-    forward_reference = ForwardReference.new(dependency,context)
-    @forward_references << forward_reference
-    forward_reference
-  end
-  # To be called when a section of code that could contain a forward reference
-  # has successfully been reached. It is used to remove the ForwardReference
-  # that was created at the start of the section, and asserts that a
-  # resolution was made.
-  def remove_forward_reference(forward_reference=nil)
-    @forward_references.delete forward_reference if
-      (forward_reference.kind_of? ForwardReference)
-    @had_forward_reference_resolution = true
-  end
-  # To be called to try to resolve any unresolved ForwardReferences by jumping
-  # to each in turn and retrying the code that caused it. This method repeats
-  # until nothing more is resolved. At that point unresolved forward reference
-  # may still exist, to be possibly resolved by another call to this method
-  # downstream. Prior to continuing to a forward reference, the
-  # establish_forward_reference context method is called with the context that
-  # was provided at the time the forward reference was created to give the
-  # receiver a chance to reset any transcient infromation.
-  def resolve_forward_references
-    forward_references = @forward_references
-    forward_references_clear
-    @had_forward_reference_resolution = false
-    if forward_references.size > 0
-      @forward_reference_resolver ||= callcc {|cont| cont} while
-        (@forward_reference_resolver == nil)
-      forward_reference = forward_references.shift
-      if forward_reference != nil
-        establish_forward_reference_context(forward_reference.context) if
-          respond_to?(:establish_forward_reference_context,true)
-        forward_reference.continuation.call
-      end
-    end
-    @forward_reference_resolver = nil
-    resolve_forward_references if @had_forward_reference_resolution
-  end
-  # To be called at the end of a section of code that could contain a forward
-  # reference, it will continue during normal processing and jump back to the
-  # resolve_forward_references method during resolution.
-  def continue_forward_reference_resolution
-    @forward_reference_resolver.call if @forward_reference_resolver
-  end
-  # Returns a hash of dependencies to arrays of the ForwardReferences that
-  # have them as dependencies.
-  def forward_reference_dependencies
-    dependencies = {}
-    @forward_references.each { |forward_reference|
-      dependency = forward_reference.dependency || "nil"
-      forward_references = dependencies[dependency]
-      dependencies[dependency] = [] if forward_references == nil
-      dependencies[dependency] << forward_reference
-    }
-    dependencies
-  end
-  # Returns a string indicating the current state of ForwardReferencing.
-  def forward_references_to_s
-    "#{self_name}  #{forward_references_remaining} unresolved"
-  end
-  # Returns the number of unresolved forward references.
-  def forward_references_remaining
-    @forward_references.size
-  end
-  # Remove the remaining unresolved forward references.
-  def forward_references_clear
-    @forward_references = []
-  end
-end
-# A ForwardReferencer is simply a class-wrapper for the ForwardReferencing
-# module. method have been shortened there is reduced potential for conflict
-# from inheritence than from inclusion or extension.
-class ForwardReferencer
-  understands ForwardReferencing
-  alias initialize   start_forward_referencing
-  alias create       create_forward_reference
-  alias remove       remove_forward_reference
-  alias resolve      resolve_forward_references
-  alias continue     continue_forward_reference_resolution
-  alias dependencies forward_reference_dependencies
-  alias to_s         forward_references_to_s
-  alias remaining    forward_references_remaining
-  alias clear	     forward_references_clear
-end
-# A ForwardReference holds a continuation and a dependency, the where and
-# the why of forward referencing.
-class ForwardReference
-  # Holds the place to jump back to for attempting to resolve a forward
-  # reference.
-  attr_reader :continuation
-  # Holds an arbitrary object that indicates why the forward reference
-  # occurred.
-  attr_accessor :dependency
-  # Holds an arbitrary object that holds context that can be re-established
-  # to help resolve the forward reference.
-  attr_accessor :context
-  # Returns a new instance with a valid continuation, the given dependency
-  # and contextual information.
-  def initialize(dependency=nil,context=nil)
-    @continuation = nil
-    @continuation = callcc{|cont| cont} while (@continuation == nil)
-    @dependency = dependency
-    @context = context
-  end
-  # Returns a string indicating the current state of the ForwardReference.
-  def to_s
-    "#{self_name}  dependency #{dependency}  #{continuation}"
-  end
-end