X-Git-Url: http://git.madism.org/?a=blobdiff_plain;ds=sidebyside;f=doc%2Fmanual.xml.head;h=2c06da458d3082ea6f9119c8d065c72e71a3cd01;hb=c8becc4d099cee8c18ebd967720ce7204311d817;hp=421cb9ebc531b5999d48f5f1b515e4d499e3f829;hpb=d66666d0222bc9dd42ab24d520e30fba3c1f45f7;p=apps%2Fmadmutt.git
diff --git a/doc/manual.xml.head b/doc/manual.xml.head
index 421cb9e..2c06da4 100644
--- a/doc/manual.xml.head
+++ b/doc/manual.xml.head
@@ -167,7 +167,7 @@
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
- Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA.
+ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
@@ -1175,15 +1175,6 @@
-
- A
-
-
- message has one or more attachments.
-
-
-
-
S
@@ -9252,7 +9243,136 @@ application/postscript image/*
-
+
+
+ Attachment Searching and Counting
+
+
+ If you ever lose track of attachments in your mailboxes, Mutt's
+ attachment-counting and -searching support might be for you. You
+ can make your message index display the number of qualifying
+ attachments in each message, or search for messages by
+ attachment count. You also can configure what kinds of
+ attachments qualify for this feature with the attachments and
+ unattachments commands.
+
+
+
+The syntax is:
+
+
+
+
+ ( {+|-}disposition mime-type | ? )
+
+
+
+
+ {+|-}disposition mime-type
+
+
+
+
+Disposition is the attachment's Content-disposition type -- either
+"inline" or "attachment". You can abbreviate this to I or A.
+
+
+
+Disposition is prefixed by either a + symbolor a - symbol. If it's
+a +, you're saying that you want to allow this disposition and MIME
+type to qualify. If it's a -, you're saying that this disposition
+and MIME type is an exception to previous + rules. There are examples
+below of how this is useful.
+
+
+
+Mime-type is, unsurprisingly, the MIME type of the attachment you want
+to affect. A MIME type is always of the format "major/minor", where
+"major" describes the broad category of document you're looking at, and
+"minor" describes the specific type within that category. The major
+part of mim-type must be literal text (or the special token "*"), but
+the minor part may be a regular expression. (Therefore, "*/.*" matches
+any MIME type.)
+
+
+
+The MIME types you give to the attachments directive are a kind of
+pattern. When you use the attachments directive, the patterns you
+specify are added to a list. When you use unattachments, the pattern
+is removed from the list. The patterns are not expanded and matched
+to specific MIME types at this time -- they're just text in a list.
+They're only matched when actually evaluating a message.
+
+
+
+Some examples might help to illustrate. The examples that are not
+commented out define the default configuration of the lists.
+
+
+
+## Removing a pattern from a list removes that pattern literally. It
+## does not remove any type matching the pattern.
+##
+## attachments +A */.*
+## attachments +A image/jpeg
+## unattachments +A */.*
+##
+## This leaves "attached" image/jpeg files on the allowed attachments
+## list. It does not remove all items, as you might expect, because the
+## second */.* is not a matching expression at this time.
+##
+## Remember: "unattachments" only undoes what "attachments" has done!
+## It does not trigger any matching on actual messages.
+
+
+## Qualify any MIME part with an "attachment" disposition, EXCEPT for
+## text/x-vcard and application/pgp parts. (PGP parts are already known
+## to mutt, and can be searched for with ~g, ~G, and ~k.)
+##
+## I've added x-pkcs7 to this, since it functions (for S/MIME)
+## analogously to PGP signature attachments. S/MIME isn't supported
+## in a stock mutt build, but we can still treat it specially here.
+##
+attachments +A */.*
+attachments -A text/x-vcard application/pgp.*
+attachments -A application/x-pkcs7-.*
+
+## Discount all MIME parts with an "inline" disposition, unless they're
+## text/plain. (Why inline a text/plain part unless it's external to the
+## message flow?)
+##
+attachments +I text/plain
+
+## These two lines make Mutt qualify MIME containers. (So, for example,
+## a message/rfc822 forward will count as an attachment.) The first
+## line is unnecessary if you already have "attach-allow */.*", of
+## course. These are off by default! The MIME elements contained
+## within a message/* or multipart/* are still examined, even if the
+## containers themseves don't qualify.
+##
+#attachments +A message/.* multipart/.*
+#attachments +I message/.* multipart/.*
+
+## You probably don't really care to know about deleted attachments.
+attachments -A message/external-body
+attachments -I message/external-body
+
+
+
+"attachments ?" will list your current settings in Muttrc format, so
+that it can be pasted elsewhere.
+
+
+
+ Please note that counting attachments may require lots of data be
+ loaded. This may cause noticeable slowdowns over network links
+ depending on the connection speed and message sizes. To fine-tune the
+ behavior on a per-folder or other basis, the variable may be used.
+
+
+
+
MIME Lookup
@@ -9942,6 +10062,11 @@ mailto:joe@host?Attach=~/.gnupg/secring.gpg
EXPR
messages which contain EXPR in the `References' field
+
+
+ [MIN]-[MAX]
+ messages with MIN to MAX attachments *)
+
EXPR