X-Git-Url: http://git.madism.org/?p=apps%2Fmadmutt.git;a=blobdiff_plain;f=doc%2Fmanual.sgml.head;h=33fb23eae31568d4a17cceed24593fe530733058;hp=abed2a60fd007df651d14e012f3e469f4775f7ff;hb=85486f8623f6d9a12f7b251445ac9d203d3ae348;hpb=8251e71a54cf536b42bf3af4b50a7611951036c6 diff --git a/doc/manual.sgml.head b/doc/manual.sgml.head index abed2a6..33fb23e 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,17 +2247,17 @@ pattern is translated at the time the hook is declared, so the value of that is in effect at that time will be used. -Usind the sidebar

-The sidebar allows you to use a mailbox listing which looks very -similiar to the ones you can the in GUI mail clients. +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 commands: +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: @@ -2180,21 +2266,39 @@ 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

@@ -2287,6 +2391,7 @@ path. ! -- refers to your (incoming) mailbox > -- refers to your file < -- refers to your file +^ -- refers to the current mailbox - or !! -- refers to the file you've last visited ˜ -- refers to your home directory = or + -- refers to your directory @@ -2386,9 +2491,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

@@ -2511,15 +2613,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 @@ -2532,7 +2629,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