file-tail 1.1.1 → 1.3.0

data/{README.rdoc → README.md}

@@ -1,77 +1,73 @@
-= File::Tail for Ruby
+# File::Tail for Ruby
 
-== Description
+## Description
 
 This is a small ruby library that allows it to "tail" files in Ruby, including
 following a file, that still is growing like the unix command 'tail -f' can.
 
-== Download
+## Download
 
-The latest version of <b>File::Tail</b> (file-tail) can be found at
+The latest version of *File::Tail* (file-tail) can be found at
 
-http://www.ping.de/~flori
-
-Online Documentation should be located at
 
 http://flori.github.com/file-tail
 
-== Installation
+## Installation
 
 To install file-tail via its gem type:
 
 # gem install file-tail
 
-To install from the source repository, just type into the command line as root:
-
-# rake install
-
-== Usage
+## Usage
 
 File::Tail is a module in the File class. A lightweight class interface for
 logfiles can be seen under File::Tail::Logfile.
 
 Direct extension of File objects with File::Tail works like that:
- File.open(filename) do |log|
-   log.extend(File::Tail)
-   log.interval = 10
-   log.backward(10)
-   log.tail { |line| puts line }
- end
+
+    File.open(filename) do |log|
+      log.extend(File::Tail)
+      log.interval # 10
+      log.backward(10)
+      log.tail { |line| puts line }
+    end
 
 It's also possible to mix File::Tail in your own File classes
 (see also File::Tail::Logfile):
- class MyFile < File
-   include File::Tail
- end
- log = MyFile.new("myfile")
- log.interval = 10
- log.backward(10)
- log.tail { |line| print line }
+
+    class MyFile < File
+      include File::Tail
+    end
+    log # MyFile.new("myfile")
+    log.interval # 10
+    log.backward(10)
+    log.tail { |line| print line }
 
 The forward/backward method returns self, so it's possible to chain
 methods together like that:
- log.backward(10).tail { |line| puts line }
+
+    log.backward(10).tail { |line| puts line }
 
 A command line utility named rtail, that uses File::Tail is provided as well.
 
-== Documentation
+## Documentation
 
 To create the documentation of this module, type
 
+```
 $ rake doc
+```
 
 and the API documentation is generated.
 
 In the examples direcotry is a small example of tail and
 pager program that use this module. You also may want look
-at the end of file/tail.rb for a little example.
+at the end of examples/tail.rb for a little example.
 
-== Author
+## Author
 
 Florian Frank mailto:flori@ping.de
 
-== License
+## License
 
-This is free software; you can redistribute it and/or modify it under
-the terms of the GNU General Public License Version 2 as published by
-the Free Software Foundation: http://www.gnu.org/copyleft/gpl.html
+Apache License, Version 2.0 – See the COPYING file in the source archive.

data/Rakefile

@@ -11,28 +11,15 @@ GemHadar do
   summary     "#{path_name.camelize} for Ruby"
   description 'Library to tail files in Ruby'
   test_dir    'tests'
-  ignore      '.*.sw[pon]', 'pkg', 'Gemfile.lock', 'coverage', '*.rbc', '.rbx', '.AppleDouble', '.bundle'
-  readme      'README.rdoc'
-  licenses << 'GPL-2.0'
+  ignore      '.*.sw[pon]', 'pkg', 'Gemfile.lock', 'coverage', '*.rbc', '.rbx',
+    '.AppleDouble', '.bundle', 'errors.lst', '.utilsrc'
+  readme      'README.md'
+  licenses    << 'Apache-2.0'
 
   dependency  'tins', '~>1.0'
 
-  development_dependency 'test-unit', '~>2.4.0'
-
-  install_library do
-    cd 'lib' do
-      libdir = CONFIG["sitelibdir"]
-
-      dest = File.join(libdir, 'file')
-      mkdir_p(dest)
-      dest = File.join(libdir, path_name)
-      install(path_name + '.rb', dest + '.rb', :verbose => true)
-      mkdir_p(dest)
-      for file in Dir[File.join(path_name, '*.rb')]
-        install(file, dest, :verbose => true)
-      end
-    end
-    bindir = CONFIG["bindir"]
-    install('bin/rtail', bindir, :verbose => true, :mode => 0755)
-  end
+  development_dependency 'test-unit', '~>3.0'
+  development_dependency 'all_images'
+  development_dependency 'simplecov'
+  development_dependency 'debug'
 end

data/VERSION

@@ -1 +1 @@
-1.1.1
+1.3.0

data/file-tail.gemspec

@@ -1,40 +1,31 @@
 # -*- encoding: utf-8 -*-
