X-Git-Url: https://git.njae.me.uk/?a=blobdiff_plain;f=Readme.md~;fp=Readme.md~;h=4ed0e6f95e874af6211e8cd9c2279e701617135f;hb=49dc03eafbc7aa52de0caa3b3c0d5b5f25ce311d;hp=0000000000000000000000000000000000000000;hpb=074ce0bade4a2e3ab2210624ba598cd5edd0bec8;p=porter2stemmer.git

diff --git a/Readme.md~ b/Readme.md~
new file mode 100644
index 0000000..4ed0e6f
--- /dev/null
+++ b/Readme.md~
@@ -0,0 +1,53 @@
+# coding: utf-8
+
+# ==The Porter 2 stemmer
+# This is the Porter 2 stemming algorithm, as described at 
+# http://snowball.tartarus.org/algorithms/english/stemmer.html
+# The original paper is:
+#
+# Porter, 1980, "An algorithm for suffix stripping", _Program_, Vol. 14,
+# no. 3, pp 130-137
+#
+# ==Features of this implementation
+# This stemmer is written in pure Ruby, making it easy to modify for language variants. 
+# For instance, the original Porter stemmer only works for American English and does
+# not recognise British English's '-ise' as an alternate spelling of '-ize'. This 
+# implementation has been extended to handle correctly British English.
+#
+# This stemmer also features a comprehensive test set of over 29,000 words, taken from the 
+# {Porter 2 stemmer website}[http://snowball.tartarus.org/algorithms/english/stemmer.html].
+#
+# ==Files
+# Constants for the stemmer are in the Porter2 module.
+#
+# Procedures that implement the stemmer are added to the String class.
+# 
+# The stemmer algorithm is implemented in the String#porter2_stem procedure.
+#
+# ==Internationalisation
+# There isn't much, as this is a stemmer that only works for English.
+#
+# The +gb_english+ flag to the various procedures allows the stemmer to treat the British 
+# English '-ise' the same as the American English '-ize'.
+#
+# ==Longest suffixes
+# Several places in the algorithm require matching the longest suffix of a word. The 
+# regexp engine in Ruby 1.9 seems to handle alterntives in regexps by finding the 
+# alternative that matches at the first position in the string. As we're only talking 
+# about suffixes, that first match is also the longest suffix. If the regexp engine changes,
+# this behaviour may change and break the stemmer.
+#
+# ==Usage
+# Call the String#porter2_stem or String#stem methods on a string to return its stem
+#  "consistency".stem       # => "consist"
+#  "knitting".stem          # => "knit"
+#  "articulated".stem       # => "articul"
+#  "nationalize".stem       # => "nation"
+#  "nationalise".stem       # => "nationalis"
+#  "nationalise".stem(true) # => "nation"
+#
+# ==Author
+# The Porter 2 stemming algorithm was developed by 
+# {Martin Porter}[http://snowball.tartarus.org/algorithms/english/stemmer.html]. 
+# This implementation is by {Neil Smith}[http://www.njae.me.uk].
+