Package: mutt
Version: 1.5.17-2
Severity: minor
Tags: patch

The current documentation for the sidebar patch is only in
/usr/share/doc/mutt/README.Patches. Apparently it is also out of date
wrt
http://www.lunar-linux.org/index.php?option=com_content&task=view&id=44
(the sidebar patch homepage).

The attached patch ships an extra mutt sample configuration file as
/usr/share/doc/mutt/examples/sidebar.muttrc(.gz)?, shamelessly copied
from the above URL. Looking at it, in the spirit of other muttrc
configuration files, it is trivial to understand how to configure
properly the sidebar feature.

At the end of the file there is the various option documentation, still
copied from the above URL. You might consider moving that part to
/usr/share/doc/mutt/README.Patches, bringing the sidebar part of that
file up to date.

TIA,
Cheers.

-- System Information:
Debian Release: lenny/sid
  APT prefers unstable
  APT policy: (500, 'unstable'), (500, 'testing'), (1, 'experimental')
Architecture: i386 (i686)

Kernel: Linux 2.6.22-3-686 (SMP w/1 CPU core)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/bash

Versions of packages mutt depends on:
ii  libc6                    2.7-5           GNU C Library: Shared libraries
ii  libgdbm3                 1.8.3-3         GNU dbm database routines (runtime
ii  libgnutls13              2.0.4-1         the GNU TLS library - runtime libr
ii  libidn11                 1.1-1           GNU libidn library, implementation
ii  libncursesw5             5.6+20071215-1  Shared libraries for terminal hand
ii  libsasl2-2               2.1.22.dfsg1-17 Cyrus SASL - authentication abstra

Versions of packages mutt recommends:
ii  locales-all [locales]         2.7-5      GNU C Library: Precompiled locale 
ii  mime-support                  3.40-1     MIME files 'mime.types' & 'mailcap
ii  postfix [mail-transport-agent 2.4.6-4    High-performance mail transport ag

-- no debconf information
diff -Naur mutt-1.5.17.orig/debian/extra/samples/sidebar.muttrc 
mutt-1.5.17/debian/extra/samples/sidebar.muttrc
--- mutt-1.5.17.orig/debian/extra/samples/sidebar.muttrc        1970-01-01 
01:00:00.000000000 +0100
+++ mutt-1.5.17/debian/extra/samples/sidebar.muttrc     2008-01-12 
20:41:39.000000000 +0100
@@ -0,0 +1,74 @@
+# shamelessly copied from
+# http://www.lunar-linux.org/index.php?option=com_content&task=view&id=44
+
+# set up the sidebar, default not visible
+set sidebar_width=12
+set sidebar_visible=no
+set sidebar_delim='|'
+
+# which mailboxes to list in the sidebar
+mailboxes =inbox =ml
+
+# color of folders with new mail
+color sidebar_new yellow default
+
+# ctrl-n, ctrl-p to select next, prev folder
+# ctrl-o to open selected folder
+bind index \CP sidebar-prev
+bind index \CN sidebar-next
+bind index \CO sidebar-open
+bind pager \CP sidebar-prev
+bind pager \CN sidebar-next
+bind pager \CO sidebar-open
+
+# I don't need these. just for documentation purposes. See below.
+# sidebar-scroll-up
+# sidebar-scroll-down
+
+# b toggles sidebar visibility
+macro index b '<enter-command>toggle sidebar_visible<enter>'
+macro pager b '<enter-command>toggle sidebar_visible<enter>'
+
+# Remap bounce-message function to "B"
+bind index B bounce-message
+
+#
+# Mario Holbe suggests:
+# macro index b '<enter-command>toggle sidebar_visible<enter><refresh>'
+# macro pager b '<enter-command>toggle sidebar_visible<enter><redraw-screen>'
+# 
+
+
+# Documentation
+# =============
+#
+# sidebar_width (number)
+# Width of the sidebar.
+# 
+# sidebar_visible (boolean)
+# Whether or not the sidebar is visible.
+# 
+# sidebar_delim (string)
+# Specifies the delimiter between the sidebar and other screens
+# 
+# color sidebar_new [fg] [bg]
+# The foreground (fg) and background (bg) color of folders that contain new
+# mail.
+# 
+# sidebar-prev
+# Mutt's name for the operation that selects the previous folder.
+# 
+# sidebar-next
+# Mutt's name for the operation that selects the next folder.
+# 
+# sidebar-open
+# Mutt's name for the operation that opens the currently selected folder.
+# 
+# sidebar-scroll-up
+# Only useful if you have more folders than lines in your terminal: scrolls one
+# page up through the list of folders.
+# 
+# sidebar-scroll-down
+# Only useful if you have more folders than lines in your terminal: scrolls one
+# page down through the list of folders. 
+#

Reply via email to