moved problems and solutions all to FAQ

git-svn-id: svn://rubyforge.org/var/svn/sup/trunk@397 5c8cc53c-5e98-4d25-b20a-d8db53a31250

diff --git a/README.txt b/README.txt
index 748cb918937ba4166e874bc701d340a5b9ebf5ba..e37a7283e88984da54d794e87444254bf6821ad5 100644 (file)
--- a/README.txt
+++ b/README.txt
@@ -116,21 +116,9 @@ Current limitations which will be fixed:
 
 * gem install sup -y
 
-== KNOWN BUGS IN OTHER PACKAGES:
-
-* If you get an error about frozen strings in RubyMail when importing
-  certain messages with attachments, in rmail, change line 159 of
-  multipart.rb to:
-    chunk = chunk[0..start]
-  This is because RubyMail hasn't been updated since like Ruby 1.8.2.
-  Please bug Matt Lickey.
-* Occasionally Ferret produces something the Ruby GC doesn't like
-  (particularly when importing messages from very large sources).
-  No worries, just re-run sup-import. (This is unresolved atm.)
-* If you are using IMAP or Maildir and see this error:
-    /usr/local/lib/ruby/1.8/yaml.rb:133:in `transfer': allocator undefined for Bignum (TypeError)
-  then you need to upgrade to Ruby 1.8.5. YAML in earlier versions
-  can't parse BigNums.
+== PROBLEMS:
+
+See FAQ.txt for some common problems and their solutions.
 
 == LICENSE:
 

diff --git a/doc/FAQ.txt b/doc/FAQ.txt
index f6cb2ca5329bc8d25e1b030e09e72556ab12f0c6..efb3a5e573d89a9069993748c80646f5ba7cf6a4 100644 (file)
--- a/doc/FAQ.txt
+++ b/doc/FAQ.txt
@@ -63,11 +63,6 @@ A: Run:
      sup-sync [<source>+] --restored --restore <dumpfile>
    where <dumpfile> was created as above.
 
-Q: I see this message from Ferret:
-     Error occured in index.c:825 - sis_find_segments_file
-A: Yikes! You've upgraded Ferret and the index format changed beneath
-   you. Follow the index rebuild instructions below.
-
 Q: I upgraded Ferret and the index format changed. I need to
    completely rebuild my index. How do I do this?
 A: First, you'll need a complete state dump. If you haven't made
@@ -104,3 +99,31 @@ A: Sup is only possible through the hard work of Dave Balmain, the
    author of ferret, which is the search engine behind Sup. Ferret is
    really a first-class piece of software, and it's due to the
    tremendous amount of time and effort he's put in to it.
+
+Common Problems
+---------------
+
+P: I see this message from Ferret:
+     Error occured in index.c:825 - sis_find_segments_file
+S: Yikes! You've upgraded Ferret and the index format changed beneath
+   you. Follow the index rebuild instructions above.
+
+P: I get some error message from Rubymail about frozen strings when
+   importing messages with attachments.
+S: The current solution is to directly modify RubyMail. Change line 159 of
+   multipart.rb to:
+     chunk = chunk[0..start]
+   This is because RubyMail hasn't been updated since like Ruby 1.8.2.
+   Please bug Matt Lickey.
+
+P: I see this error:
+     /usr/local/lib/ruby/1.8/yaml.rb:133:in `transfer': allocator undefined for Bignum (TypeError)
+S: You need to upgrade to Ruby 1.8.5. YAML in earlier versions can't
+   parse BigNums, but Sup relies on that for Maildir and IMAP.
+
+P: I see this error:
+     /usr/lib/ruby/1.8/net/imap.rb:204: uninitialized constant Net::IMAP::SSL (NameError)
+S: You need to install a package called libssl-ruby or something similar.
+   Or, don't use imaps:// sources. Ruby's IMAP library otherwise fails in
+   this somewhat uninformative manner.
+