E-Mail threading based on JWZ algorithm
Latest commit 4004968 Jun 7, 2009 Frederik Dietz added manifest
Failed to load latest commit information.
example refactoring code, created new github gemspec Jun 7, 2009
lib added manifest Jun 7, 2009
.gitignore fixed pruning of empty containers - disabled subject based rendering … Aug 31, 2008
MIT-LICENSE added project files, Rakefile, etc. Aug 31, 2008
Manifest added manifest Jun 7, 2009
README refactoring code, created new github gemspec Jun 7, 2009
jwz_threading.gemspec updated rake gem task using echoe Jun 7, 2009
setup.rb added project files, Rakefile, etc. Aug 31, 2008


= jwz_threading

jwz_threading is a small ruby library which lets you order a list of E-Mails by conversation.
That is, grouping messages together in parent/child relationships based on which 
messages are replies to which others.

The library implements the JWZ E-Mail threading algorithm as described by Jamie Zawinski (http://www.jwz.org/doc/threading.html).

There is an IMAP extension Internet Draft available which decribes
the same here:

== Requirements
Ruby 1.8.* (not yet tested on Ruby 1.9.*)

Requires the following Ruby gems:
* TMail (http://tmail.rubyforge.org)

Only tested on OS X

== Documentation

The documentation is in RDoc format in the doc/rdoc subdirectory.

To generate new rdocs, type this:

    $ rake rdoc

== Install

- Using ruby gem

  Type this (You might needs super user privileges):

    $ gem install jwz_threading

  on Mac OS X:

    $ sudo gem install jwz_threading

  Documentation for gem can be found here: http://www.rubygems.org

- Using setup.rb

  Type this (You might needs super user privileges):

    $ ruby setup.rb

  If you want to install a program in to your home directory
  ($HOME), use following instead:

    $ ruby setup.rb all --prefix=$HOME

  Documentation for setup.rb can be round here:http://i.loveruby.net/en/projects/setup/doc/usage.html

== Status

This package is currently BETAS and therefore considered to be 
changed heavily in the near future. I very much appreciate suggestions 
and comments. 

== Tests

All tests can be found in /test directory. 

To run all tests, type this:
     $ rake test

To run a code coverage report, type:
     $ rake rcov

Documentation for rcov can be found here http://eigenclass.org/hiki/rcov

== RDocs

To generate up-to-date rdocs, type:

     $ rake rdoc

== Contact

* Author: Frederik Dietz
* Website: http://github.com/fdietz/jwz_threading
* E-Mail: fdietz@gmail.com 

== License

The MIT License (see MIT-LICENSE file)