ruby-stemmer 0.9.3-x86-mswin32-60

data/MIT-LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2008-2011 Aurelian Oancea
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+

data/README.rdoc

@@ -0,0 +1,113 @@
+= Ruby-Stemmer {Project Status}[http://stillmaintained.com/aurelian/ruby-stemmer.png]
+
+Ruby-Stemmer exposes SnowBall API to Ruby.
+
+This package includes libstemmer_c library released under BSD licence 
+and available for free {here}[http://snowball.tartarus.org/dist/libstemmer_c.tgz].
+
+Support for latin language is also included and it has been generated with the snowball compiler using 
+{schinke contribution}[http://snowball.tartarus.org/otherapps/schinke/intro.html].
+
+For more details about libstemmer_c please visit the {SnowBall website}[http://snowball.tartarus.org].
+
+== Usage
+
+  require 'rubygems'
+  require 'lingua/stemmer'
+
+  stemmer= Lingua::Stemmer.new(:language => "ro")
+  stemmer.stem("netăgăduit") #=> netăgădu
+
+=== Alternative
+
+  require 'rubygems'
+  require 'lingua/stemmer'
+
+  Lingua.stemmer( %w(incontestabil neîndoielnic), :language => "ro" ) #=> ["incontest", "neîndoieln"]
+  Lingua.stemmer("installation") #=> "instal"
+  Lingua.stemmer("installation", :language => "fr", :encoding => "ISO_8859_1") do | word |
+    puts "~> #{word}" #=> "instal"
+  end # => #<Lingua::Stemmer:0x102501e48>
+
+=== Rails
+  
+  # Rails2: -- config/environment.rb:
+  config.gem 'ruby-stemmer', :version => '>=0.6.2', :lib => 'lingua/stemmer'
+  
+  # Rails3: -- Gemfile
+  gem 'ruby-stemmer', '>=0.8.3', :require => 'lingua/stemmer'
+
+=== More details 
+
+* Complete API in {RDoc format}[http://rdoc.info/github/aurelian/ruby-stemmer/master/frames]
+* More usage on the {test file}[http://github.com/aurelian/ruby-stemmer/blob/master/test/lingua/test_stemmer.rb]
+
+== Install
+
+=== Standard install with:
+
+ gem install ruby-stemmer
+
+==== Windows
+
+There's also a Windows (Fat bin) compiled against ruby 1.9.3 and ruby 1.8.7.
+
+ gem install ruby-stemmer --platform=x86-mswin32
+
+{It's known}[http://cl.ly/BX9o] to work under Windows XP.
+
+=== Development version
+
+  $ git clone git://github.com/aurelian/ruby-stemmer.git
+  $ cd ruby-stemmer
+  $ rake -T #<== see what we've got
+  $ rake compile #<== builds the extension do'h
+  $ rake test
+
+== NOT A BUG
+
+The stemming process is an algorithm to allow one to find the stem of an word (not the root of it).
+For further reference on stem vs. root, please check wikipedia articles on the topic:
+
+* http://en.wikipedia.org/wiki/Stem_%28linguistics%29
+* http://en.wikipedia.org/wiki/Root_%28linguistics%29
+
+== TODO
+
+* {Open issues}[http://github.com/aurelian/ruby-stemmer/issues]
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project from {github}[http://github.com/aurelian/ruby-stemmer]
+* Make your feature addition or {bug fix}[http://github.com/aurelian/ruby-stemmer/issues]
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+
+  if you want to have your own version, that is fine but
+  bump version in a commit by itself I can ignore when I pull
+* Send me a pull request. Bonus points for topic branches.
+
+== Alternative Stemmers for Ruby
+
+* {stemmer4r}[http://rubyforge.org/projects/stemmer4r] (ext)
+* {fast-stemmer}[http://github.com/romanbsd/fast-stemmer] (ext)
+* {uea-stemmer}[http://github.com/ealdent/uea-stemmer] (ext)
+* {stemmer}[http://rubyforge.org/projects/stemmer] (pure ruby)
+* add yours
+
+== Copyright
+
+Copyright (c) 2008-2011 {Aurelian Oancea}[http://locknet.ro]. See MIT-LICENSE for details.
+
+== Contributors
+
+* {Aurelian Oancea}[https://github.com/aurelian]
+* {Yury Korolev}[https://github.com/yury] - various bug fixes
+* {Aaron Patterson}[https://github.com/tenderlove] - rake compiler (windows support), code cleanup
+* {Damián Silvani}[https://github.com/munshkr] - Ruby 1.9 encoding
+
+== Real life usage
+* http://planet33.ru is using Ruby-Stemmer together with {Classifier}[http://github.com/yury/classifier] to automatically rate places based on users comments.
+
+# encoding: utf-8

data/Rakefile

@@ -0,0 +1,70 @@
+require 'rubygems'
+require 'rake'
+
+gem 'rake-compiler', '~>0.7'
+require 'rake/extensiontask'
+
+require 'jeweler'
+$jeweler = Jeweler::Tasks.new do |gem|
+  gem.name = "ruby-stemmer"
+  gem.version = File.read(File.expand_path(File.join(File.dirname(__FILE__),"VERSION"))).strip!
+  gem.summary = %Q{Expose libstemmer_c to Ruby.}
+  gem.description = %Q{Expose the bundled libstemmer_c library to Ruby.}
+  gem.email = "oancea@gmail.com"
+  gem.homepage = "http://github.com/aurelian/ruby-stemmer"
+  gem.authors = ["Aurelian Oancea", "Yury Korolev"]
+  gem.extensions = ["ext/lingua/extconf.rb"]
+  gem.rubyforge_project = "ruby-stemmer"
+  gem.files = FileList['lib/**/*.rb', 'README.rdoc', 'MIT-LICENSE', 'VERSION', 'Rakefile', 'libstemmer_c/**/*', 'ext/**/*', 'test/**/*']
+  %w(ext/lingua/*.so ext/lingua/*.bundle ext/lingua/Makefile ext/lingua/mkmf.log ext/lingua/*.o libstemmer_c/**/*.o libstemmer_c/stemwords).each do | f |
+    gem.files.exclude f
+  end
+end
+
+Jeweler::GemcutterTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/test_*.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: gem install rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+CLOBBER.include("libstemmer_c/**/*.o")
+
+Rake::ExtensionTask.new('ruby-stemmer', $jeweler.jeweler.gemspec) do |ext|
+  ext.lib_dir = File.join(*['lib', 'lingua', ENV['FAT_DIR']].compact)
+  ext.ext_dir = File.join 'ext', 'lingua'
+  ext.cross_compile = true
+  ext.cross_platform = ['i386-mswin32-60', 'i386-mingw32']
+  ext.name    = 'stemmer_native'
+end
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.options << '--charset' << 'utf-8'
+  rdoc.title = "Ruby-Stemmer #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+  rdoc.rdoc_files.include('ext/lingua/stemmer.c')
+  rdoc.rdoc_files.include('MIT-LICENSE')
+end

data/VERSION

@@ -0,0 +1 @@
+0.9.3

data/ext/lingua/extconf.rb

@@ -0,0 +1,40 @@
+ENV['RC_ARCHS'] = '' if RUBY_PLATFORM =~ /darwin/
+require "mkmf"
+
+ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..', '..'))
+LIBSTEMMER = File.join(ROOT, 'libstemmer_c')
+
+# build libstemmer_c
+# FreeBSD make is gmake
+make= (RUBY_PLATFORM =~ /freebsd/)? 'gmake' : 'make'
+
+# MacOS architecture mess up
+if RUBY_PLATFORM =~ /darwin/
+  # see: #issue/3, #issue/5
+  begin
+    ENV['ARCHFLAGS']= "-arch " + %x[file #{File.expand_path(File.join(Config::CONFIG['bindir'], Config::CONFIG['RUBY_INSTALL_NAME']))}].strip!.match(/executable (.+)$/)[1] unless ENV['ARCHFLAGS'].nil?
+  rescue
+    $stderr << "Failed to get your ruby executable architecture.\n"
+    $stderr << "Please specify one using $ARCHFLAGS environment variable.\n"
+    exit
+  end
+  # see: #issue/9, #issue/6
+  # see: man compat
+  if ENV['COMMAND_MODE'] == 'legacy'
+    $stdout << "Setting compat mode to unix2003\n."
+    ENV['COMMAND_MODE']= 'unix2003'
+  end
+end
+
+# make libstemmer_c. unless we're cross-compiling.
+unless RUBY_PLATFORM =~ /i386-mingw32/
+  system "cd #{LIBSTEMMER}; #{make} libstemmer.o; cd #{ROOT};"
+  exit unless $? == 0
+end
+
+$CFLAGS  += " -I#{File.expand_path(File.join(LIBSTEMMER, 'include'))} "
+$libs    += " -L#{LIBSTEMMER} #{File.expand_path(File.join(LIBSTEMMER, 'libstemmer.o'))} "
+
+if have_header("libstemmer.h")
+  create_makefile("lingua/stemmer_native")
+end

data/ext/lingua/stemmer.c

@@ -0,0 +1,115 @@
+#include "ruby.h"
+#include <libstemmer.h>
+
+
+#ifdef HAVE_RUBY_ENCODING_H
+
+#include <ruby/encoding.h>
+
+#define ENCODED_STR_NEW2(str, encoding) \
+  ({ \
+   VALUE _string = rb_str_new2((const char *)str); \
+   int _enc = rb_enc_get_index(encoding); \
+   rb_enc_associate_index(_string, _enc); \
+   _string; \
+   })
+
+#else
+
+#define ENCODED_STR_NEW2(str, encoding) \
+  rb_str_new2((const char *)str)
+
+#endif
+
+
+VALUE rb_mLingua;
+VALUE rb_cStemmer;
+VALUE rb_eStemmerError;
+
+/*
+ * Document-method: new
+ * call-seq: Lingua::Stemmer.new
+ *
+ * Creates a new Stemmer, pass <tt>:language</tt> and <tt>:encoding</tt> as arguments 
+ * to change encoding or language, otherwise english with UTF_8 will be used
+ *   
+ *   require 'lingua/stemmer'
+ *   s = Lingua::Stemmer.new :language => 'fr'
+ */ 
+static VALUE 
+rb_stemmer_init(VALUE self, VALUE rlang, VALUE renc) { 
+  struct sb_stemmer * stemmer;
+
+  Data_Get_Struct(self, struct sb_stemmer, stemmer);
+
+  // In case someone sends() this method, free up the old one
+  if(stemmer) sb_stemmer_delete(stemmer);
+
+  stemmer = sb_stemmer_new( RSTRING_PTR(rlang), RSTRING_PTR(renc) );
+  if (!stemmer) {
+    if (!RTEST(renc)) {
+      rb_raise(rb_eStemmerError,
+          "Language %s not available for stemming", RSTRING_PTR(rlang));
+    } else {
+      rb_raise(rb_eStemmerError,
+          "Language %s not available for stemming in encoding %s", 
+                    RSTRING_PTR(rlang), RSTRING_PTR(renc));
+    }
+  }
+  
+  DATA_PTR(self) = stemmer;
+
+  return self;
+}
+
+/*
+ * Document-method: stem
+ * call-seq: stem
+ *
+ * Stems a word
+ *   
+ *   require 'lingua/stemmer'
+ *   s = Lingua::Stemmer.new
+ *   s.stem "installation" # ==> install
+ */ 
+static VALUE
+rb_stemmer_stem(VALUE self, VALUE word) {
+  struct sb_stemmer * stemmer;
+
+  Data_Get_Struct(self, struct sb_stemmer, stemmer);
+  if(!stemmer) rb_raise(rb_eRuntimeError, "Stemmer is not initialized");
+
+  VALUE s_word = rb_String(word);
+  const sb_symbol * stemmed = sb_stemmer_stem(stemmer,
+      (sb_symbol *)RSTRING_PTR(s_word),
+      RSTRING_LEN(s_word)
+  );
+
+  VALUE rb_enc = rb_iv_get(self, "@encoding");
+  return ENCODED_STR_NEW2((char *)stemmed, rb_enc);
+}
+
+static void
+sb_stemmer_free(struct sb_stemmer * stemmer)
+{
+  if(stemmer) sb_stemmer_delete(stemmer);
+}
+
+static VALUE
+sb_stemmer_alloc(VALUE klass)
+{
+  return Data_Wrap_Struct(klass, 0, sb_stemmer_free, 0);
+}
+
+/*
+ * Ruby-Stemmer, Ruby extension to SnowBall API using libstemmer_c
+ */
+void Init_stemmer_native() {
+  rb_mLingua = rb_define_module("Lingua");
+  rb_cStemmer = rb_define_class_under(rb_mLingua, "Stemmer", rb_cObject);
+  rb_define_alloc_func(rb_cStemmer, sb_stemmer_alloc);
+  rb_eStemmerError = rb_define_class_under(rb_mLingua, "StemmerError", rb_eException);
+  rb_define_private_method(rb_cStemmer, "native_init", rb_stemmer_init, 2);
+  rb_define_method(rb_cStemmer, "stem", rb_stemmer_stem, 1);
+}
+

data/lib/lingua/stemmer.rb

@@ -0,0 +1,60 @@
+if RUBY_PLATFORM =~/(mswin|mingw)/i
+  require "lingua/#{RUBY_VERSION.sub(/\.\d+$/, '')}/stemmer_native"
+else
+  require 'lingua/stemmer_native'
+end
+
+module Lingua
+  def self.stemmer(o, options={})
+    stemmer = Stemmer.new(options)
+
+    words = Array(o).map { |e| e.to_s }
+
+    results = []
+    words.each do |word|
+      result = stemmer.stem(word)
+      if block_given?
+        yield result
+      else
+        results << result
+      end
+    end
+
+    return stemmer if block_given?
+    results.length == 1 ? results[0] : results
+  end
+
+  class Stemmer
+    VERSION = File.read(File.expand_path(File.join(File.dirname(__FILE__), "..", "..", "VERSION"))).strip!
+
+    attr_reader :language
+    attr_reader :encoding
+
+    # Creates a new Stemmer, pass <tt>:language</tt> and <tt>:encoding</tt>
+    # as arguments to change encoding or language, otherwise english with UTF_8
+    # will be used
+    #
+    #   require 'lingua/stemmer'
+    #   s = Lingua::Stemmer.new :language => 'fr'
+    #
+    def initialize(options={})
+      @language = (options[:language] || 'en').to_s
+      @encoding = (options[:encoding] || 'UTF_8').to_s
+
+      if RUBY_VERSION >= "1.9"
+        if not @encoding.is_a?(Encoding)
+          @encoding = Encoding.find(@encoding.gsub("_", "-"))
+        end
+      else
+        @encoding = @encoding.upcase.gsub("-", "_")
+      end
+
+      native_init(@language, native_encoding(@encoding))
+    end
+
+  private
+    def native_encoding(enc)
+      RUBY_VERSION >= "1.9" ? enc.name.gsub('-', '_') : enc
+    end
+  end
+end

data/libstemmer_c/MANIFEST

@@ -0,0 +1,72 @@
+README
+src_c/stem_ISO_8859_1_danish.c
+src_c/stem_ISO_8859_1_danish.h
+src_c/stem_ISO_8859_1_dutch.c
+src_c/stem_ISO_8859_1_dutch.h
+src_c/stem_ISO_8859_1_english.c
+src_c/stem_ISO_8859_1_english.h
+src_c/stem_ISO_8859_1_finnish.c
+src_c/stem_ISO_8859_1_finnish.h
+src_c/stem_ISO_8859_1_french.c
+src_c/stem_ISO_8859_1_french.h
+src_c/stem_ISO_8859_1_german.c
+src_c/stem_ISO_8859_1_german.h
+src_c/stem_ISO_8859_1_hungarian.c
+src_c/stem_ISO_8859_1_hungarian.h
+src_c/stem_ISO_8859_1_italian.c
+src_c/stem_ISO_8859_1_italian.h
+src_c/stem_ISO_8859_1_norwegian.c
+src_c/stem_ISO_8859_1_norwegian.h
+src_c/stem_ISO_8859_1_porter.c
+src_c/stem_ISO_8859_1_porter.h
+src_c/stem_ISO_8859_1_portuguese.c
+src_c/stem_ISO_8859_1_portuguese.h
+src_c/stem_ISO_8859_1_spanish.c
+src_c/stem_ISO_8859_1_spanish.h
+src_c/stem_ISO_8859_1_swedish.c
+src_c/stem_ISO_8859_1_swedish.h
+src_c/stem_ISO_8859_2_romanian.c
+src_c/stem_ISO_8859_2_romanian.h
+src_c/stem_KOI8_R_russian.c
+src_c/stem_KOI8_R_russian.h
+src_c/stem_UTF_8_danish.c
+src_c/stem_UTF_8_danish.h
+src_c/stem_UTF_8_dutch.c
+src_c/stem_UTF_8_dutch.h
+src_c/stem_UTF_8_english.c
+src_c/stem_UTF_8_english.h
+src_c/stem_UTF_8_finnish.c
+src_c/stem_UTF_8_finnish.h
+src_c/stem_UTF_8_french.c
+src_c/stem_UTF_8_french.h
+src_c/stem_UTF_8_german.c
+src_c/stem_UTF_8_german.h
+src_c/stem_UTF_8_hungarian.c
+src_c/stem_UTF_8_hungarian.h
+src_c/stem_UTF_8_italian.c
+src_c/stem_UTF_8_italian.h
+src_c/stem_UTF_8_norwegian.c
+src_c/stem_UTF_8_norwegian.h
+src_c/stem_UTF_8_porter.c
+src_c/stem_UTF_8_porter.h
+src_c/stem_UTF_8_portuguese.c
+src_c/stem_UTF_8_portuguese.h
+src_c/stem_UTF_8_romanian.c
+src_c/stem_UTF_8_romanian.h
+src_c/stem_UTF_8_russian.c
+src_c/stem_UTF_8_russian.h
+src_c/stem_UTF_8_spanish.c
+src_c/stem_UTF_8_spanish.h
+src_c/stem_UTF_8_swedish.c
+src_c/stem_UTF_8_swedish.h
+src_c/stem_UTF_8_turkish.c
+src_c/stem_UTF_8_turkish.h
+runtime/api.c
+runtime/api.h
+runtime/header.h
+runtime/utilities.c
+libstemmer/libstemmer.c
+libstemmer/libstemmer_utf8.c
+libstemmer/modules.h
+libstemmer/modules_utf8.h
+include/libstemmer.h

data/libstemmer_c/Makefile

@@ -0,0 +1,9 @@
+include mkinc.mak
+CFLAGS=-Iinclude -fPIC $(ARCHFLAGS)
+all: libstemmer.o stemwords
+libstemmer.o: $(snowball_sources:.c=.o)
+	$(AR) -cru $@ $^
+stemwords: examples/stemwords.o libstemmer.o
+	$(CC) -o $@ $^
+clean:
+	rm -f stemwords *.o src_c/*.o runtime/*.o libstemmer/*.o

data/libstemmer_c/Makefile.windows

@@ -0,0 +1,15 @@
+include mkinc.mak
+
+AR=i686-w64-mingw32-ar
+CC=i686-w64-mingw32-gcc
+LD=i686-w64-mingw32-ld
+
+CFLAGS=-Iinclude
+
+all: libstemmer.o stemwords
+libstemmer.o: $(snowball_sources:.c=.o)
+	$(AR) -cru $@ $^
+stemwords: examples/stemwords.o libstemmer.o
+	$(CC) -o $@ $^
+clean:
+	rm -f stemwords *.o src_c/*.o runtime/*.o libstemmer/*.o

data/libstemmer_c/README

@@ -0,0 +1,125 @@
+libstemmer_c
+============
+
+This document pertains to the C version of the libstemmer distribution,
+available for download from:
+
+http://snowball.tartarus.org/dist/libstemmer_c.tgz
+
+
+Compiling the library
+=====================
+
+A simple makefile is provided for Unix style systems.  On such systems, it
+should be possible simply to run "make", and the file "libstemmer.o"
+and the example program "stemwords" will be generated.
+
+If this doesn't work on your system, you need to write your own build
+system (or call the compiler directly).  The files to compile are
+all contained in the "libstemmer", "runtime" and "src_c" directories,
+and the public header file is contained in the "include" directory.
+
+The library comes in two flavours; UTF-8 only, and UTF-8 plus other character
+sets.  To use the utf-8 only flavour, compile "libstemmer_utf8.c" instead of
+"libstemmer.c".
+
+For convenience "mkinc.mak" is a makefile fragment listing the source files and
+header files used to compile the standard version of the library.
+"mkinc_utf8.mak" is a comparable makefile fragment listing just the source
+files for the UTF-8 only version of the library.
+
+
+Using the library
+=================
+
+The library provides a simple C API.  Essentially, a new stemmer can
+be obtained by using "sb_stemmer_new".  "sb_stemmer_stem" is then
+used to stem a word, "sb_stemmer_length" returns the stemmed
+length of the last word processed, and "sb_stemmer_delete" is
+used to delete a stemmer.
+
+Creating a stemmer is a relatively expensive operation - the expected
+usage pattern is that a new stemmer is created when needed, used
+to stem many words, and deleted after some time.
+
+Stemmers are re-entrant, but not threadsafe.  In other words, if
+you wish to access the same stemmer object from multiple threads,
+you must ensure that all access is protected by a mutex or similar
+device.
+
+libstemmer does not currently incorporate any mechanism for caching the results
+of stemming operations.  Such caching can greatly increase the performance of a
+stemmer under certain situations, so suitable patches will be considered for
+inclusion.
+
+The standard libstemmer sources contain an algorithm for each of the supported
+languages.  The algorithm may be selected using the english name of the
+language, or using the 2 or 3 letter ISO 639 language codes.  In addition,
+the traditional "Porter" stemming algorithm for english is included for
+backwards compatibility purposes, but we recommend use of the "English"
+stemmer in preference for new projects.
+
+(Some minor algorithms which are included only as curiosities in the snowball
+website, such as the Lovins stemmer and the Kraaij Pohlmann stemmer, are not
+included in the standard libstemmer sources.  These are not really supported by
+the snowball project, but it would be possible to compile a modified libstemmer
+library containing these if desired.)
+
+
+The stemwords example
+=====================
+
+The stemwords example program allows you to run any of the stemmers
+compiled into the libstemmer library on a sample vocabulary.  For
+details on how to use it, run it with the "-h" command line option.
+
+
+Using the library in a larger system
+====================================
+
+If you are incorporating the library into the build system of a larger
+program, I recommend copying the unpacked tarball without modification into
+a subdirectory of the sources of your program.  Future versions of the
+library are intended to keep the same structure, so this will keep the
+work required to move to a new version of the library to a minimum.
+
+As an additional convenience, the list of source and header files used
+in the library is detailed in mkinc.mak - a file which is in a suitable
+format for inclusion by a Makefile.  By including this file in your build
+system, you can link the snowball system into your program with a few
+extra rules.
+
+Using the library in a system using GNU autotools
+=================================================
+
+The libstemmer_c library can be integrated into a larger system which uses the
+GNU autotool framework (and in particular, automake and autoconf) as follows:
+
+1) Unpack libstemmer_c.tgz in the top level project directory so that there is
+   a libstemmer_c subdirectory of the top level directory of the project.
+
+2) Add a file "Makefile.am" to the unpacked libstemmer_c folder, containing:
+   
+noinst_LTLIBRARIES = libstemmer.la
+include $(srcdir)/mkinc.mak
+noinst_HEADERS = $(snowball_headers)
+libstemmer_la_SOURCES = $(snowball_sources) 
+
+(You may also need to add other lines to this, for example, if you are using
+compiler options which are not compatible with compiling the libstemmer
+library.)
+
+3) Add libstemmer_c to the AC_CONFIG_FILES declaration in the project's
+   configure.ac file.
+
+4) Add to the top level makefile the following lines (or modify existing
+   assignments to these variables appropriately):
+
+AUTOMAKE_OPTIONS = subdir-objects
+AM_CPPFLAGS = -I$(top_srcdir)/libstemmer_c/include
+SUBDIRS=libstemmer_c
+<name>_LIBADD = libstemmer_c/libstemmer.la
+
+(Where <name> is the name of the library or executable which links against
+libstemmer.) 
+