Andreas Krennmair:

	added a few bits to the documentation.

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

diff --git a/doc/manual.sgml.head b/doc/manual.sgml.head
index 017dd5b..3681ac0 100644 (file)
--- a/doc/manual.sgml.head
+++ b/doc/manual.sgml.head
@@ -19,31 +19,37 @@ features like key bindings, keyboard macros, mail threading, regular
 expression searches and a powerful pattern matching language for selecting
 groups of messages.
 
+<p>This documentation additionaly contains documentation to <bf/Mutt-NG/, a 
+fork from Mutt with the goal to fix all the little annoyances of Mutt, to
+integrate all the Mutt patches that are floating around in the web, and to
+add other new features. Features specific to Mutt-ng will be discussed in
+an extra section. Don't be confused when most of the documentation talk about
+Mutt and not Mutt-ng, Mutt-ng contains all Mutt-ng features, plus many more.
+
 <sect1>Mutt Home Page
 <p>
 <htmlurl url="http://www.mutt.org/"
 name="http://www.mutt.org/">
 
+<sect1>Mutt-ng Home Page
+<p>
+<htmlurl url="http://mutt-ng.berlios.de/"
+name="http://mutt-ng.berlios.de/">
+
 <sect1>Mailing Lists
 <p>
-To subscribe to one of the following mailing lists, send a message with the
-word <em/subscribe/ in the body to
-<tt/list-name/<em/-request/<tt/@mutt.org/.
 
 <itemize>
-<item><htmlurl url="mailto:mutt-announce-request@mutt.org"
-name="mutt-announce@mutt.org"> -- low traffic list for announcements
-<item><htmlurl url="mailto:mutt-users-request@mutt.org"
-name="mutt-users@mutt.org"> -- help, bug reports and feature requests
-<item><htmlurl url="mailto:mutt-dev-request@mutt.org" name="mutt-dev@mutt.org"> -- development mailing list
+<item><htmlurl url="https://lists.berlios.de/mailman/listinfo/mutt-ng-users"
+name="mutt-ng-users@lists.berlios.de"> -- This is where the mutt-ng user support happens.
+<item><htmlurl url="https://lists.berlios.de/mailman/listinfo/mutt-ng-devel" name="mutt-ng-devel@lists.berlios.de"> -- The development mailing list for mutt-ng
 </itemize>
 
-<bf/Note:/ all messages posted to <em/mutt-announce/ are automatically
-forwarded to <em/mutt-users/, so you do not need to be subscribed to both
-lists.
-
 <sect1>Software Distribution Sites
 <p>
+So far, there are no official releases of Mutt-ng, but you can download
+daily snapshots from <htmlurl url="http://mutt-ng.berlios.de/snapshots/" name="http://mutt-ng.berlios.de/snapshots/">
+<!-- 
 <itemize>
 <item><htmlurl url="ftp://ftp.mutt.org/mutt/"
 name="ftp://ftp.mutt.org/mutt/">
@@ -52,16 +58,22 @@ name="ftp://ftp.mutt.org/mutt/">
 For a list of mirror sites, please refer to <htmlurl
 url="http://www.mutt.org/download.html"
 name="http://www.mutt.org/download.html">.
+-->
 
+<!--
 <sect1>IRC
 <p>
 Visit channel <em/#mutt/ on <htmlurl
 url="http://www.freenode.net/" name="irc.freenode.net
 (www.freenode.net)"> to chat with other people interested in Mutt.
+-->
 
-<sect1>USENET
+<sect1>Weblog
 <p>
-See the newsgroup <htmlurl url="news:comp.mail.mutt" name="comp.mail.mutt">.
+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 
+<htmlurl url="http://mutt-ng.supersized.org/" name="Mutt-ng development weblog">.
 
 <sect1>Copyright
 <p>
@@ -736,20 +748,20 @@ newsgroup entered instead loading from newsserver.
 <sect>Configuration
 <p>
 
-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'' <ref id="commandline"
-name="command line"> option is specified.  This file is typically
-<tt>/usr/local/share/mutt/Muttrc</tt> or <tt>/etc/Muttrc</tt>. Mutt
-will next look for a file named <tt>.muttrc</tt> in your home
-directory.  If this file does not exist and your home directory has
-a subdirectory named <tt/.mutt/, mutt try to load a file named
-<tt>.mutt/muttrc</tt>. 
+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'' <ref
+id="commandline" name="command line"> option is specified.  This file is
+typically <tt>/usr/local/share/mutt/Muttrc</tt> or <tt>/etc/Muttrc</tt>,
+Mutt-ng users will find this file in <tt>/usr/local/share/muttng/Muttrc</tt> or
+<tt>/etc/Muttngrc</tt>. Mutt will next look for a file named <tt>.muttrc</tt>
+in your home directory, Mutt-ng will look for <tt>.muttngrc</tt>.  If this file
+does not exist and your home directory has a subdirectory named <tt/.mutt/,
+mutt try to load a file named <tt>.mutt/muttrc</tt>. 
 
-<tt>.muttrc</tt> is the file where you will usually place your <ref
- id="commands" name="commands"> to configure Mutt.
+<tt>.muttrc</tt> (or <tt>.muttngrc</tt> for Mutt-ng) is the file where you will
+usually place your <ref id="commands" name="commands"> 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
@@ -2164,17 +2176,17 @@ pattern is translated at the time the hook is declared, so the value of
 <ref id="default_hook" name="&dollar;default&lowbar;hook"> that is in effect
 at that time will be used.
 
-<sect1>Usind the sidebar<label id="sidebar">
+<sect1>Usingg the sidebar<label id="sidebar">
 <p>
-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:
 <tscreen><verb>
 set sidebar_visible="yes"
 set sidebar_width=25
-</tscreen></verb>
+</verb></tscreen>
 
 If you want to specify the mailboxes you can do so with:
 <tscreen><verb>
@@ -2183,12 +2195,12 @@ mailboxes INBOX \
           MBOX1 \
           MBOX2 \
           ...
-</tscreen></verb>
+</verb></tscreen>
 
 You can also specify the colors for mailboxes with new mails by using:
 <tscreen><verb>
 color sidebar_new red black
-</tscreen></verb>
+</verb></tscreen>
 
 The available functions are:
 <tscreen><verb>
@@ -2200,6 +2212,22 @@ sidebar-previous       Hilights the previous mailbox
 sidebar-open           Opens the currently hilighted mailbox
 </tscreen></verb>
 
+Reasonable key bindings look e.g. like this:
+<tscreen><verb>
+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'
+</verb></tscreen>
+
+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'.
+
 <sect1>External Address Queries<label id="query">
 <p>
 Mutt supports connecting to external directory databases such as LDAP,