X-Git-Url: http://git.madism.org/?p=apps%2Fmadmutt.git;a=blobdiff_plain;f=doc%2Fmanual.sgml.head;h=2b5df61a29a21bd13337a03f4a10ad35b34eddd6;hp=f34b850892c27d08b6d0d30e000d260cd0e5af49;hb=6b4750772eba54f979455376713b49900a4d5016;hpb=5c310cabcfafe551dcad7638c007daae1c7d3710 diff --git a/doc/manual.sgml.head b/doc/manual.sgml.head index f34b850..2b5df61 100644 --- a/doc/manual.sgml.head +++ b/doc/manual.sgml.head @@ -13,37 +13,39 @@ Introduction

-Mutt Home Page +

This documentation additionaly contains documentation to Mutt-ng Home Page

- + Mailing Lists

-To subscribe to one of the following mailing lists, send a message with the -word - -- low traffic list for announcements - -- help, bug reports and feature requests - -- development mailing list + -- This is where the mutt-ng user support happens. + -- The development mailing list for mutt-ng -Software Distribution Sites

+So far, there are no official releases of Mutt-ng, but you can download +daily snapshots from + + IRC

-Visit channel to chat with other people interested in Mutt. +(www.freenode.net)"> to chat with other people interested in Mutt-ng. + -USENET +Weblog

-See the newsgroup . +If you want to read fresh news about the latest development in Mutt-ng, and get informed +about stuff like interesting, Mutt-ng-related articles and packages for your favorite +distribution, you can read and/or subscribe to our +. Copyright

@@ -736,20 +744,20 @@ newsgroup entered instead loading from newsserver. Configuration

-While the default configuration (or ``preferences'') make Mutt -usable right out of the box, it is often desirable to tailor Mutt to -suit your own tastes. When Mutt is first invoked, it will attempt to -read the ``system'' configuration file (defaults set by your local -system administrator), unless the ``-n'' option is specified. This file is typically -/usr/local/share/mutt/Muttrc or /etc/Muttrc. Mutt -will next look for a file named .muttrc in your home -directory. If this file does not exist and your home directory has -a subdirectory named .mutt/muttrc. +While the default configuration (or ``preferences'') make Mutt-ng usable right out +of the box, it is often desirable to tailor Mutt to suit your own tastes. When +Mutt-ng is first invoked, it will attempt to read the ``system'' configuration +file (defaults set by your local system administrator), unless the ``-n'' option is specified. This file is +typically /usr/local/share/muttng/Muttngrc or /etc/Muttngrc, +Mutt-ng users will find this file in /usr/local/share/muttng/Muttrc or +/etc/Muttngrc. Mutt will next look for a file named .muttrc +in your home directory, Mutt-ng will look for .muttngrc. If this file +does not exist and your home directory has a subdirectory named .muttng/muttngrc. -.muttrc is the file where you will usually place your to configure Mutt. +.muttrc (or .muttngrc for Mutt-ng) is the file where you will +usually place your to configure Mutt. In addition, mutt supports version specific configuration files that are parsed instead of the default files as explained above. For instance, if @@ -806,6 +814,36 @@ A \ at the end of a line can be used to split commands over multiple lines, provided that the split points don't appear in the middle of command names. +Please note that, unlike the various shells, mutt-ng interpretes a ``\'' +at the end of a line also in comments. This allows you to disable a command +split over multiple lines with only one ``#''. + + +# folder-hook . \ + set realname="Michael \"MuttDude\" Elkins" + + +When testing your config files, beware the following caveat. The backslash +at the end of the commented line extends the current line with the next line +- then referred to as a ``continuation line''. As the first line is +commented with a hash (#) all following continuation lines are also +part of a comment and therefore are ignored, too. So take care of comments +when continuation lines are involved within your setup files! + +Abstract example: + + +line1\ +line2a # line2b\ +line3\ +line4 +line5 + + +line1 ``continues'' until line4. however, the part after the # is a +comment which includes line3 and line4. line5 is a new line of its own and +thus is interpreted again. + It is also possible to substitute the output of a Unix command in an initialization file. This is accomplished by enclosing the command in backquotes (``). For example, @@ -1701,6 +1739,51 @@ If the filename ends with a vertical bar (|), then source ~/bin/myscript|). +Configuring features conditionaly

+Usage: +ifdef feature_imap 'source ~/.mutt-ng/imap_setup' +# or +# ifdef imap_user 'source ~/.mutt-ng/imap_setup' +# or +# ... + + +To exit mutt-ng directly if no NNTP support is compiled in: + +ifndef feature_nntp 'push q' +# or +# ifndef newsrc 'push q' +# or +# ... + + +To only set the when the system's SVN +is recent enough to have it: + +ifdef imap_mail_check 'set imap_mail_check=300' + + Removing hooks

Usage: Where EXPR, USER, ID, and SUBJECT are @@ -2161,6 +2247,59 @@ pattern is translated at the time the hook is declared, so the value of that is in effect at that time will be used. +Using the sidebar

+The sidebar, a feature specific to Mutt-ng, allows you to use a mailbox listing +which looks very similar to the ones you probably know from GUI mail clients. +The sidebar lists all specified mailboxes, shows the number in each +and highlights the ones with new email +Use the following configuration commands: + +set sidebar_visible="yes" +set sidebar_width=25 + + +If you want to specify the mailboxes you can do so with: + +set mbox='=INBOX' +mailboxes INBOX \ + MBOX1 \ + MBOX2 \ + ... + + +You can also specify the colors for mailboxes with new mails by using: + +color sidebar_new red black +color sidebar white black + + +The available functions are: + +sidebar-scroll-up Scrolls the mailbox list up 1 page +sidebar-scroll-down Scrolls the mailbox list down 1 page +sidebar-next Hilights the next mailbox +sidebar-next-new Hilights the next mailbox with new mail +sidebar-previous Hilights the previous mailbox +sidebar-open Opens the currently hilighted mailbox + + +Reasonable key bindings look e.g. like this: + +bind index \Cp sidebar-prev +bind index \Cn sidebar-next +bind index \Cb sidebar-open +bind pager \Cp sidebar-prev +bind pager \Cn sidebar-next +bind pager \Cb sidebar-open + +macro index B ':toggle sidebar_visible^M' +macro pager B ':toggle sidebar_visible^M' + + +You can then go up and down by pressing Ctrl-P and Ctrl-N, and +switch on and off the sidebar simply by pressing 'B'. + External Address Queries

Mutt supports connecting to external directory databases such as LDAP, @@ -2351,9 +2490,6 @@ either by misconfigured software or bad behaviour from some correspondents. This allows to clean your mailboxes formats) from these annoyances which make it hard to follow a discussion. -If you want to use these functions with IMAP, you need to compile Mutt -with the Linking threads

@@ -2476,15 +2612,10 @@ name="$imap_list_subscribed"> variable. Polling for new mail on an IMAP server can cause noticeable delays. So, you'll want to carefully tune the - + and -variables. Personally I use - -set mail_check=90 -set timeout=15 - -with relatively good results over my slow modem line. +variables. Note that if you are using mbox as the mail store on UW servers prior to v12.250, the server has been reported to disconnect a client if another client @@ -2497,7 +2628,7 @@ As of version 1.2, mutt supports browsing mailboxes on an IMAP server. This is mostly the same as the local file browser, with the following differences: -In lieu of file permissions, mutt displays the string "IMAP", +Instead of file permissions, mutt displays the string "IMAP", possibly followed by the symbol "+", indicating that the entry contains both messages and subfolders. On Cyrus-like servers folders will often contain both messages and