<sect1>Reading news via NNTP<label id="reading_news">
<p>
-If compiled with ``--enable-nntp'' option, Mutt-ng can read news from newsserver
-via NNTP. You can open a newsgroup with function ``change-newsgroup''
-(default: i). Default newsserver can be obtained from <em/NNTPSERVER/
-environment variable. Like other news readers, info about subscribed
-newsgroups is saved in file by <ref id="newsrc" name="$newsrc">
-variable. Article headers are cached and can be loaded from file when
+If compiled with ``--enable-nntp'' option, Mutt-ng can read news from
+newsserver via NNTP. You can open a newsgroup with function
+``change-newsgroup'' (default: i). Default newsserver can be obtained
+from <em/NNTPSERVER/ environment variable. Like other news readers,
+info about subscribed newsgroups is saved in file by <ref
+id="nntp_newsrc" name="$nntp_newsrc"> variable. Article
+headers are cached and can be loaded from file when
newsgroup entered instead loading from newsserver.
<sect>Configuration
<sect1>Configuring features conditionally<label id="ifdef">
<p>
-Usage: <tt/ifdef/ <em/item/ <em/command/
+Usage: <tt/ifdef/ <em/item/ <em/command/<newline>
Usage: <tt/ifndef/ <em/item/ <em/command/
-These command allows to test if a variable, function or certain feature
-is available or not respectively, before actually executing the command.
-<tt/ifdef/ (short for ``if defined) handles commands if upon
+<p>
+These commands allow testing for a variable, function or certain feature
+being available or not respectively, before actually executing the
+command given.
+
+<p>
+<tt/ifdef/ (short for ``if defined'') only executes the command upon
availability while <tt/ifndef/ (short for ``if not defined'') does if
not. The <em/command/ may be any valid fraction of a configuration file.
-All names of variables and functions may be tested. Additionally, the
-following compile-features may be tested when prefixed with 'feature_':
-ncurses, slang, iconv, idn, dotlock, standalone, pop, nntp, imap, ssl,
-gnutls, sasl, sasl2, libesmtp, compressed, color, classic_pgp,
-classic_smime, gpgme, header_cache.
+<p>
+All names of variables, functions and menus may be tested. Additionally, the
+following compile-features may be tested when prefixed with
+'<tt/feature_/':
+<tt/ncurses/, <tt/slang/, <tt/iconv/, <tt/idn/, <tt/dotlock/,
+<tt/standalone/, <tt/pop/, <tt/nntp/, <tt/imap/, <tt/ssl/, <tt/gnutls/,
+<tt/sasl/, <tt/sasl2/, <tt/libesmtp/, <tt/compressed/, <tt/color/,
+<tt/classic_pgp/, <tt/classic_smime/, <tt/gpgme/, <tt/header_cache/,
+<tt/gdbm/, <tt/qdbm/ and <tt/db4/.
+<p>
Examples follow.
-To only source a file with IMAP related settings only if IMAP support is
+<p>
+To only source a file with IMAP related settings if IMAP support is
compiled in, use:
<tscreen><verb>
ifdef feature_imap 'source ~/.mutt-ng/imap_setup'
# ...
</verb></tscreen>
+<p>
To exit mutt-ng directly if no NNTP support is compiled in:
<tscreen><verb>
ifndef feature_nntp 'push q'
# ...
</verb></tscreen>
-To only set the <ref id="imap_mail_check"
-name="<$imap_mail_check"> when the system's SVN
-is recent enough to have it:
+<p>
+To only set the <ref id="imap_mail_check"
+name="$imap_mail_check"> variable if
+the system's mutt-ng is aware of it, use:
<tscreen><verb>
-ifdef imap_mail_check 'set imap_mail_check=300'
+ifdef imap_mail_check 'set imap_mail_check=500'
</verb></tscreen>
<sect1>Removing hooks<label id="unhook">
Polling for new mail is more expensive over POP3 than locally. For this
reason the frequency at which Mutt-ng will check for mail remotely can be
controlled by the
-<ref id="pop_checkinterval" name="$pop_checkinterval">
+<ref id="pop_mail_check" name="$pop_mail_check">
variable, which defaults to every 60 seconds.
If Mutt-ng was compiled with SSL support (by running the <em/configure/
newsserver via NNTP. You can open a newsgroup with function ``change-news-
group'' (default: i). Default newsserver can be obtained from _\bN_\bN_\bT_\bP_\bS_\bE_\bR_\bV_\bE_\bR envi-
ronment variable. Like other news readers, info about subscribed newsgroups is
- saved in file by _\b$_\bn_\be_\bw_\bs_\br_\bc (section , page ) variable. Article headers are
- cached and can be loaded from file when newsgroup entered instead loading from
- newsserver.
+ saved in file by _\b$_\bn_\bn_\bt_\bp_\b__\bn_\be_\bw_\bs_\br_\bc (section 6.3.155 , page 103) variable. Article
+ headers are cached and can be loaded from file when newsgroup entered instead
+ loading from newsserver.
_\b3_\b. _\bC_\bo_\bn_\bf_\bi_\bg_\bu_\br_\ba_\bt_\bi_\bo_\bn
_\b3_\b._\b2_\b7 _\bC_\bo_\bn_\bf_\bi_\bg_\bu_\br_\bi_\bn_\bg _\bf_\be_\ba_\bt_\bu_\br_\be_\bs _\bc_\bo_\bn_\bd_\bi_\bt_\bi_\bo_\bn_\ba_\bl_\bl_\by
- Usage: ifdef _\bi_\bt_\be_\bm _\bc_\bo_\bm_\bm_\ba_\bn_\bd Usage: ifndef _\bi_\bt_\be_\bm _\bc_\bo_\bm_\bm_\ba_\bn_\bd
+ Usage: ifdef _\bi_\bt_\be_\bm _\bc_\bo_\bm_\bm_\ba_\bn_\bd
- These command allows to test if a variable, function or certain feature is
- available or not respectively, before actually executing the command. ifdef
- (short for ``if defined) handles commands if upon availability while ifndef
+ Usage: ifndef _\bi_\bt_\be_\bm _\bc_\bo_\bm_\bm_\ba_\bn_\bd
+
+ These commands allow testing for a variable, function or certain feature being
The Mutt-ng E-Mail Client 33
- (short for ``if not defined'') does if not. The _\bc_\bo_\bm_\bm_\ba_\bn_\bd may be any valid frac-
- tion of a configuration file.
+ available or not respectively, before actually executing the command given.
+
+ ifdef (short for ``if defined'') only executes the command upon availability
+ while ifndef (short for ``if not defined'') does if not. The _\bc_\bo_\bm_\bm_\ba_\bn_\bd may be any
+ valid fraction of a configuration file.
- All names of variables and functions may be tested. Additionally, the following
- compile-features may be tested when prefixed with 'feature_': ncurses, slang,
- iconv, idn, dotlock, standalone, pop, nntp, imap, ssl, gnutls, sasl, sasl2,
- libesmtp, compressed, color, classic_pgp, classic_smime, gpgme, header_cache.
+ All names of variables, functions and menus may be tested. Additionally, the
+ following compile-features may be tested when prefixed with 'feature_':
+ ncurses, slang, iconv, idn, dotlock, standalone, pop, nntp, imap, ssl, gnutls,
+ sasl, sasl2, libesmtp, compressed, color, classic_pgp, classic_smime, gpgme,
+ header_cache, gdbm, qdbm and db4.
Examples follow.
- To only source a file with IMAP related settings only if IMAP support is com-
- piled in, use:
+ To only source a file with IMAP related settings if IMAP support is compiled
+ in, use:
ifdef feature_imap 'source ~/.mutt-ng/imap_setup'
# or
# or
# ...
- To only set the _\b<_\b$_\bi_\bm_\ba_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk (section 6.3.98 , page 87) when the system's
- SVN is recent enough to have it:
+ To only set the _\b$_\bi_\bm_\ba_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk (section 6.3.98 , page 87) variable if the
+ system's mutt-ng is aware of it, use:
- ifdef imap_mail_check 'set imap_mail_check=300'
+ ifdef imap_mail_check 'set imap_mail_check=500'
_\b3_\b._\b2_\b8 _\bR_\be_\bm_\bo_\bv_\bi_\bn_\bg _\bh_\bo_\bo_\bk_\bs
_\b4_\b._\b1 _\bR_\be_\bg_\bu_\bl_\ba_\br _\bE_\bx_\bp_\br_\be_\bs_\bs_\bi_\bo_\bn_\bs
- All string patterns in Mutt-ng including those in more complex _\bp_\ba_\bt_\bt_\be_\br_\bn_\bs (sec-
- tion 4.2 , page 36) must be specified using regular expressions (regexp) in
- the ``POSIX extended'' syntax (which is more or less the syntax used by egrep
- and GNU awk). For your convenience, we have included below a brief description
- of this syntax.
+ All string patterns in Mutt-ng including those in more complex _\bp_\ba_\bt_\bt_\be_\br_\bn_\bs
The Mutt-ng E-Mail Client 34
+ (section 4.2 , page 36) must be specified using regular expressions (regexp)
+ in the ``POSIX extended'' syntax (which is more or less the syntax used by
+ egrep and GNU awk). For your convenience, we have included below a brief
+ description of this syntax.
+
The search is case sensitive if the pattern contains at least one upper case
letter, and case insensitive otherwise. Note that ``\'' must be quoted if used
for a regular expression in an initialization command: ``\\''.
[:cntrl:]
Control characters.
+ The Mutt-ng E-Mail Client 35
+
[:digit:]
Numeric characters.
[:graph:]
- Characters that are both printable and visible. (A space is
-
- The Mutt-ng E-Mail Client 35
-
- printable, but not visible, while an ``a'' is both.)
+ Characters that are both printable and visible. (A space is print-
+ able, but not visible, while an ``a'' is both.)
[:lower:]
Lower-case alphabetic characters.
?
The preceding item is optional and matched at most once.
+ The Mutt-ng E-Mail Client 36
+
*
The preceding item will be matched zero or more times.
- The Mutt-ng E-Mail Client 36
-
+
The preceding item will be matched one or more times.
\\W
Matches any character that is not word-constituent.
+ The Mutt-ng E-Mail Client 37
+
\\`
Matches the empty string at the beginning of a buffer (string).
- The Mutt-ng E-Mail Client 37
-
\\'
Matches the empty string at the end of a buffer.
Polling for new mail is more expensive over POP3 than locally. For this reason
the frequency at which Mutt-ng will check for mail remotely can be controlled
- by the _\b$_\bp_\bo_\bp_\b__\bc_\bh_\be_\bc_\bk_\bi_\bn_\bt_\be_\br_\bv_\ba_\bl (section , page ) variable, which defaults to every
- 60 seconds.
+ by the _\b$_\bp_\bo_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk (section 6.3.207 , page 115) variable, which defaults
+ to every 60 seconds.
If Mutt-ng was compiled with SSL support (by running the _\bc_\bo_\bn_\bf_\bi_\bg_\bu_\br_\be script with
the _\b-_\b-_\bw_\bi_\bt_\bh_\b-_\bs_\bs_\bl flag), connections to POP3 servers can be encrypted. This natu-
Availability: NNTP
This variable controls how many news articles to cache per newsgroup (if
- caching is enabled, see _\b$_\bn_\be_\bw_\bs_\b__\bc_\ba_\bc_\bh_\be_\b__\bd_\bi_\br (section , page )) and how many news
- articles to show in the ``index'' menu.
+ caching is enabled, see _\b$_\bn_\bn_\bt_\bp_\b__\bc_\ba_\bc_\bh_\be_\b__\bd_\bi_\br (section 6.3.145 , page 100)) and how
+ many news articles to show in the ``index'' menu.
If there're more articles than defined with _\b$_\bn_\bn_\bt_\bp_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt (section 6.3.147 ,
page 101), all older ones will be removed/not shown in the index.
Kari Hurtta <kari.hurtta@fmi.fi> co-developed the original MIME parsing code
back in the ELM-ME days.
- The following people have been very helpful to the development of Mutt-ng:
+ The following people have been very helpful to the development of Mutt:
Vikas Agnihotri <vikasa@writeme.com>,
Vsevolod Volkov <vvv@lucky.net>,
- Ken Weinert <kenw@ihs.com> Andreas Krennmair <ak@synflood.at> Nico Golde
- <nico@ngolde.de> Rocco Rutte <pdmef@cs.tu-berlin.de>
+ Ken Weinert <kenw@ihs.com>
+
+ Mutt-ng is developed by the following people:
+
+ Andreas Krennmair <ak@synflood.at>
+
+ Nico Golde <nico@ngolde.de>
+
+ Rocco Rutte <pdmef@cs.tu-berlin.de>
+
+ The following people have been very helpful to the development of Mutt-ng:
+
+ Iain Lea <iain@bricbrac.de>
+
+ Andreas Kneib <akneib@gmx.net>
_\b7_\b._\b2 _\bA_\bb_\bo_\bu_\bt _\bt_\bh_\bi_\bs _\bd_\bo_\bc_\bu_\bm_\be_\bn_\bt