X-Git-Url: http://git.madism.org/?a=blobdiff_plain;f=doc%2Fmanual.xml.head;h=fc9f0883b106de195c6d9fd1de8201ae2b6b1fcf;hb=0e9b83760fb127dc4c7ba0d0a06cd55735dc37db;hp=6a1079a2ae109397945614a97f186e7fbdd2db9c;hpb=e5801e9c02782901d09c554e74817adeaeb61272;p=apps%2Fmadmutt.git diff --git a/doc/manual.xml.head b/doc/manual.xml.head index 6a1079a..fc9f088 100644 --- a/doc/manual.xml.head +++ b/doc/manual.xml.head @@ -1222,7 +1222,7 @@ Furthermore, the following flags reflect who the message is addressed to. They can be customized with the - variable. + variable. @@ -1490,7 +1490,7 @@ Mutt-ng uses these attributes for handling text/enriched messages, and they - can also be used by an external + can also be used by an external script for highlighting purposes. Note: If you change the colors for your display, for example by changing the color associated with color2 for your xterm, then that color will be used instead of green. @@ -1608,18 +1608,18 @@ in the thread and hides the others. This is useful when threads contain so many messages that you can only see a handful of threads onthe screen. See %M in - . + . For example, you could use - %?M?(#%03M)&(%4l)? in + %?M?(#%03M)&(%4l)? in to optionally display the number of hidden messages if the thread is collapsed. - See also the variable. + See also the variable. @@ -1634,9 +1634,9 @@ Creates a new alias based upon the current message (or prompts for a new one). Once editing is complete, an - command is added to the file specified by the + command is added to the file specified by the variable for future use. Note: - Specifying an + Specifying an does not add the aliases specified there-in, you must also the file. @@ -1740,7 +1740,7 @@ match the regular expressions given by the commands, but also honor any Mail-Followup-To header(s) if the - + configuration variable is set. Using this when replying to messages posted to mailing lists helps avoid duplicate copies being sent to the @@ -1755,10 +1755,10 @@ Asks for an external Unix command and pipes the current or tagged message(s) to it. The variables - , - , - and - + , + , + and + control the exact behavior of this function. @@ -1791,7 +1791,7 @@ Asks for an external Unix command and executes it. The - + can be used to control whether Mutt-ng will wait for a key to be pressed when the command returns @@ -1805,7 +1805,7 @@ The pager uses the - + variable to detect quoted text when displaying the body of the message. This function toggles the displayof the quoted material in the message. It is particularly @@ -2135,7 +2135,7 @@ set edit_headers certainoperations like composing a new mail, replying, forwarding, etc. are not permitted when you are in that folder. The %r - in + in will change to a 'A' to indicate that you are in attach-message mode. @@ -2339,8 +2339,8 @@ Attach: filename [description] - Also see the and - variables + Also see the and + variables @@ -2360,7 +2360,7 @@ Pgp: [E | S | S id] ``E'' encrypts, ``S'' signs and ``S<id>'' signs with the given key, setting - + permanently. @@ -2390,7 +2390,7 @@ Pgp: [E | S | S id] Most fields of the entries in the key selection menu (see also - ) + ) have obvious meanings. But some explanations on the capabilities, flags, and validity fields are in order. @@ -2530,7 +2530,7 @@ Pgp: [E | S | S id] Note that different remailers do have different capabilities, indicated in the %c entry of the remailer menu lines (see - ). + ). Most important is the ``middleman'' capability, indicated by a capital ``M'': This means that the remailer in question cannot be used as the final @@ -2928,7 +2928,7 @@ set imap_home_namespace = $folder - would set the value of + would set the value of to the value to which is currently set to. @@ -2936,7 +2936,7 @@ set imap_home_namespace = $folder Note: There're no logical links established in such cases so - that the the value for + that the the value for won't change even if gets changed. @@ -3278,7 +3278,7 @@ alias theguys manny, moe, jack On the other hand, the function can use only one file, the one pointed to by the - + variable (which is ~/.muttrc by default). This file is not special either, @@ -3309,7 +3309,7 @@ set alias_file=~/.mail_aliases prompt. You can also enter aliases in your editor at the appropriate headers if you have the - + variable set. @@ -3894,7 +3894,7 @@ folder-hook . set sort=date-sent - quoted (text matching in the body of a message) + quoted (text matching in the body of a message) @@ -4219,7 +4219,7 @@ unignore posted-to: sent to a different party, mutt will automatically suggest to send the response to the original message's recipients--responding to yourself won't make much sense in many cases. - (See .) + (See .) @@ -4443,7 +4443,7 @@ set text_flowed Additional Notes - For completeness, the variable provides the mechanism + For completeness, the variable provides the mechanism to generate a DelSp=yes parameter on outgoing @@ -4499,7 +4499,7 @@ set text_flowed against receiving personal CCs of list messages. Also note that the generation of the Mail-Followup-To header is controlled by the - + configuration variable. @@ -4653,14 +4653,14 @@ set text_flowed - + User defined headers - Usage: string + Usage: string - Usage: field [field...] + Usage: field [field...] @@ -4694,7 +4694,7 @@ my_hdr Organization: A Really Big Company, Anytown, USA If you would like to add a header field to a single message, you should - either set the + either set the variable, or use the edit-headers function (default: ``E'') in the send-menu so @@ -4719,11 +4719,11 @@ unmy_hdr to cc - + Defining the order of headers when viewing messages - Usage: header1header2 header3 + Usage: header1header2 header3 @@ -5163,14 +5163,14 @@ score " santaclaus@northpole\.int" =666 These three thresholds can be set via the variables - , - and - . + , + and + . By default, - and - + and + are set to -1, which means that in the default threshold configuration no @@ -5229,7 +5229,7 @@ color index red yellow " 100-" mail based on its spam attributes, as determined by the external filter. You also can display the spam attributes in your index display using the %H selector in the - + variable. (Tip: try %?H?[%H] ? to display spam tags only when they are defined for a given message.) @@ -5734,7 +5734,7 @@ ifdef feature_nntp 'source ~/.mutt-ng/setup-nntp' An example for testing for variable names can be used if users use different revisions of mutt-ng whereby the older one may not have a certain variable. To test for the availability of - + use: @@ -5747,8 +5747,8 @@ ifdef imap_mail_check 'set imap_mail_check = 300' Provided for completeness is the test for menu names. To set - + only if the pager menu is available, use: @@ -6433,7 +6433,7 @@ ifndef feature_slang 'source ~/.mutt-ng/setup-ncurses' The setting for the status bar of the index is controlled via the - + variable. For the hostname and version string, there's an expando for $status_format: %h @@ -6800,7 +6800,7 @@ set status_format = "%B: %?n?%n&no? new messages %> (%v on %h)" operation will be applied to all tagged messages if that operation can be used in that - manner. If the + manner. If the variable is set, the next operation applies to the tagged messages automatically, without requiring the ``tag-prefix''. @@ -6903,7 +6903,7 @@ set status_format = "%B: %?n?%n&no? new messages %> (%v on %h)" send-hook . 'unmy_hdr From:' -send-hook '^b@b\.b$' my_hdr from: c@c.c +send-hook '^b@b\.b$' my-hdr from: c@c.c @@ -6937,7 +6937,7 @@ send-hook '^b@b\.b$' my_hdr from: c@c.c mail to a specific address, you could do something like: -send-hook ' ^me@cs\.hmc\.edu$' 'my_hdr From: Mutt-ng User <user@host>' +send-hook ' ^me@cs\.hmc\.edu$' 'my-hdr From: Mutt-ng User <user@host>' which would execute the given command when sending mail to me@cs.hmc.edu. @@ -7042,7 +7042,7 @@ macro pager B ':toggle sidebar_visible^M' LDAP, ph/qi, bbdb, or NIS through a wrapper script which connects to mutt using a simple interface. Using the - + variable, you specify the wrapper command to use. For example: @@ -7114,7 +7114,7 @@ roessler@guug.de Thomas Roessler mutt pgp mbox, MMDF, MH and Maildir. The mailbox type is autodetected, so there is no need to use a flag for different mailbox types. When creating newmailboxes, Mutt-ng uses the default specified with the - + variable. @@ -7204,20 +7204,20 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST - ! -- refers to your + ! -- refers to your (incoming) mailbox - > -- refers to your file + > -- refers to your file - < -- refers to your file + < -- refers to your file @@ -7241,7 +7241,7 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST - = or + -- refers to your + = or + -- refers to your directory @@ -7283,7 +7283,7 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST the index menu display. This is useful to distinguish between personal and list mail in the same mailbox. In the - + variable, the escape ``%L'' will return the string ``To <list>'' when ``list'' appears in the ``To'' field, and ``Cc <list>'' when it appears in the ``Cc'' @@ -7306,7 +7306,7 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST Mutt-ng also supports the Mail-Followup-To header. When you send a message to a list of recipients which includes one or several - subscribed mailing lists, and if the + subscribed mailing lists, and if the option is set, mutt will generate a Mail-Followup-To header which contains all the recipients to whom you send this message, but not your address. This indicates that @@ -7320,7 +7320,7 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST Conversely, when group-replying or list-replying to a message which has a Mail-Followup-To header, mutt will respect this header if - the + the configuration variable is set. Using list-reply will in this case also make sure that the reply goes to the mailing list, even if it's not specified @@ -7340,7 +7340,7 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST than the author of the message. This can create problems when trying to reply directly to the author in private, since most mail clients will automatically reply to the address given in the ``Reply-To'' - field. Mutt-ng uses the + field. Mutt-ng uses the variable to help decide which address to use. If set to ask-yes @@ -7356,7 +7356,7 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST The ``X-Label:'' header field can be used to further identify mailing lists or list subject matter (or just to annotate messages - individually). The + individually). The variable's ``%y'' and ``%Y'' escapes can be used to expand ``X-Label:'' fields in the index, and Mutt-ng's pattern-matcher can match regular expressions to @@ -7491,7 +7491,7 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST - is used + is used to request receipts for different results (such as failed message,message delivered, etc.). @@ -7500,7 +7500,7 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST - requests + requests how much of your message should be returned with the receipt (headers or full message). @@ -7555,7 +7555,7 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST reason the frequency at which Mutt-ng will check for mail remotely can be controlled by the - + variable, which defaults to every 60 seconds. @@ -7576,7 +7576,7 @@ From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST (default: G). It allows to connect to pop-host ,fetch all your new mail and place it in the - local . After this + local . After this point, Mutt-ng runs exactly as if the mail had always been local. @@ -7664,7 +7664,7 @@ imap://imapserver:port/INBOX When browsing folders on an IMAP server, you can toggle whether to look at only the folders you are subscribed to, or all folders with the toggle-subscribed command. See also the - + variable. @@ -7672,9 +7672,9 @@ imap://imapserver:port/INBOX Polling for new mail on an IMAP server can cause noticeable delays. So, you'll want to carefully tune the - + and - + variables. @@ -7782,7 +7782,7 @@ imap://imapserver:port/INBOX - - controls + - controls the username under which you request authentication on the IMAP server, for all authenticators. This is overridden by an explicit @@ -7794,7 +7794,7 @@ imap://imapserver:port/INBOX - - a + - a password which you may preset, used by all authentication methods where a password is needed. @@ -7803,7 +7803,7 @@ imap://imapserver:port/INBOX - + - a colon-delimited list of IMAP authentication methods to try, in the order you wish to try them. If @@ -7840,7 +7840,7 @@ imap://imapserver:port/INBOX environment variable. Like other news readers, info about subscribed newsgroups is saved in a file as specified by the - variable. + variable. Article headers are cached and can be loaded from a file when a newsgroup is entered instead loading from newsserver; currently, this caching mechanism still is different from the header caching for @@ -7952,24 +7952,24 @@ score ! =42 support includes support for Delivery Status Notification (see dsn section) as well as handling the 8BITMIME flag controlled via - . + . To enable sending mail directly via SMTP without an MTA such as - Postfix or SSMTP and the like, simply set the + Postfix or SSMTP and the like, simply set the variable pointing to your SMTP server. - Authentication mechanisms are available via the - and variables. + Authentication mechanisms are available via the + and variables. Transport Encryption via the StartTLS command is also available. For this to work, first of all Mutt-ng must be built with SSL or GNUTLS. - Secondly, the variable + Secondly, the variable must be either set to ``enabled'' or ``required.'' In both cases, StartTLS will be used if the server supports it: for the second case, the connection will fail @@ -7982,7 +7982,7 @@ score ! =42 sender, i.e. they allow for only one value which may not be what the user wants to send as the From: header. In this case, the variable - may be used + may be used to set the envelope different from the From: header. @@ -8108,7 +8108,7 @@ append-hook \\.gz$ "gzip -c %t >> %f" use of programs that do not have well defined extensions. Just use "." as a regexp. But this may be surprising if your compressing script produces empty files. In this situation, unset - + ,so that the compressed file will be removed if you delete all of the messages. @@ -8263,7 +8263,7 @@ append-hook \\.gz$ "gzip -c %t >> %f" When is used, the folder is not opened, which saves time, but this means that we can not find out - what the folder type is. Thus the default ( + what the folder type is. Thus the default ( )type is always supposed (i.e. this is the format used for the temporary folder). @@ -8696,7 +8696,7 @@ text/*; more parameters in expansion of %s syntaxes properly, and avoids risky characters by - substituting them, see the + substituting them, see the variable. @@ -8784,13 +8784,13 @@ text/html; lynx -dump %s ; copiousoutput needsterminal - Mutt-ng uses this flag when viewing attachments with , + Mutt-ng uses this flag when viewing attachments with , in order to decide whether it should honor the setting - of the variable or + of the variable or not. When an attachment is viewed using an interactive program, and the corresponding mailcap entry has a needsterminal flag, Mutt-ng will use - and the exit + and the exit statusof the program to decide if it will ask you to press a key after the external program has exited. In all other situations it @@ -8938,7 +8938,7 @@ nametemplate=%s.gif - In addition, you can use this with + In addition, you can use this with to denote two commands for viewing an attachment, one to be viewed automatically, the other to be viewed interactively from the attachment @@ -8951,7 +8951,7 @@ text/html; netscape -remote 'openURL(%s)' ; test=RunningX text/html; lynx %s; nametemplate=%s.html text/html; lynx -dump %s; nametemplate=%s.html; copiousoutput - For , Mutt-ng will choose + For , Mutt-ng will choose the third entry because of the copiousoutput tag. For interactive viewing, Mutt @@ -9116,7 +9116,7 @@ application/ms-excel; open.pl %s - + MIME Autoview @@ -9175,7 +9175,7 @@ application/postscript; ps2ascii %s; copiousoutput - + MIME Multipart/Alternative @@ -9195,7 +9195,7 @@ application/postscript image/* Next, mutt will check if any of the types have a defined - , and use that. Failing + , and use that. Failing that, Mutt-ng will look for any text type. As a last attempt, mutt willlook for any type it knows how to handle. @@ -9211,7 +9211,7 @@ application/postscript image/* - + MIME Lookup @@ -9303,11 +9303,11 @@ mime_lookup application/octet-stream application/X-Lotus-Manuscript Mutt-ng uses many temporary files for viewing messages, verifying - digital signatures, etc. The + digital signatures, etc. The variable can be used to change the default permissions of these files. Please only change it if you really know what you are doing. Also, a different location for these files may be desired which can - be changed via the variable. + be changed via the variable. @@ -9327,7 +9327,7 @@ mime_lookup application/octet-stream application/X-Lotus-Manuscript information probably telling others how many mail you sent in which time, you at least need to remove the %P expando from the - default setting of the variable. Please make sure that + default setting of the variable. Please make sure that you really know how local parts of these Message-ID: headers are composed. @@ -9344,7 +9344,7 @@ mime_lookup application/octet-stream application/X-Lotus-Manuscript will be strict in interpreting them which means that arbitrary header fields can be embedded in these links which could override existing header fields or attach arbitrary files. This may be - problematic if the + problematic if the variable is unset, i.e. the user doesn't want to see header fields while editing the message. @@ -9367,7 +9367,7 @@ mailto:joe@host?Attach=~/.gnupg/secring.gpg - When unsetting the + When unsetting the variable, mutt-ng will @@ -9387,7 +9387,7 @@ mailto:joe@host?Attach=~/.gnupg/secring.gpg - turn on the + turn on the variable by force to let the user see all the headers (because they still may leak information.) @@ -9420,7 +9420,7 @@ mailto:joe@host?Attach=~/.gnupg/secring.gpg by . Mutt-ng can be set up to automatically execute any given utility as listed in one of the mailcap files (see the - + variable for details.) @@ -9464,7 +9464,7 @@ mailto:joe@host?Attach=~/.gnupg/secring.gpg - leave the variable in its default + leave the variable in its default state to restrict mailcap expandos to a safe set of characters @@ -9986,13 +9986,13 @@ mailto:joe@host?Attach=~/.gnupg/secring.gpg - mimetype [ mimetype ... ] + mimetype [ mimetype ... ] - mimetype [ mimetype ... ] + mimetype [ mimetype ... ] @@ -10004,13 +10004,13 @@ mailto:joe@host?Attach=~/.gnupg/secring.gpg - mimetype [ mimetype ... ] + mimetype [ mimetype ... ] - mimetype [ mimetype ... ] + mimetype [ mimetype ... ] @@ -10070,13 +10070,13 @@ mailto:joe@host?Attach=~/.gnupg/secring.gpg - header [ header ... ] + header [ header ... ] - header [ header ... ] + header [ header ... ] @@ -10136,14 +10136,14 @@ mailto:joe@host?Attach=~/.gnupg/secring.gpg - mimetype [ mimetype ... ] + mimetype [ mimetype ... ] - mimetype [ mimetype ... ] + mimetype [ mimetype ... ] @@ -10161,13 +10161,13 @@ mailto:joe@host?Attach=~/.gnupg/secring.gpg - string + string - field [ field ... ] + field [ field ... ] @@ -10310,167 +10310,167 @@ mailto:joe@host?Attach=~/.gnupg/secring.gpg edit_hdrs - + forw_decode - + forw_format - + forw_quote - + hdr_format - + indent_str - + mime_fwd - + msg_format - + pgp_autosign - + pgp_autoencrypt - + pgp_replyencrypt - + pgp_replysign - + pgp_replysignencrypted - + pgp_verify_sig - + pgp_create_traditional - + pgp_auto_traditional - + forw_decrypt - + smime_sign_as - + post_indent_str - + print_cmd - + shorten_hierarchy - + ask_followup_to - + ask_x_comment_to - + catchup_newsgroup - + followup_to_poster - + group_index_format - + inews - + mime_subject - + news_cache_dir - + news_server - + newsrc - + nntp_poll - + pop_checkinterval - + post_moderated - + save_unsubscribed - + show_new_news - + show_only_unread - + x_comment_to - + smtp_auth_username - + smtp_auth_password - + user_agent - +