-# stub: file-tail 1.1.1 ruby lib
+# stub: file-tail 1.3.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "file-tail".freeze
-  s.version = "1.1.1"
+  s.version = "1.3.0".freeze
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
   s.authors = ["Florian Frank".freeze]
-  s.date = "2016-04-19"
+  s.date = "2024-09-13"
   s.description = "Library to tail files in Ruby".freeze
   s.email = "flori@ping.de".freeze
-  s.extra_rdoc_files = ["README.rdoc".freeze, "lib/file-tail.rb".freeze, "lib/file/tail.rb".freeze, "lib/file/tail/group.rb".freeze, "lib/file/tail/line_extension.rb".freeze, "lib/file/tail/logfile.rb".freeze, "lib/file/tail/tailer.rb".freeze, "lib/file/tail/version.rb".freeze]
-  s.files = [".gitignore".freeze, ".travis.yml".freeze, "CHANGES".freeze, "COPYING".freeze, "Gemfile".freeze, "README.rdoc".freeze, "Rakefile".freeze, "VERSION".freeze, "bin/rtail".freeze, "examples/pager.rb".freeze, "examples/tail.rb".freeze, "file-tail.gemspec".freeze, "lib/file-tail.rb".freeze, "lib/file/tail.rb".freeze, "lib/file/tail/group.rb".freeze, "lib/file/tail/line_extension.rb".freeze, "lib/file/tail/logfile.rb".freeze, "lib/file/tail/tailer.rb".freeze, "lib/file/tail/version.rb".freeze, "tests/file_tail_group_test.rb".freeze, "tests/file_tail_test.rb".freeze, "tests/test_helper.rb".freeze]
+  s.extra_rdoc_files = ["README.md".freeze, "lib/file-tail.rb".freeze, "lib/file/tail.rb".freeze, "lib/file/tail/group.rb".freeze, "lib/file/tail/line_extension.rb".freeze, "lib/file/tail/logfile.rb".freeze, "lib/file/tail/tailer.rb".freeze, "lib/file/tail/version.rb".freeze]
+  s.files = [".all_images.yml".freeze, ".gitignore".freeze, ".travis.yml".freeze, "CHANGES.md".freeze, "COPYING".freeze, "Gemfile".freeze, "README.md".freeze, "Rakefile".freeze, "VERSION".freeze, "bin/rtail".freeze, "examples/pager.rb".freeze, "examples/tail.rb".freeze, "file-tail.gemspec".freeze, "lib/file-tail.rb".freeze, "lib/file/tail.rb".freeze, "lib/file/tail/group.rb".freeze, "lib/file/tail/line_extension.rb".freeze, "lib/file/tail/logfile.rb".freeze, "lib/file/tail/tailer.rb".freeze, "lib/file/tail/version.rb".freeze, "tests/file_tail_group_test.rb".freeze, "tests/file_tail_test.rb".freeze, "tests/test_helper.rb".freeze]
   s.homepage = "http://github.com/flori/file-tail".freeze
-  s.licenses = ["GPL-2.0".freeze]
-  s.rdoc_options = ["--title".freeze, "File-tail - File::Tail for Ruby".freeze, "--main".freeze, "README.rdoc".freeze]
-  s.rubygems_version = "2.6.3".freeze
+  s.licenses = ["Apache-2.0".freeze]
+  s.rdoc_options = ["--title".freeze, "File-tail - File::Tail for Ruby".freeze, "--main".freeze, "README.md".freeze]
+  s.rubygems_version = "3.5.18".freeze
   s.summary = "File::Tail for Ruby".freeze
   s.test_files = ["tests/file_tail_group_test.rb".freeze, "tests/file_tail_test.rb".freeze, "tests/test_helper.rb".freeze]
 
-  if s.respond_to? :specification_version then
-    s.specification_version = 4
+  s.specification_version = 4
 
-    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_development_dependency(%q<gem_hadar>.freeze, ["~> 1.7.1"])
-      s.add_development_dependency(%q<test-unit>.freeze, ["~> 2.4.0"])
-      s.add_runtime_dependency(%q<tins>.freeze, ["~> 1.0"])
-    else
-      s.add_dependency(%q<gem_hadar>.freeze, ["~> 1.7.1"])
-      s.add_dependency(%q<test-unit>.freeze, ["~> 2.4.0"])
-      s.add_dependency(%q<tins>.freeze, ["~> 1.0"])
-    end
-  else
-    s.add_dependency(%q<gem_hadar>.freeze, ["~> 1.7.1"])
-    s.add_dependency(%q<test-unit>.freeze, ["~> 2.4.0"])
-    s.add_dependency(%q<tins>.freeze, ["~> 1.0"])
-  end
+  s.add_development_dependency(%q<gem_hadar>.freeze, ["~> 1.17.1".freeze])
+  s.add_development_dependency(%q<test-unit>.freeze, ["~> 3.0".freeze])
+  s.add_development_dependency(%q<all_images>.freeze, [">= 0".freeze])
+  s.add_development_dependency(%q<simplecov>.freeze, [">= 0".freeze])
+  s.add_development_dependency(%q<debug>.freeze, [">= 0".freeze])
+  s.add_runtime_dependency(%q<tins>.freeze, ["~> 1.0".freeze])
 end

