From: Rocco Rutte Date: Wed, 10 Dec 2008 09:29:31 +0000 (+0100) Subject: Manual: Wrap important examples in X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=d9800a7f601b7bbd58264474b20b1f01eeb589f9;p=neomutt Manual: Wrap important examples in --- diff --git a/doc/manual.xml.head b/doc/manual.xml.head index 18baf6d38..d80347242 100644 --- a/doc/manual.xml.head +++ b/doc/manual.xml.head @@ -1415,9 +1415,12 @@ V) from the index menu. An initialization file consists of a series of commands. Each line of the file may contain one or more commands. When multiple commands are used, they must be separated by a semicolon (;). + +Multiple configuration commands per line set realname='Mutt user' ; ignore x- + The hash mark, or pound sign (#), is used as a comment character. You can use it to @@ -1427,9 +1430,12 @@ to the end of the line is ignored. For example, + +Commenting configuration files my_hdr X-Disclaimer: Why are you listening to me? # This is a comment + @@ -1450,9 +1456,12 @@ For example, if want to put quotes " inside of a string, you \ to force the next character to be a literal instead of interpreted character. + +Escaping quotes in congfiguration files set realname="Michael \"MuttDude\" Elkins" + @@ -1473,9 +1482,12 @@ It is also possible to substitute the output of a Unix command in an initialization file. This is accomplished by enclosing the command in backticks (``). For example, + +Using external command's output in configuration files my_hdr X-Operating-System: `uname -a` + The output of the Unix command uname -a will be substituted before the line is parsed. Note that since initialization files are line oriented, only @@ -1487,9 +1499,12 @@ Both environment variables and mutt variables can be accessed by prepending $ to the name of the variable. For example, + +Using environment variables in configuration files set record=+sent_on_$HOSTNAME + will cause mutt to save outgoing messages to a folder named @@ -1714,11 +1729,14 @@ For example: + +Configuring external alias files source /usr/local/share/Mutt.aliases source ~/.mail_aliases set alias_file=~/.mail_aliases + @@ -2030,10 +2048,13 @@ for all folders containing mutt in their name. + +Setting sort method based on mailbox name folder-hook . set sort=date-sent folder-hook mutt set sort=threads + @@ -2411,6 +2432,8 @@ For example: + +Header weeding # Sven's draconian header weeding ignore * @@ -2418,6 +2441,7 @@ unignore from date subject to cc unignore organization organisation x-mailer: x-newsreader: x-mailing-list: unignore posted-to: + @@ -2456,9 +2480,12 @@ thus removing the header order effects set by the system-wide startup file. + +Configuring header display order hdr_order From Date: From: To: Cc: Subject: + @@ -2837,9 +2864,12 @@ all of your outgoing messages, you can put the command + +Defining custom headers my_hdr Organization: A Really Big Company, Anytown, USA + @@ -2907,6 +2937,8 @@ Examples: + +Using %-expandos in <literal>save-hook</literal> # default: save all to ~/Mail/<author name> save-hook . ~/Mail/%F @@ -2917,6 +2949,7 @@ save-hook me@(turing\\.)?cs\\.hmc\\.edu$ +elkins # save from aol.com to $folder/spam save-hook aol\\.com$ +spam + @@ -3175,9 +3208,12 @@ automatically run a sequence of commands at startup, or when entering certain folders. For example, the following command will automatically collapse all threads when entering a folder: + +Embedding <literal>push</literal> in <literal>folder-hook</literal> folder-hook . 'push <collapse-all>' + @@ -3317,12 +3353,15 @@ them. For example, suppose I use DCC, SpamAssassin, and PureMessage. I might define these spam settings: + +Configuring spam detection spam "X-DCC-.*-Metrics:.*(....)=many" "90+/DCC-%1" spam "X-Spam-Status: Yes" "90+/SA" spam "X-PerlMX-Spam: .*Probability=([0-9]+)%" "%1/PM" set spam_separator=", " + @@ -3573,6 +3612,8 @@ to abbreviate the calls of the source command: + +Using user-defined variables for config file readability set my_cfgdir = $HOME/mutt/config @@ -3580,6 +3621,7 @@ source $my_cfgdir/hooks source $my_cfgdir/macros # more source commands... + @@ -3592,6 +3634,8 @@ linkend="delete">$delete is restored. + +Using user-defined variables for backing up other config option values macro pager ,x '\ <enter-command>set my_delete=$delete<enter>\ @@ -3599,6 +3643,7 @@ macro pager ,x '\ ...\ <enter-command>set delete=$my_delete<enter>' + @@ -3614,6 +3659,8 @@ dollar sign. + +Deferring user-defined variable expansion to runtime macro pager <PageDown> "\ <enter-command> set my_old_pager_stop=\$pager_stop pager_stop<Enter>\ @@ -3621,6 +3668,7 @@ macro pager <PageDown> "\ <enter-command> set pager_stop=\$my_old_pager_stop<Enter>\ <enter-command> unset my_old_pager_stop<Enter>" + @@ -3780,9 +3828,12 @@ All % expandos in a format string are expanded before the script is called so that: + +Using external filters in format strings set status_format="script.sh '%r %f (%L)'|" + will make mutt expand %r, @@ -4262,9 +4313,12 @@ field and which are from elkins. + +Using boolean operators in patterns !(~t mutt|~c mutt) ~f elkins + @@ -4362,7 +4416,6 @@ Example: To select any messages two weeks around January 15, 2001, you'd use the following pattern: - Limit to messages matching: ~d 15/1/2001*2w @@ -4527,10 +4580,13 @@ my_hdr directive: + +Combining <literal>send-hook</literal> and <literal>my_hdr</literal> send-hook . 'unmy_hdr From:' send-hook ~C'^b@b\.b$' my_hdr from: c@c.c + @@ -5855,6 +5911,8 @@ Some examples might help to illustrate. The examples that are not commented out define the default configuration of the lists. + +Attachment counting ## Removing a pattern from a list removes that pattern literally. It ## does not remove any type matching the pattern. @@ -5903,6 +5961,7 @@ attachments +I text/plain attachments -A message/external-body attachments -I message/external-body + Entering the command attachments ? diff --git a/doc/mutt.css b/doc/mutt.css index 82045eb1b..a6623c18d 100644 --- a/doc/mutt.css +++ b/doc/mutt.css @@ -1,11 +1,10 @@ @media screen { body { margin-left:2%; margin-right:2%; font-family:serif; } - .toc a, .list-of-tables a { font-family:sans-serif; } + .toc, .list-of-tables, .list-of-examples { font-family:sans-serif; } h1, h2, h3, h4, h5, h6 { font-family:sans-serif; } em.replaceable code { font-family:sans-serif; } p { text-align:justify; } - div.table p.title { font-size:smaller; } - div.table p.title b { font-weight:normal; } + div.table p.title, div.example p.title { font-size:smaller; font-family:sans-serif; } .email, .email a { font-family:monospace; } div.table-contents table { border-collapse:collapse; border:1px solid #c0c0c0; } div.table-contents table td, div.table-contents table th { padding:5px; text-align:left; } @@ -15,5 +14,5 @@ font-weight:normal; vertical-align:top; } - pre { background:#f0f0f0; border:1px solid #c0c0c0; padding:5px; } + pre.screen { background:#f0f0f0; border:1px solid #c0c0c0; padding:5px; } }