Rocco Rutte:

- documentation update, see <http://mutt-ng.berlios.de/manual/> too

git-svn-id: svn://svn.berlios.de/mutt-ng/trunk@340 e385b8ad-14ed-0310-8656-cc95a2468c6d

diff --git a/doc/manual.sgml.head b/doc/manual.sgml.head
index de7e84c..f11b711 100644 (file)
--- a/doc/manual.sgml.head
+++ b/doc/manual.sgml.head
@@ -739,12 +739,13 @@ See also the <ref id="postpone" name="&dollar;postpone"> quad-option.
 <sect1>Reading news via NNTP<label id="reading_news">
 <p>
 
 <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="&dollar;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="&dollar;nntp&lowbar;newsrc"> variable. Article 
+headers are cached and can be loaded from file when

 newsgroup entered instead loading from newsserver.
 
 <sect>Configuration
 newsgroup entered instead loading from newsserver.
 
 <sect>Configuration


@@ -1747,24 +1748,34 @@ considered to be an executable program from which to read input (eg.
 
 <sect1>Configuring features conditionally<label id="ifdef">
 <p>
 
 <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/
 
 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.
 
 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.
 
 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'
 compiled in, use:
 <tscreen><verb>
 ifdef feature_imap 'source ~/.mutt-ng/imap_setup'


@@ -1774,6 +1785,7 @@ ifdef feature_imap 'source ~/.mutt-ng/imap_setup'
 # ...
 </verb></tscreen>
 
 # ...
 </verb></tscreen>
 

+<p>

 To exit mutt-ng directly if no NNTP support is compiled in:
 <tscreen><verb>
 ifndef feature_nntp 'push q'
 To exit mutt-ng directly if no NNTP support is compiled in:
 <tscreen><verb>
 ifndef feature_nntp 'push q'


@@ -1783,11 +1795,12 @@ ifndef feature_nntp 'push q'
 # ...
 </verb></tscreen>
 
 # ...
 </verb></tscreen>
 

-To only set the <ref id="imap_mail_check"
-name="&lt;&dollar;imap&lowbar;mail&lowbar;check"> when the system's SVN
-is recent enough to have it:
+<p>
+To only set the <ref id="imap_mail_check" 
+name="&dollar;imap&lowbar;mail&lowbar;check"> variable if
+the system's mutt-ng is aware of it, use:

 <tscreen><verb>
 <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">
 </verb></tscreen>
 
 <sect1>Removing hooks<label id="unhook">


@@ -2559,7 +2572,7 @@ You can also specify different username for each folder, i.e.:
 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
 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="&dollar;pop&lowbar;checkinterval">
+<ref id="pop_mail_check" name="&dollar;pop&lowbar;mail&lowbar;check">

 variable, which defaults to every 60 seconds.
 
 If Mutt-ng was compiled with SSL support (by running the <em/configure/
 variable, which defaults to every 60 seconds.
 
 If Mutt-ng was compiled with SSL support (by running the <em/configure/

diff --git a/doc/manual.sgml.tail b/doc/manual.sgml.tail
index 0a0a1c4..947e365 100644 (file)
--- a/doc/manual.sgml.tail
+++ b/doc/manual.sgml.tail
@@ -338,7 +338,7 @@ Kari Hurtta
 <htmlurl url="mailto:kari.hurtta@fmi.fi" name="&lt;kari.hurtta@fmi.fi&gt;">
 co-developed the original MIME parsing code back in the ELM-ME days.
 
 <htmlurl url="mailto:kari.hurtta@fmi.fi" name="&lt;kari.hurtta@fmi.fi&gt;">
 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 <htmlurl url="mailto:vikasa@writeme.com" name="&lt;vikasa@writeme.com&gt;">,<newline>
 Francois Berjon <htmlurl url="mailto:Francois.Berjon@aar.alcatel-alsthom.fr" name="&lt;Francois.Berjon@aar.alcatel-alsthom.fr&gt;">,<newline>
 
 Vikas Agnihotri <htmlurl url="mailto:vikasa@writeme.com" name="&lt;vikasa@writeme.com&gt;">,<newline>
 Francois Berjon <htmlurl url="mailto:Francois.Berjon@aar.alcatel-alsthom.fr" name="&lt;Francois.Berjon@aar.alcatel-alsthom.fr&gt;">,<newline>


@@ -381,11 +381,17 @@ Allain Thivillon <htmlurl url="mailto:Allain.Thivillon@alma.fr" name="&lt;Allain
 Gero Treuner <htmlurl url="mailto:gero@faveve.uni-stuttgart.de" name="&lt;gero@faveve.uni-stuttgart.de&gt;">,<newline>
 Vsevolod Volkov <htmlurl url="mailto:vvv@lucky.net" name="&lt;vvv@lucky.net&gt;">,<newline>
 Ken Weinert <htmlurl url="mailto:kenw@ihs.com" name="&lt;kenw@ihs.com&gt;">
 Gero Treuner <htmlurl url="mailto:gero@faveve.uni-stuttgart.de" name="&lt;gero@faveve.uni-stuttgart.de&gt;">,<newline>
 Vsevolod Volkov <htmlurl url="mailto:vvv@lucky.net" name="&lt;vvv@lucky.net&gt;">,<newline>
 Ken Weinert <htmlurl url="mailto:kenw@ihs.com" name="&lt;kenw@ihs.com&gt;">

-Andreas Krennmair <htmlurl url="mailto:ak@synflood.at" name="&lt;ak@synflood.at&gt;">
-Nico Golde <htmlurl url="mailto:nico@ngolde.de" name="&lt;nico@ngolde.de&gt;">
+
+Mutt-ng is developed by the following people:
+
+Andreas Krennmair <htmlurl url="mailto:ak@synflood.at" name="&lt;ak@synflood.at&gt;"><newline>
+Nico Golde <htmlurl url="mailto:nico@ngolde.de" name="&lt;nico@ngolde.de&gt;"<newline>

 Rocco Rutte <htmlurl url="mailto:pdmef@cs.tu-berlin.de" name="&lt;pdmef@cs.tu-berlin.de&gt;">
 
 Rocco Rutte <htmlurl url="mailto:pdmef@cs.tu-berlin.de" name="&lt;pdmef@cs.tu-berlin.de&gt;">
 

+The following people have been very helpful to the development of  Mutt-ng:

 
 

+Iain Lea <htmlurl url="mailto:iain@bricbrac.de" name="&lt;iain@bricbrac.de&gt;"><newline>
+Andreas Kneib <htmlurl url="mailto:akneib@gmx.net" name="&lt;akneib@gmx.net&gt;">

 
 <sect1>About this document
 <p>
 
 <sect1>About this document
 <p>

diff --git a/doc/manual.txt b/doc/manual.txt
index 8f11ccd..e87de1e 100644 (file)
--- a/doc/manual.txt
+++ b/doc/manual.txt
@@ -721,9 +721,9 @@
        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
        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.  _\bC_\bo_\bn_\bf_\bi_\bg_\bu_\br_\ba_\bt_\bi_\bo_\bn
 


@@ -1712,26 +1712,30 @@
 
        _\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
 
 
        _\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
 
 
        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.
 
 
        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
 
             ifdef feature_imap 'source ~/.mutt-ng/imap_setup'
             # or


@@ -1747,10 +1751,10 @@
             # 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
 
 
        _\b3_\b._\b2_\b8  _\bR_\be_\bm_\bo_\bv_\bi_\bn_\bg _\bh_\bo_\bo_\bk_\bs
 


@@ -1765,14 +1769,15 @@
 
        _\b4_\b._\b1  _\bR_\be_\bg_\bu_\bl_\ba_\br _\bE_\bx_\bp_\br_\be_\bs_\bs_\bi_\bo_\bn_\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
 
 
        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: ``\\''.
        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: ``\\''.


@@ -1822,15 +1827,14 @@
              [:cntrl:]
                    Control characters.
 
              [:cntrl:]
                    Control characters.
 

+       The Mutt-ng E-Mail Client                                                    35
+

              [:digit:]
                    Numeric characters.
 
              [:graph:]
              [: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.
 
              [:lower:]
                    Lower-case alphabetic characters.


@@ -1880,11 +1884,11 @@
              ?
                    The preceding item is optional and matched at most once.
 
              ?
                    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 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.
 
              +
                    The preceding item will be matched one or more times.
 


@@ -1935,11 +1939,11 @@
              \\W
                    Matches any character that is not word-constituent.
 
              \\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).
 
              \\`
                    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.
 
              \\'
                    Matches the empty string at the end of a buffer.
 


@@ -2497,8 +2501,8 @@
 
        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
 
        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-
 
        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-


@@ -5517,8 +5521,8 @@
        Availability: NNTP
 
        This variable controls how many news articles to cache per newsgroup (if
        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.
 
        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.


@@ -8446,7 +8450,7 @@
        Kari Hurtta <kari.hurtta@fmi.fi> co-developed the original MIME parsing code
        back in the ELM-ME days.
 
        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>,
 
 
        Vikas Agnihotri <vikasa@writeme.com>,
 


@@ -8530,8 +8534,21 @@
 
        Vsevolod Volkov <vvv@lucky.net>,
 
 
        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
 
 
        _\b7_\b._\b2  _\bA_\bb_\bo_\bu_\bt _\bt_\bh_\bi_\bs _\bd_\bo_\bc_\bu_\bm_\be_\bn_\bt