README.markdown in undertexter-0.0.7 vs README.markdown in undertexter-0.1.0

@@ -31,9 +31,42 @@
     $ Undertexter.find("tt0840361", :language => :english).count
     => 48
     $ Undertexter.find("tt0840361", :language => :swedish).count
     => 8
 
+Download the subtitle to disk
+
+    $ Undertexter.find("tt0840361").first.download!
+    => "/tmp/The.Town.2010.EXTENDED.480p.BRRip.XviD-NYDIC.rar"
+    $ File.exists?("/tmp/The.Town.2010.EXTENDED.480p.BRRip.XviD-NYDIC.rar")
+    => true
+    
+You can also specify a destination folder to download the file, both relative and absolute
+    
+    $ Undertexter.find("tt0840361").first.download!(:to => /some/dir)
+    => "/some/dir/The.Town.2010.EXTENDED.480p.BRRip.XviD-NYDIC.rar"
+    
+    $ Dir.pwd
+    => /Users/linus/Downloads
+    $ Undertexter.find("tt0840361").first.download!(:to => 'my_dir')
+    => "/Users/linus/Downloads/my_dir/The.Town.2010.EXTENDED.480p.BRRip.XviD-NYDIC.rar"
+    
+Find the right subtitle based on the release name of the movie
+    
+    $ Undertexter.find("tt0840361").based_on("The Town EXTENDED 2010 480p BRRip XviD AC3 FLAWL3SS")
+    => #<Subtitle:0x00000101b739d0 @cds=1, @downloads=1644, @title="The.Town.EXTENDED.2010.480p.BRRip.XviD.AC3-FLAWL3SS", @details="http://www.undertexter.se/?p=undertext&id=23752", @movie_title="The Town", @language=:swedish>
+    
+Specify how sensitive the `based_on` method should be, where `0` is a perfect match and `1` is dont care. Default is 0.4
+    
+    $ Undertexter.find("tt0840361").based_on("The Town EXTENDED 2010 480p BRRip XviD AC3 FLAWL3SS", limit: 0)
+    => nil
+    
+    $ Undertexter.find("tt0840361").based_on("The Town EXTENDED 2010 480p BRRip XviD AC3 FLAWL3SS", limit: 0.4)
+    => #<Subtitle:0x00000101b8d808 @cds=1, @downloads=1644, @title="The.Town.EXTENDED.2010.480p.BRRip.XviD.AC3-FLAWL3SS", @details="http://www.undertexter.se/?p=undertext&id=23752", @movie_title="The Town", @language=:swedish>
+    
+    $ Undertexter.find("tt0840361").based_on("The.Town.EXTENDED.2010.480p.BRRip.XviD.AC3-FLAWL3SS", limit: 0.0)
+    => #<Subtitle:0x00000101b8d718 @cds=1, @downloads=1644, @title="The.Town.EXTENDED.2010.480p.BRRip.XviD.AC3-FLAWL3SS", @details="http://www.undertexter.se/?p=undertext&id=23752", @movie_title="The Town", @language=:swedish>
+    
 If no language option is being passed to find, it will fall back to swedish
 
 What is being returned from the find method?
 ===============
 
\ No newline at end of file