file-tail 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 82cf3f0b3b8d131b06101e28680a2dd0d2fb70fc
-  data.tar.gz: 59c4c79c2499a858925cbd96f87052a875616118
+SHA256:
+  metadata.gz: 2cf544dbe9b55dc5369593f301c270154af027cdafa4ebfe69425f0384fcc320
+  data.tar.gz: 877cb588d7acd10fbe1c59672fc609c17dc1fd29eda5b3091c79f2f1791bc96f
 SHA512:
-  metadata.gz: 4b5cd1010abe3d92b58d2a43f08fc1f587b834e2130e836371a11b6989cb6fa605e5770e8a662b649643c8346f44919a96ca7c04b92b91e69358a0aadbdf02b0
-  data.tar.gz: 23982bf55e95a0369e30d7cce2fd77f4d2736006091a59daa9781eb1e7d4163c7b9db9b46d0c1019ebec9be222f2aa9de0497faa1a0fdbfa28093ae8a6fa3509
+  metadata.gz: dbef35840950052d1a944812a0fc161f8a9bad1111d8062091a4b0098408eb34b051fb3dce02a0c44c0f2a4e5ff2b4e88aeefd1301f56e6084cc70a6a578e9f2
+  data.tar.gz: e7fa4e45186734548b327177d3fa44cbc2b214a02cf716f2de589e6d6bf6b83d4fba5e229b765c127d11a9cad87fd92d4f1dcf4813ebd82ea7b2ec6c1acedfa0

data/.all_images.yml

@@ -0,0 +1,27 @@
+dockerfile: |-
+  RUN apk add --no-cache build-base git bash
+  RUN bash <<NUR
+    if [[ "$(ruby -e 'print RUBY_VERSION')" > '3' ]]
+    then
+      gem update --system
+      gem install gem_hadar bundler
+    else
+      gem install gem_hadar
+      gem install bundler -v 2.4.22
+    fi
+  NUR
+fail_fast: true
+script: &script |-
+  echo -e "\e[1m"
+  ruby -v
+  echo -e "\e[0m"
+  bundle install
+  rake test
+
+images:
+  ruby:3.3-alpine: *script
+  ruby:3.2-alpine: *script
+  ruby:3.1-alpine: *script
+  ruby:3.0-alpine: *script
+  ruby:2.7-alpine: *script
+  ruby:2.6-alpine: *script

data/.gitignore

@@ -3,6 +3,8 @@
 .AppleDouble
 .bundle
 .rbx
+.utilsrc
 Gemfile.lock
 coverage
+errors.lst
 pkg

data/.travis.yml

@@ -1,8 +1,10 @@
 rvm:
   - 2.1
   - 2.2
-  - 2.3.3
-  - 2.4.1
+  - 2.3
+  - 2.4
+  - 2.5
+  - 2.6
   - ruby-head
   - jruby-head
 sudo: false

data/CHANGES.md