data/lib/file/tail/version.rb

@@ -1,6 +1,6 @@
 module File::Tail
   # File::Tail version
-  VERSION         = '1.1.1'
+  VERSION         = '1.3.0'
   VERSION_ARRAY   = VERSION.split('.').map(&:to_i) # :nodoc:
   VERSION_MAJOR   = VERSION_ARRAY[0] # :nodoc:
   VERSION_MINOR   = VERSION_ARRAY[1] # :nodoc:

data/lib/file/tail.rb

@@ -94,12 +94,16 @@ class File
     # value from the filesystem block size.
     attr_accessor :default_bufsize
 
+    # Override the default line separator
+    attr_accessor :line_separator
+
     # Skip the first <code>n</code> lines of this file. The default is to don't
     # skip any lines at all and start at the beginning of this file.
     def forward(n = 0)
+      preset_attributes unless defined? @lines
       rewind
       while n > 0 and not eof?
-        readline
+        readline(@line_separator)
         n -= 1
       end
       self
@@ -115,6 +119,7 @@ class File
     # filesystem this file belongs to or 8192 bytes if this cannot
     # be determined.
     def backward(n = 0, bufsize = nil)
+      preset_attributes unless defined? @lines
       if n <= 0
         seek(0, File::SEEK_END)
         return self
@@ -127,13 +132,13 @@ class File
           while n > 0 and tell > 0 do
             seek(-bufsize, File::SEEK_CUR)
             buffer = read(bufsize)
-            n -= buffer.count("\n")
+            n -= buffer.count(@line_separator)
             seek(-bufsize, File::SEEK_CUR)
           end
         else
           rewind
           buffer = read(size)
-          n -= buffer.count("\n")
+          n -= buffer.count(@line_separator)
           rewind
         end
       rescue Errno::EINVAL
@@ -142,7 +147,7 @@ class File
       end
       pos = -1
       while n < 0  # forward if we are too far back
-        pos = buffer.index("\n", pos + 1)
+        pos = buffer.index(@line_separator, pos + 1)
         n += 1
       end
       seek(pos + 1, File::SEEK_CUR)
@@ -177,7 +182,7 @@ class File
           redo
         rescue ReopenException => e
           until eof? || @n == 0
-            block.call readline
+            block.call readline(@line_separator)
             @n -= 1 if @n
           end
           reopen_file(e.mode)
@@ -193,7 +198,7 @@ class File
     def read_line(&block)
       if @n
         until @n == 0
-          block.call readline
+          block.call readline(@line_separator)
           @lines   += 1
           @no_read = 0
           @n       -= 1
@@ -201,7 +206,7 @@ class File
         end
         raise ReturnException
       else
-        block.call readline
+        block.call readline(@line_separator)
         @lines   += 1
         @no_read = 0
         output_debug_information
@@ -223,6 +228,7 @@ class File
       @break_if_eof         = false unless defined? @break_if_eof
       @return_if_eof        = false unless defined? @return_if_eof
       @max_interval         ||= 10
+      @line_separator       ||= $/
       @interval             ||= @max_interval
       @suspicious_interval  ||= 60
       @lines                = 0
@@ -241,9 +247,8 @@ class File
           @stat = nil
           raise ReopenException.new(:top)
         end
-      else
-        @stat = stat
       end
+      @stat = stat
     rescue Errno::ENOENT, Errno::ESTALE
       raise ReopenException
     end
@@ -267,7 +272,7 @@ class File
     end
 
     def reopen_file(mode)
-      $DEBUG and $stdout.print "Reopening '#{path}', mode = #{mode}.\n"
+      debug? and $stdout.print "Reopening '#{path}', mode = #{mode}.\n"
       @no_read = 0
       reopen(path)
       if mode == :bottom
@@ -285,7 +290,7 @@ class File
     end
 
     def output_debug_information
-      $DEBUG or return
+      debug? or return
       STDERR.puts({
         :path     => path,
         :lines    => @lines,
@@ -295,6 +300,10 @@ class File
       }.inspect)
       self
     end
