documentalist 0.1.0 → 0.1.1

data/Manifest

@@ -1,12 +1,48 @@
-README.rdoc
-Rakefile
-documentalist.gemspec
-init.rb
-lib/DocumentConverter.py
-lib/documentalist.rb
-lib/open_office/server.rb
-rails/init.rb
-test/documentalist_test.rb
-test/fixtures/fixture.odt
-test/open_office_test.rb
-Manifest
+README.rdoc
+Rakefile
+config/default.yml
+documentalist.gemspec
+init.rb
+lib/backends/net_pbm.rb
+lib/backends/odf_merge.rb
+lib/backends/open_office.rb
+lib/backends/open_office/bridges/jodconverter-2.2.2/ChangeLog.txt
+lib/backends/open_office/bridges/jodconverter-2.2.2/LICENSE.txt
+lib/backends/open_office/bridges/jodconverter-2.2.2/README.txt
+lib/backends/open_office/bridges/jodconverter-2.2.2/docs/jodconverter-2.2.2-javadoc.jar
+lib/backends/open_office/bridges/jodconverter-2.2.2/docs/third-party-licenses/license-commons-io.txt
+lib/backends/open_office/bridges/jodconverter-2.2.2/docs/third-party-licenses/license-openoffice.org.txt
+lib/backends/open_office/bridges/jodconverter-2.2.2/docs/third-party-licenses/license-slf4j.txt
+lib/backends/open_office/bridges/jodconverter-2.2.2/docs/third-party-licenses/license-xstream.txt
+lib/backends/open_office/bridges/jodconverter-2.2.2/document-formats.xml
+lib/backends/open_office/bridges/jodconverter-2.2.2/lib/DEPENDENCIES.txt
+lib/backends/open_office/bridges/jodconverter-2.2.2/lib/commons-cli-1.2.jar
+lib/backends/open_office/bridges/jodconverter-2.2.2/lib/commons-io-1.4.jar
+lib/backends/open_office/bridges/jodconverter-2.2.2/lib/jodconverter-2.2.2.jar
+lib/backends/open_office/bridges/jodconverter-2.2.2/lib/jodconverter-cli-2.2.2.jar
+lib/backends/open_office/bridges/jodconverter-2.2.2/lib/juh-3.0.1.jar
+lib/backends/open_office/bridges/jodconverter-2.2.2/lib/jurt-3.0.1.jar
+lib/backends/open_office/bridges/jodconverter-2.2.2/lib/ridl-3.0.1.jar
+lib/backends/open_office/bridges/jodconverter-2.2.2/lib/slf4j-api-1.5.6.jar
+lib/backends/open_office/bridges/jodconverter-2.2.2/lib/slf4j-jdk14-1.5.6.jar
+lib/backends/open_office/bridges/jodconverter-2.2.2/lib/unoil-3.0.1.jar
+lib/backends/open_office/bridges/jodconverter-2.2.2/lib/xstream-1.3.1.jar
+lib/backends/open_office/bridges/jodconverter-2.2.2/src/jodconverter-2.2.2-sources.jar
+lib/backends/open_office/bridges/jodconverter-2.2.2/src/jodconverter-cli-2.2.2-sources.jar
+lib/backends/open_office/bridges/pyodconverter.py
+lib/backends/open_office/server.rb
+lib/backends/pdf_tools.rb
+lib/documentalist.rb
+lib/tasks/tasks.rb
+rails/config/documentalist.yml.tpl
+rails/init.rb
+rails/initialize_configuration.rb
+test/documentalist_test.rb
+test/fixtures/fixture_001.odt
+test/net_pbm_test.rb
+test/odf_merge_test.rb
+test/open_office_test.rb
+test/pdf_tools_test.rb
+test/rails_integration_test.rb
+test/test_helper.rb
+Manifest

data/README.rdoc

@@ -1,3 +1,3 @@
 = Documentalist
 
-Rails gem for talking to OpenOffice.
+Rails gem for talking to OpenOffice and merging data into OpenDocument templates using an ERB-like syntax.

data/Rakefile

@@ -1,16 +1,32 @@
 require 'rubygems'
 require 'rake'
-require 'echoe'
 
-Echoe.new('documentalist', '0.1.0') do |p|
-  p.description     = "Ruby interface that talks to OpenOffice"
-  p.url             = "http://github.com/davout/documentalist"
-  p.author          = "David FRANCOIS"
-  p.email           = "david.francois@webflows.fr"
-  p.ignore_pattern  = ["tmp/*", "script/*"]
-  p.test_pattern    = "test/**/*.rb"
-  p.development_dependencies = []
-  p.runtime_dependencies = ['zip >=2.0.2']
-end  
+# We want developers to be able to include rake tasks even without echoe gem available
+require 'echoe' rescue nil
 