@@ -0,0 +1,160 @@
+# Changes
+
+## 2024-09-13 v1.3.0
+
+### Significant Changes
+
+* **Improved waiting for log output by counting lines**
+	+ Increased timeout from 2 seconds to 10 seconds in multiple places
+* **Added Ruby version check in Dockerfile**
+	+ Update `gem update --system` and installation to be conditional on Ruby version
+	+ Replace `bundle` with `bundle install` in script section
+* **Convert CHANGES file to CHANGES\.md**
+
+### Bug Fixes
+
+* **Add exit handler to delete temporary file**
+	- Added at_exit block to delete test file created in setup method.
+* **Refactor File class for debugging**
+	- Remove hardcoded `$DEBUG` variable usage in reopen_file and output_debug_information methods
+	- Introduce debug? method to check if `FILE_TAIL_DEBUG` environment variable is set to 1.
+
+### Dependency Updates
+
+* **Update Ruby dependencies and add new development dependencies**
+	+ Added `.all_images.yml` file with Dockerfile configuration
+	+ Updated Gemfile to use Ruby **3.5.18** instead of **2.7.8**
+	+ Updated Rakefile to ignore additional files
+	+ Updated `file-tail.gemspec` to include `.all_images.yml` in the list of files
+	+ Updated `tests/file_tail_test.rb` to use absolute path for test file
+	+ Added new development dependencies: `all_images`, `simplecov`, and `debug`
+    + Updated dependency versions: `gem_hadar` to **1.17.1**, `test-unit` to
+      **3.0**, and `tins` to **1.0**
+
+## 2016-04-19 v1.2.0
+
+* Make line separator configurable
+
+## 2016-04-19 v1.1.1
+
+* Fix tests on Ruby 2.3.0
+
+## 2014-09-26 v1.1.0
+
+* Depend on tins ~ 1.0
+
+## 2012-05-31 v1.0.10
+
+* Use rewind to force IO#lineno to be reset.
+
+## 2012-05-31 v1.0.9
+
+* Reopen file in :top mode at the beginning.
+
+## 2011-12-24 v1.0.8
+
+* Support simplecov.
+
+## 2011-07-15 v1.0.7
+
+* Use gem_hadar to shorten Rakefile.
+
+## 2011-06-25 v1.0.6
+
+* Create a gem spec file again.
+* Added a File::Tail::Group to tail multiple files more easily.
+
+## 2010-03-25 v1.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 v1.0.4
+
+* Fixed the threaded tests for Ruby 1.9.
+* Create a gem spec file.
+* Some cleanup.
+
+## 2008-04-07 v1.0.3
+
+* Danny Colligan <danny.colligan@sendori.com> reported a memory leak in long
+  running scripts using file-tail. I changed file-ta il to only use block.call,
+  which seems to improve the memory behaviour. I am still not sure, where the
+  problem actually stems f rom, though.
+
+## 2007-04-19 v1.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 v1.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 v1.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.
+* 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 jump ed to the wrong end keyword.
+
+## 2007-02-08 v0.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 n ew 0.2.x version of the library.
+* Added a bit more of documentation.
+
+## 2005-08-20 v0.1.3
+
+* Applied LOAD_PATH patch by Daniel Berger, binary mode changes were already in
+  the CVS. Seemed to be like cheating to me, thou gh. ;)
+* Skipping one windows test for the moment, too. Sigh!
+
+## 2004-09-30 v0.1.2
+
+* First Rubyforge release
+* Added Rakefile
+* Supports gem build now.
+
+## 2004-09-01 v0.1.1
+
+* Josh Endries <josh@endries.org> found a bug that caused File::Tail to
+  malfunction on FreeBSD. Hotfix: Use a side effect of se ek to clearerr the
+  tailed file handle after EOFError has been raised.
+
+## 2004-04-13 v0.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 v0.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 li ked 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 v0.0.1
+
+* Initial Release

data/Gemfile

@@ -3,8 +3,3 @@
 source 'https://rubygems.org'
 
 gemspec
-
-group :development do
-  gem 'simplecov'
-  gem 'utils'
-end

data/Rakefile

@@ -11,12 +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'
+  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'
+  development_dependency 'test-unit', '~>3.0'
+  development_dependency 'all_images'
+  development_dependency 'simplecov'
+  development_dependency 'debug'
 end

data/VERSION

@@ -1 +1 @@
-1.2.0
+1.3.0

data/file-tail.gemspec

@@ -1,40 +1,31 @@
 # -*- encoding: utf-8 -*-
-# stub: file-tail 1.2.0 ruby lib
+# stub: file-tail 1.3.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "file-tail".freeze
-  s.version = "1.2.0"
+  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 = "2017-04-13"
+  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.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 = [".gitignore".freeze, ".travis.yml".freeze, "CHANGES".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.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 = ["Apache-2.0".freeze]
   s.rdoc_options = ["--title".freeze, "File-tail - File::Tail for Ruby".freeze, "--main".freeze, "README.md".freeze]
-  s.rubygems_version = "2.6.11".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.9.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.9.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.9.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.2.0'
+  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

@@ -272,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
@@ -290,7 +290,7 @@ class File
     end
 
     def output_debug_information
-      $DEBUG or return
+      debug? or return
       STDERR.puts({
         :path     => path,
         :lines    => @lines,
@@ -300,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.2.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Florian Frank
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2017-04-13 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.9.1
+        version: 1.17.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.9.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
@@ -66,9 +108,10 @@ 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.md
@@ -92,7 +135,7 @@ homepage: http://github.com/flori/file-tail
 licenses:
 - Apache-2.0
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options:
 - "--title"
 - File-tail - File::Tail for Ruby
@@ -111,9 +154,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.11
-signing_key: 
+rubygems_version: 3.5.18
+signing_key:
 specification_version: 4
 summary: File::Tail for Ruby
 test_files:

data/CHANGES

@@ -1,82 +0,0 @@
-2016-04-19 * 1.2.0 * Make line separator configurable
-2016-04-19 * 1.1.1 * Fix tests on Ruby 2.3.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