+
+    def debug?
+      ENV['FILE_TAIL_DEBUG'].to_i == 1
+    end
   end
 end
 

data/tests/file_tail_test.rb

@@ -4,13 +4,16 @@ require 'test_helper'
 require 'file/tail'
 require 'timeout'
 require 'thread'
+require 'fileutils'
 Thread.abort_on_exception = true
 
 class FileTailTest < Test::Unit::TestCase
   include File::Tail
+  include FileUtils
 
   def setup
-    @out = File.new("test.#$$", "wb")
+    @out = File.new(File.join(__dir__, "test.#$$"), "wb")
+    at_exit { rm_f File.expand_path(@out.path) }
     append(@out, 100)
     @in = File.new(@out.path, "rb")
     @in.extend(File::Tail)
@@ -194,7 +197,7 @@ class FileTailTest < Test::Unit::TestCase
     lines = []
     logger = Thread.new do
       begin
-        Timeout::timeout(2) do
+        Timeout::timeout(10) do
           @in.tail do |l|
             lines << l
           end
@@ -225,7 +228,7 @@ class FileTailTest < Test::Unit::TestCase
     lines = []
     logger = Thread.new do
       begin
-        Timeout::timeout(2) do
+        Timeout::timeout(10) do
           @in.tail do |l|
             lines << l
           end
@@ -261,7 +264,7 @@ class FileTailTest < Test::Unit::TestCase
     lines = []
     logger = Thread.new do
       begin
-        Timeout::timeout(2) do
+        Timeout::timeout(10) do
           @in.tail(15) do |l|
             lines << l
           end
@@ -298,7 +301,7 @@ class FileTailTest < Test::Unit::TestCase
     lines = []
     logger = Thread.new do
       begin
-        Timeout::timeout(2) do
+        Timeout::timeout(10) do
           @in.tail(110) do |l|
             lines << l
           end
@@ -307,8 +310,10 @@ class FileTailTest < Test::Unit::TestCase
       end
     end
     appender = Thread.new do
-      until logger.stop?
-        sleep 0.1
+      Timeout::timeout(10) do
+        until lines.size == 100
+          sleep 0.1
+        end
       end
       @out.close
       File.unlink(@out.path)
@@ -331,7 +336,7 @@ class FileTailTest < Test::Unit::TestCase
     lines = []
     logger = Thread.new do
       begin
-        Timeout::timeout(2) do
+        Timeout::timeout(10) do
           @in.tail(110) do |l|
             lines << l
           end
@@ -340,8 +345,10 @@ class FileTailTest < Test::Unit::TestCase
       end
     end
     appender = Thread.new do
-      until logger.stop?
-        sleep 0.1
+      Timeout::timeout(10) do
+        until lines.size == 100
+          sleep 0.1
+        end
       end
       @out.truncate 0
       @out.close

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: file-tail
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 1.3.0
 platform: ruby
 authors:
 - Florian Frank
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2016-04-19 00:00:00.000000000 Z
+date: 2024-09-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gem_hadar
@@ -16,28 +16,70 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.7.1
+        version: 1.17.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.7.1
+        version: 1.17.1
 - !ruby/object:Gem::Dependency
   name: test-unit
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.4.0
+        version: '3.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.4.0
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: all_images
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: debug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: tins
   requirement: !ruby/object:Gem::Requirement
@@ -57,7 +99,7 @@ email: flori@ping.de
 executables: []
 extensions: []
 extra_rdoc_files:
-- README.rdoc
+- README.md
 - lib/file-tail.rb
 - lib/file/tail.rb
 - lib/file/tail/group.rb
@@ -66,12 +108,13 @@ extra_rdoc_files:
 - lib/file/tail/tailer.rb
 - lib/file/tail/version.rb
 files:
+- ".all_images.yml"
 - ".gitignore"
 - ".travis.yml"
-- CHANGES
+- CHANGES.md
 - COPYING
 - Gemfile
-- README.rdoc
+- README.md
 - Rakefile
 - VERSION
 - bin/rtail
@@ -90,14 +133,14 @@ files:
 - tests/test_helper.rb
 homepage: http://github.com/flori/file-tail
 licenses:
-- GPL-2.0
+- Apache-2.0
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options:
 - "--title"
 - File-tail - File::Tail for Ruby
 - "--main"
-- README.rdoc
+- README.md
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
@@ -111,9 +154,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.3
-signing_key: 
+rubygems_version: 3.5.18
+signing_key:
 specification_version: 4
 summary: File::Tail for Ruby
 test_files:

data/CHANGES

@@ -1,80 +0,0 @@
-2014-09-26 * 1.1.0 * Depend on tins ~ 1.0
-2012-05-31 * 1.0.10 * Use rewind to force IO#lineno to be reset.
-2012-05-31 * 1.0.9 * Reopen file in :top mode at the beginning.
-2011-12-24 * 1.0.8 * Support simplecov.
-2011-07-15 * 1.0.7 * Use gem_hadar to shorten Rakefile.
-2011-06-25 * 1.0.6 * Create a gem spec file again.
-                   * Added a File::Tail::Group to tail multiple files more easily.
-2010-03-25 * 1.0.5 * Added rtail executable, a nice app to supervise logfiles
-                     and logdirs.
-                   * Disabled creation of gem spec file.
-                   * Cleaned up documentation a bit.
-2009-08-21 * 1.0.4 * Fixed the threaded tests for Ruby 1.9.
-                   * Create a gem spec file.
-                   * Some cleanup.
-2008-04-07 * 1.0.3 * Danny Colligan <danny.colligan@sendori.com> reported a
-                     memory leak in long running scripts using file-tail. I
-                     think this might be a ruby related problem, which is
-                     caused/aggravated by using yield after having &block
-                     parameter in a method. I changed file-tail to only use
-                     block.call, which seems to improve the memory behaviour. I
-                     am still not sure, where the problem actually stems
-                     from, though.
-2007-04-19 * 1.0.2 * make_doc.rb was missing from the source archive. Thanks to
-                     Rick Ohnemus <rick.ohnemus@systemware.com> for reporting it.
-2007-04-19 * 1.0.1 * Bugfix: File::Tail::Logfile#open with block, now closes
-                     the file like File#open does. Found by Alex Doan
-                     <alex.doan@wachovia.com>, ruby-talk:248383.
-2007-03-30 * 1.0.0 * Bugfix: David.Barzilay@swisscom.com reported, that file
-                     tails may skip some log file lines, after rotating it. I
-                     think, that I fixed that problem.
-                     I added a after_reopen callback as well, that is called
-                     after reopening of the tailed file has occured.
-                   * Removed rewind/wind methods even earlier than planned: I
-                     placed the deprecation warning for rewind method in File
-                     instead of File::Tail, which caused rewind to stop working
-                     completely after loading file/tail. Duh! I blame vim's
-                     matchit, because it jumped to the wrong end keyword.
-2007-02-08 * 0.1.4 * Renamed rewind method to backward, and wind method to
-                     forward, because someone already had the good idea to name
-                     a method IO#rewind, which was overwritten by the mixed in
-                     File::Tail methods. The old methods are now deprecated and
-                     will be removed in a new 0.2.x version of the library.
-                   * Added a bit more of documentation.
-2005-08-20 * 0.1.3 * Applied LOAD_PATH  patch by Daniel Berger, binary mode
-                     changes were already in the CVS. Seemed to be like cheating
-                     to me, though. ;)
-                   * Skipping one windows test for the moment, too. Sigh!
-2004-09-30 * 0.1.2 * First Rubyforge release
-                   * Added Rakefile
-                   * Supports gem build now.
-2004-09-01 * 0.1.1 * Josh Endries <josh@endries.org> found a bug
-                     that caused File::Tail to malfunction on FreeBSD.
-                     Hotfix: Use a side effect of seek to clearerr the tailed
-                     file handle after EOFError has been raised.
-2004-04-13 * 0.1.0 * API documentation with rdoc.
-                   * return_if_eof attribute added.
-                   * Added array return mode for finite tail call without block
-                     given.
-                   * install.rb now uses ruby version site_dir.
-                   * Some code and directory structure cleanup.
-2002-08-02 * 0.0.2 * Heavy refactoring, more and smaller methods
-                     and expception handling
-                   * Added check for inode and device equality of files
-                     as suggested by
-                     James F.Hranicky <jfh@cise.ufl.edu> and
-                     Curt Sampson  <cjs@cynic.net> to cover remove
-                     rotation
-                   * If filesize shrinks suddenly, File::Tail assumes that
-                     copy and truncate rotation has happend: The file
-                     is reopened and every new line is handled.
-                   * NFS-Fix: Errno::ESTALE is caught.
-                   * wind added to skip the first n lines, as
-                     James F.Hranicky's suggested and changed
-                     name of last-method to rewind, because I liked
-                     his method names better than mine ;)
-                   * Renamed next to tail either.
-                   * The API has changed - but I think very few people
-                     care at the moment.
-                   * Lots of tests added.
-2002-07-30 * 0.0.1 * Initial Release