-Dir["#{File.dirname(__FILE__)}/tasks/*.rake"].sort.each { |ext| load ext }
+if Object.const_defined? :Echoe
+  Echoe.new('documentalist', '0.1.1') do |p|
+    p.description     = "The smooth document management experience, usable as a Rails gem plugin or standalone in any ruby application"
+    p.url             = "http://github.com/davout/documentalist"
+    p.author          = "David FRANCOIS"
+    p.email           = "david.francois@webflows.fr"
+    p.ignore_pattern  = ["tmp/*", "script/*"]
+    p.test_pattern    = "test/**/*.rb"
+    p.development_dependencies = ['flexmock >=0.8.6']
+    p.runtime_dependencies = ['zip >=2.0.2', 'SystemTimer >=1.2']
+
+    # TODO : Enforce some dependencies and don't make backend available if
+    # the dependency is not met
+    #
+    # wkhtmltopdf
+    # iconv
+    # pgrep
+    # ps
+    # pkill
+    # grep
+    # file
+    # which
+    # jod converter
+    # open office 3
+  end
+end

data/config/default.yml

@@ -0,0 +1,17 @@
+# Default configuration in case none is provided
+log_path: ~/documentalist.log
+
+python:
+  path: /usr/bin/python
+
+java:
+  path: /usr/bin/java
+
+open_office:
+  path: /usr/bin/soffice
+  bridge: JOD
+  max_cpu: 80
+  max_startup_time: 3
+  wakeup_time: 3
+  max_conversion_attempts: 3
+  max_conversion_time: 5

data/documentalist.gemspec

