X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=README.txt;h=4204270a3091ef9510be29bf6886e04f7981a900;hb=refs%2Fheads%2Fnext;hp=b61fa4fef14b361c198aeeb18878deb895a43e04;hpb=65b5d758f3202872922e2973614a31937cfe93e8;p=sup diff --git a/README.txt b/README.txt index b61fa4f..4204270 100644 --- a/README.txt +++ b/README.txt @@ -4,30 +4,29 @@ sup == DESCRIPTION: -Sup is a console-based email client that combines the best -features of GMail, mutt, and emacs. Sup matches the power of GMail -with the speed and simplicity of a console interface. +Sup is a console-based email client for people with a lot of email. +It supports tagging, very fast full-text search, automatic contact- +list management, and more. If you're the type of person who treats +email as an extension of your long-term memory, Sup is for you. Sup makes it easy to: - Handle massive amounts of email. -- Mix email from different sources: mbox files (even across - different machines), IMAP folders, POP accounts, and GMail - accounts. +- Mix email from different sources: mbox files (even across different + machines), Maildir directories, IMAP folders, and GMail accounts. -- Instantaneously search over your entire email collection. Search - over body text, or use a query language to combine search - predicates in any way. +- Instantaneously search over your entire email collection. Search over + body text, or use a query language to combine search predicates in any + way. - Handle multiple accounts. Replying to email sent to a particular - account will use the correct SMTP server, signature, and from - address. + account will use the correct SMTP server, signature, and from address. -- Add custom code to handle certain types of messages or to handle - certain types of text within messages. +- Add custom code to customize Sup to whatever particular and bizarre + needs you may have. -- Organize email with user-defined labels, automatically track - recent contacts, and much more! +- Organize email with user-defined labels, automatically track recent + contacts, and much more! The goal of Sup is to become the email client of choice for nerds everywhere. @@ -40,98 +39,85 @@ Features: operability, regardless of how much amount of email you have. - Immediate full-text search of your entire email archive, using the - Ferret query langauge. Search over message bodies, labels, from: and + Ferret query language. Search over message bodies, labels, from: and to: fields, or any combination thereof. - Thread-centrism. Operations are performed at the thread, not the message level. Entire threads are manipulated and viewed (with redundancies removed) at a time. -- Labels instead of folders. Drop that tired old metaphor and you'll - see how much easier it is to organize email. +- Labels instead of folders. Drop that tired old metaphor and you'll see + how much easier it is to organize email. -- GMail-style thread management (but better!). Archive a thread, and - it will disappear from your inbox until someone replies. Kill a - thread, and it will never come back to your inbox (but will still - show up in searches.) Mark a thread as spam and you'll never again - see it unless explicitly searching for spam. +- GMail-style thread management. Archive a thread, and it will disappear + from your inbox until someone replies. Kill a thread, and it will + never come back to your inbox (but will still show up in searches.) + Mark a thread as spam and you'll never again see it unless explicitly + searching for spam. - Console based interface. No mouse clicking required! -- Programmability. It's in Ruby. The code is good. It's easy to - extend. +- Programmability. It's in Ruby. The code is good. It has an extensive + hook system that makes it easy to extend and customize. -- Multiple buffer support. Why be limited to viewing one thread at a +- Multiple buffer support. Why be limited to viewing one thing at a time? -- Tons of other little features, like automatic context-sensitive - help, multi-message operations, MIME attachment viewing, recent - contact list generation, etc. +- Tons of other little features, like automatic context-sensitive help, + multi-message operations, MIME attachment viewing, recent contact list + generation, etc. Current limitations which will be fixed: -- Support for mbox, remote mbox, and IMAP only at this point. No - support for POP, mh, or GMail mailstores. +- Sup doesn't play nicely with other mail clients. If you alter a mail + source (read, move, delete, etc) with another client Sup will punish + you with a lengthy reindexing process. -- No internationalization support. No wide characters, no subject - demangling. +- Support for mbox, Maildir, and IMAP only at this point. No support for + POP or mh. -- Unix-centrism in MIME attachment handling and in sendmail - invocation. +- IMAP support is very slow due mostly to Ruby's IMAP library. You may + consider something like offlineimap to mirror your IMAP folders with + local Maildir ones. -- Several obvious missing features, like undo, filters / saved - searches, message annotations, etc. +- Unix-centrism in MIME attachment handling and in sendmail invocation. == SYNOPSYS: - 1. sup-import + - 2. sup - 3. edit ~/.sup/config.yaml for the (very few) settings sup has - - Where is a filename (for mbox files), an imap or imaps URI, - or a mbox+ssh URI (for remote mbox files). You will be prompted for - a username and password if required. - - sup-import has several options which control whether you want - messages from particular mailboxes not to be added to the inbox, or - not to be marked as new, so run it with -h for help. + 0. sup-config + 1. sup Note that Sup never changes the contents of any mailboxes; it only indexes in to them. So it shouldn't ever corrupt your mail. The flip - side is that if you change a mailbox (e.g. delete messages, or, in - the case of mbox files, read an unread message) then Sup will be - unable to load messages from that source and will ask you to run - sup-import --rebuild. + side is that if you change a mailbox (e.g. delete messages, or, in the + case of mbox files, read an unread message) then Sup will be unable to + load messages from that source and will ask you to run sup-sync + --changed. == REQUIREMENTS: -* ferret >= 0.10.13 -* ncurses -* rmail -* highline + - ferret >= 0.11.6 + - ncurses >= 0.9.1 + - rmail >= 0.17 + - highline + - net-ssh + - trollop >= 1.12 + - lockfile + - mime-types + - gettext + - fastthread == INSTALL: -* 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] -* 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.) -* There are a couple other Ferret issues with outstanding patches but - they are pretty rare. -* If you are using IMAP 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, but IMAP requires that functionality. +* gem install sup + +== PROBLEMS: + +See FAQ.txt for some common problems and their solutions. == LICENSE: -Copyright (c) 2006, 2007 William Morgan. +Copyright (c) 2006--2009 William Morgan. This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License