From b61a4d91253d3b5b6ff9005b55587e3b95c3f201 Mon Sep 17 00:00:00 2001 From: wmorgan Date: Fri, 11 May 2007 21:20:02 +0000 Subject: [PATCH] moved problems and solutions all to FAQ git-svn-id: svn://rubyforge.org/var/svn/sup/trunk@397 5c8cc53c-5e98-4d25-b20a-d8db53a31250 --- README.txt | 18 +++--------------- doc/FAQ.txt | 33 ++++++++++++++++++++++++++++----- 2 files changed, 31 insertions(+), 20 deletions(-) diff --git a/README.txt b/README.txt index 748cb91..e37a728 100644 --- 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 f6cb2ca..efb3a5e 100644 --- a/doc/FAQ.txt +++ b/doc/FAQ.txt @@ -63,11 +63,6 @@ A: Run: sup-sync [+] --restored --restore where 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. + -- 2.45.2