@@ -1,34 +1,40 @@
-# -*- encoding: utf-8 -*-
-
-Gem::Specification.new do |s|
-  s.name = %q{documentalist}
-  s.version = "0.1.0"
-
-  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
-  s.authors = ["David FRANCOIS"]
-  s.date = %q{2010-06-08}
-  s.description = %q{Ruby interface that talks to OpenOffice}
-  s.email = %q{david.francois@webflows.fr}
-  s.extra_rdoc_files = ["README.rdoc", "lib/DocumentConverter.py", "lib/documentalist.rb", "lib/open_office/server.rb"]
-  s.files = ["README.rdoc", "Rakefile", "documentalist.gemspec", "init.rb", "lib/DocumentConverter.py", "lib/documentalist.rb", "lib/open_office/server.rb", "rails/init.rb", "test/documentalist_test.rb", "test/fixtures/fixture.odt", "test/open_office_test.rb", "Manifest"]
-  s.homepage = %q{http://github.com/davout/documentalist}
-  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Documentalist", "--main", "README.rdoc"]
-  s.require_paths = ["lib"]
-  s.rubyforge_project = %q{documentalist}
-  s.rubygems_version = %q{1.3.7}
-  s.summary = %q{Ruby interface that talks to OpenOffice}
-  s.test_files = ["test/documentalist_test.rb", "test/open_office_test.rb"]
-
-  if s.respond_to? :specification_version then
-    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
-    s.specification_version = 3
-
-    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_runtime_dependency(%q<zip>, [">= 2.0.2"])
-    else
-      s.add_dependency(%q<zip>, [">= 2.0.2"])
-    end
-  else
-    s.add_dependency(%q<zip>, [">= 2.0.2"])
-  end
-end
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{documentalist}
+  s.version = "0.1.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["David FRANCOIS"]
+  s.date = %q{2010-06-30}
+  s.description = %q{The smooth document management experience, usable as a Rails gem plugin or standalone in any ruby application}
+  s.email = %q{david.francois@webflows.fr}
+  s.extra_rdoc_files = ["README.rdoc", "lib/backends/net_pbm.rb", "lib/backends/odf_merge.rb", "lib/backends/open_office.rb", "lib/backends/open_office/bridges/jodconverter-2.2.2/ChangeLog.txt", "lib/backends/open_office/bridges/jodconverter-2.2.2/LICENSE.txt", "lib/backends/open_office/bridges/jodconverter-2.2.2/README.txt", "lib/backends/open_office/bridges/jodconverter-2.2.2/docs/jodconverter-2.2.2-javadoc.jar", "lib/backends/open_office/bridges/jodconverter-2.2.2/docs/third-party-licenses/license-commons-io.txt", "lib/backends/open_office/bridges/jodconverter-2.2.2/docs/third-party-licenses/license-openoffice.org.txt", "lib/backends/open_office/bridges/jodconverter-2.2.2/docs/third-party-licenses/license-slf4j.txt", "lib/backends/open_office/bridges/jodconverter-2.2.2/docs/third-party-licenses/license-xstream.txt", "lib/backends/open_office/bridges/jodconverter-2.2.2/document-formats.xml", "lib/backends/open_office/bridges/jodconverter-2.2.2/lib/DEPENDENCIES.txt", "lib/backends/open_office/bridges/jodconverter-2.2.2/lib/commons-cli-1.2.jar", "lib/backends/open_office/bridges/jodconverter-2.2.2/lib/commons-io-1.4.jar", "lib/backends/open_office/bridges/jodconverter-2.2.2/lib/jodconverter-2.2.2.jar", "lib/backends/open_office/bridges/jodconverter-2.2.2/lib/jodconverter-cli-2.2.2.jar", "lib/backends/open_office/bridges/jodconverter-2.2.2/lib/juh-3.0.1.jar", "lib/backends/open_office/bridges/jodconverter-2.2.2/lib/jurt-3.0.1.jar", "lib/backends/open_office/bridges/jodconverter-2.2.2/lib/ridl-3.0.1.jar", "lib/backends/open_office/bridges/jodconverter-2.2.2/lib/slf4j-api-1.5.6.jar", "lib/backends/open_office/bridges/jodconverter-2.2.2/lib/slf4j-jdk14-1.5.6.jar", "lib/backends/open_office/bridges/jodconverter-2.2.2/lib/unoil-3.0.1.jar", "lib/backends/open_office/bridges/jodconverter-2.2.2/lib/xstream-1.3.1.jar", "lib/backends/open_office/bridges/jodconverter-2.2.2/src/jodconverter-2.2.2-sources.jar", "lib/backends/open_office/bridges/jodconverter-2.2.2/src/jodconverter-cli-2.2.2-sources.jar", "lib/backends/open_office/bridges/pyodconverter.py", "lib/backends/open_office/server.rb", "lib/backends/pdf_tools.rb", "lib/documentalist.rb", "lib/tasks/tasks.rb"]
+  s.files = ["README.rdoc", "Rakefile", "config/default.yml", "documentalist.gemspec", "init.rb", "lib/backends/net_pbm.rb", "lib/backends/odf_merge.rb", "lib/backends/open_office.rb", "lib/backends/open_office/bridges/jodconverter-2.2.2/ChangeLog.txt", "lib/backends/open_office/bridges/jodconverter-2.2.2/LICENSE.txt", "lib/backends/open_office/bridges/jodconverter-2.2.2/README.txt", "lib/backends/open_office/bridges/jodconverter-2.2.2/docs/jodconverter-2.2.2-javadoc.jar", "lib/backends/open_office/bridges/jodconverter-2.2.2/docs/third-party-licenses/license-commons-io.txt", "lib/backends/open_office/bridges/jodconverter-2.2.2/docs/third-party-licenses/license-openoffice.org.txt", "lib/backends/open_office/bridges/jodconverter-2.2.2/docs/third-party-licenses/license-slf4j.txt", "lib/backends/open_office/bridges/jodconverter-2.2.2/docs/third-party-licenses/license-xstream.txt", "lib/backends/open_office/bridges/jodconverter-2.2.2/document-formats.xml", "lib/backends/open_office/bridges/jodconverter-2.2.2/lib/DEPENDENCIES.txt", "lib/backends/open_office/bridges/jodconverter-2.2.2/lib/commons-cli-1.2.jar", "lib/backends/open_office/bridges/jodconverter-2.2.2/lib/commons-io-1.4.jar", "lib/backends/open_office/bridges/jodconverter-2.2.2/lib/jodconverter-2.2.2.jar", "lib/backends/open_office/bridges/jodconverter-2.2.2/lib/jodconverter-cli-2.2.2.jar", "lib/backends/open_office/bridges/jodconverter-2.2.2/lib/juh-3.0.1.jar", "lib/backends/open_office/bridges/jodconverter-2.2.2/lib/jurt-3.0.1.jar", "lib/backends/open_office/bridges/jodconverter-2.2.2/lib/ridl-3.0.1.jar", "lib/backends/open_office/bridges/jodconverter-2.2.2/lib/slf4j-api-1.5.6.jar", "lib/backends/open_office/bridges/jodconverter-2.2.2/lib/slf4j-jdk14-1.5.6.jar", "lib/backends/open_office/bridges/jodconverter-2.2.2/lib/unoil-3.0.1.jar", "lib/backends/open_office/bridges/jodconverter-2.2.2/lib/xstream-1.3.1.jar", "lib/backends/open_office/bridges/jodconverter-2.2.2/src/jodconverter-2.2.2-sources.jar", "lib/backends/open_office/bridges/jodconverter-2.2.2/src/jodconverter-cli-2.2.2-sources.jar", "lib/backends/open_office/bridges/pyodconverter.py", "lib/backends/open_office/server.rb", "lib/backends/pdf_tools.rb", "lib/documentalist.rb", "lib/tasks/tasks.rb", "rails/config/documentalist.yml.tpl", "rails/init.rb", "rails/initialize_configuration.rb", "test/documentalist_test.rb", "test/fixtures/fixture_001.odt", "test/net_pbm_test.rb", "test/odf_merge_test.rb", "test/open_office_test.rb", "test/pdf_tools_test.rb", "test/rails_integration_test.rb", "test/test_helper.rb", "Manifest"]
+  s.homepage = %q{http://github.com/davout/documentalist}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Documentalist", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{documentalist}
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{The smooth document management experience, usable as a Rails gem plugin or standalone in any ruby application}
+  s.test_files = ["test/open_office_test.rb", "test/odf_merge_test.rb", "test/documentalist_test.rb", "test/rails_integration_test.rb", "test/test_helper.rb", "test/pdf_tools_test.rb", "test/net_pbm_test.rb"]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<zip>, [">= 2.0.2"])
+      s.add_runtime_dependency(%q<SystemTimer>, [">= 1.2"])
+      s.add_development_dependency(%q<flexmock>, [">= 0.8.6"])
+    else
+      s.add_dependency(%q<zip>, [">= 2.0.2"])
+      s.add_dependency(%q<SystemTimer>, [">= 1.2"])
+      s.add_dependency(%q<flexmock>, [">= 0.8.6"])
+    end
+  else
+    s.add_dependency(%q<zip>, [">= 2.0.2"])
+    s.add_dependency(%q<SystemTimer>, [">= 1.2"])
+    s.add_dependency(%q<flexmock>, [">= 0.8.6"])
+  end
+end

data/lib/backends/net_pbm.rb

@@ -0,0 +1,10 @@
+# To change this template, choose Tools | Templates
+# and open the template in the editor.
+
+module Documentalist
+  module NetPBM
+    def convert
+      system("cd #{temp_dir} && ppmtojpeg #{ppm_image} > #{ppm_image.gsub(/ppm$/, "jpg")}")
+    end
+  end
+end

data/lib/backends/odf_merge.rb

@@ -0,0 +1,64 @@
+require 'erb'
+require 'tmpdir'
+require 'zip/zip'
+
+module Documentalist
+  # Merge an ODF document with an arbitrary hash of data
+  def self.odf_merge(template, options = {})
+    ODFMerge.merge_template(template, options)
+  end
+
+  # This module provides open document merge functionality
+  module ODFMerge
+    def self.merge_string(string, options = {})
+      locals = options[:locals]
+
+      if locals and locals.is_a? Hash
+        locals.each do |k,v|
+          instance_variable_set("@#{k.to_s}".to_sym, v)
+        end
+      end
+
+      ERB.new(string).result(binding)
+    end
+
+    def self.get_contents(odt_file)
+      contents = String.new
+      Zip::ZipFile.open(odt_file) { |zip| contents = zip.read("content.xml") }
+      contents.gsub("&lt;%", "<%").gsub("%&gt;", "%>")
+    end
+
+    def self.merge_template(template, options = {})
+      # Get template contents
+      tmp_contents= Tempfile.new("officer-contents")
+      tmp_contents.write(merge_string(get_contents(template), :locals => options[:locals]))
+      tmp_contents.close
+
+      # Copy the template so we can merge the data into the copy
+      tmp_merged_template = File.join(Dir.tmpdir, "merged-template-#{rand(10**9)}#{File.extname(template)}")
+      FileUtils.cp(template, tmp_merged_template)
+
+      # Stuff the merged contents.xml into the OpenDocument zip
+      Zip::ZipFile.open(tmp_merged_template) do |zip|
+        zip.replace("content.xml", tmp_contents.path)
+        zip.commit
+      end
+
+      # Remove the merged contents.xml
+      tmp_contents.unlink
+
+      # Manages the converted file depending on the context
+      if options[:to]
+        if File.extname(options[:to]) == File.extname(template)
+          FileUtils.mv(tmp_merged_template, options[:to])
+        else
+          Documentalist.convert(tmp_merged_template, :to => options[:to])
+          FileUtils.rm(tmp_merged_template)
+        end
+      else
+        FileUtils.rm(template)
+        FileUtils.mv(tmp_merged_template, template)
+      end
+    end
+  end
+end

data/lib/backends/open_office.rb

@@ -0,0 +1,108 @@
+module Documentalist
+  module OpenOffice
+    # Converts documents
+    def self.convert(origin, options)
+      # See how to make OpenOffice startup as smooth as possible and not on first conversion
+      # OO auto-start option if in Rails app ?
+      Server.ensure_available
+
+      Documentalist.timeout(Documentalist.config[:open_office][:max_conversion_time], :attempts => Documentalist.config[:open_office][:max_conversion_attempts]) do
+        if Documentalist.config[:open_office][:bridge] == 'JOD'
+          # TODO : manage multi ooo instances : http://code.google.com/p/jodconverter/wiki/GettingStarted
+          
+          system("#{Documentalist.config[:java][:path]} -jar #{File.join(File.dirname(__FILE__), %w{open_office bridges jodconverter-2.2.2 lib jodconverter-cli-2.2.2.jar})} #{origin} #{options[:to]}")
+        elsif Documentalist.config[:open_office][:bridge] == 'PYOD'
+          system("#{Documentalist.config[:python][:path]} #{File.join(File.dirname(__FILE__), %w{open_office bridges pyodconverter.py})} #{origin} #{options[:to]}")
+        end
+
+        self.convert_txt_to_utf8(options[:to]) if options[:to_format] == :txt
+        
+        options[:to]
+      end
+    end
+
+    # HACK : convert ISO-8859-1 files back to UTF-8 when OpenOffice messes up and
+    # outputs the wrong encoding
+    def self.convert_txt_to_utf8(file_path)
+      if `file #{file_path}` =~ /ISO/
+        system("iconv --from-code ISO-8859-1 --to-code UTF-8 #{file_path} > tmp_iconv.txt && mv tmp_iconv.txt #{file_path}")
+      end
+    end
+
+    module Server
+      # Is OpenOffice server running?
+      def self.running?
+        !`pgrep soffice`.empty?
+      end
+
+      # Restart if running or start new instance
+      def self.restart!
+        (kill! if running?) and start!
+      end
+
+      # Start new instance
+      def self.start!
+        raise "Already running!" if running?
+
+        log_path = Documentalist.config[:log_file] || "/dev/null"
+
+        command_line = "#{Documentalist.config[:open_office][:path]} -headless -accept=\"socket,host=127.0.0.1,port=8100\;urp\;\" -nofirststartwizard -nologo -nocrashreport -norestore -nolockcheck -nodefault"
+        command_line << " >> #{log_path} 2>&1"
+        command_line << " &"
+
+        system(command_line)
+        
+        begin
+          Documentalist.timeout(Documentalist.config[:open_office][:max_startup_time]) do
+            while !running?
+              # Do nothing
+            end
+          end
+        rescue Timeout::Error
+          raise "OpenOffice didn't start fast enough, you might want to increase the max_startup_time value or check your OpenOffice configuration"
+        end
+
+        # OpenOffice needs some time to fully wake up
+        sleep(Documentalist.config[:open_office][:wakeup_time])
+        nil
+      end
+
+      # Kill running instance
+      def self.kill!
+        raise "Not running!" unless running?
+
+        begin
+          Documentalist.timeout(3) do
+            while(running?)
+              system("pkill -9 office")
+            end
+          end
+        rescue Timeout::Error
+          raise "Mayday, mayday ! Could not kill OpenOffice !!"
+        ensure
+          # Remove user profile
+          system("rm -rf ~/openoffice.org*")
+        end
+      end
+
+      # Is the current instance stuck ?
+      def self.stalled?
+        if running?
+          cpu_usage = `ps -Ao pcpu,pid,comm | grep soffice | grep [#{pids.collect{|pid| '\('+pid.to_s+'\)'}}]`.split(/\n/)
+          cpu_usage.any? { |usage| /^\s*\d+/.match(usage)[0].strip.to_i > Documentalist.config[:open_office][:max_cpu] }
+        end
+      end
+
+      # Make sure there will be an available instance
+      def self.ensure_available
+        start! unless running?
+        restart! if stalled?
+      end
+
+      # Get OO processes pids
+      def self.pids
+        `pgrep soffice`.split.map(&:to_i) unless `pgrep soffice`.empty?
+      end
+    end
+  end
+end

data/lib/backends/open_office/bridges/jodconverter-2.2.2/ChangeLog.txt

@@ -0,0 +1,119 @@
+JODConverter 2.2.2
+------------------
+
+ * added docx, xlsx, and pptx (supported by OOo since v3.0) to default formats
+
+ * updated plain text format to use UTF8,CRLF as default options
+
+ * added switch to pass a custom xml document format registry file to the command line tool
+
+JODConverter 2.2.1
+------------------
+
+** Improvement
+    * [JODC-12] - Provide more detailed 'conversion failed' error messages
+    * [JODC-24] - Add MediaWiki wikitext format
+    * [JODC-25] - Add configurable outputDir to Maven plugin
+    * [JODC-26] - Expose low level OOo services as public in OOoConnection
+
+** New Feature
+    * [JODC-6] - Maven plugin
+    * [JODC-27] - Add utility methods to retrieve OOo version and locale at runtime
+
+JODConverter 2.2.0
+------------------
+
+** Bug
+    * [JODC-14] - Incorrect Excel mime-type
+    * [JODC-16] - Failure when converting from .txt files with different line endings
+    * [JODC-18] - File extension should be treated as case insensitive
+
+** Improvement
+    * [JODC-5] - Add macro execution options
+    * [JODC-10] - Make XStream dependency optional
+    * [JODC-11] - Replace commons-logging with slf4j
+    * [JODC-17] - Add CSV to default formats
+    * [JODC-19] - Revise DocumentFormat exportOptions API
+    * [JODC-20] - Make document formats easily customisable in webapp
+    * [JODC-22] - Add DocumentFamily.DRAWING
+
+** New Feature
+    * [JODC-9] - IKVM compatibility to build as a .NET DLL
+    * [JODC-13] - Add support for converting multiple files at once in ConvertDocument command line tool
+
+** Task
+    * [JODC-21] - Split CLI into separate module
+
+JODConverter 2.1.1
+-------------------
+
+ * renamed project to JODConverter
+
+ * renamed packages from net.sf.jooreports to com.artofsolving.jodconverter
+
+ * updated OpenOffice.org JARs to 2.1.0
+
+JOOConverter 2.1.0
+-------------------
+
+ * added support for custom export options (e.g. Image Quality for PDFs)
+
+ * HTML as an input format is now enabled by default
+
+ * fixed a rare pagination bug when exporting to PDF a document with fields
+
+ * many internal code improvements: switched to Maven2-based build process
+   and directory layout, improved unit test coverage, refactorings
+
+JOOConverter 2.1rc2
+-------------------
+
+ * file-based conversions are the default again; stream-based conversions
+   introduced in 2.1rc1 proved to be frequently slower so they are still
+   available but as an option (using StreamOpenOfficeDocumentConverter)
+
+ * made the webapp settings configurable using Spring and XML
+ 
+ * added a sample C#.net web service client to the online guide
+
+JOOConverter 2.1rc1
+-------------------
+
+ * now all conversions pass UNO streams instead of files to OpenOffice.org
+   - no need to use temporary files anymore
+   - works with an OOo service running as a different user
+   - works with an OOo service running on a different machine
+
+ * added servlet that can be invoked as a simple "web service" by remote clients
+
+ * added WordPerfect as a supported input format (thanks to Derek Hulley of Alfresco)
+
+ * added isConnected() method to OpenOfficeConnection
+
+JOOConverter 2.0.0
+------------------
+
+ * added default constructor to DocumentFormat to prevent error with XStream on some JVMs
+
+ * compiled and tested with Java 1.3 (was 1.4)
+
+ * replaced custom IO code with Jakarta Commons IO
+
+ * updated third-party libraries to their latest available versions
+
+
+JOOConverter 2.0rc2
+-------------------
+
+Due to popular demand JOOConverter, while still being part of JOOReports, is now
+released as a standalone project (as it was already the case with the 1.0 series).
+
+Changes compared to the version included in JOOReports 2.0rc1
+
+ * added the converter web application
+
+ * made jar file executable with ConvertDocument as main class
+
+ * added (but unsupported) HTML and XHTML export formats
+
+ * minor bug fixes