.TH LSMBOXRC 5 "Apr 16, 2006" "David Weinehall"

.SH NAME
lsmboxrc \- configuration file for lsmbox

.SH DESCRIPTION
A
.B lsmbox
configuration file consists of a list of configuration
options and their setting.
The hash mark ("#") is used as a "comment" character.
Every line beginning with a comment character is ignored.
Whitespace is also ignored.

.SH COMMANDS
.TP
.B set variable=value
Set a configuration variable to the specified value.
.TP
.B unset variable
Unset a configuration variable.
This implies that the built-in default will be used instead.
.TP
.B mailboxes filename...
Specifies what mailboxes to check.
You can have one or several of these lines.
Each line can contain the name of one or more mailboxes, each
separated by a space.

A filename of \fI!\fP denotes your inbox.
A leading ("=") or ("+") in a filename will be expanded into
the path to your mail-directory.

.SH CONFIGURATION VARIABLES
.TP
.B folder
The path to your mail-directory; this is usually \fI$HOME/Mail/\fP.
.TP
.B lsmbox_mail_command
Specifies what command to execute when the user selects a
mailbox in continuous mode.
.TP
.B mark_old
Specifies whether or not old unread messages and new messages
should be accounted separately.
If you explicitly unset this variable using the \fBunset\fP
command, the number of new and old messages will be added
together as unread messages, otherwise they will be accounted
as new and old respectively.
.TP
.B mh_seq_unseen
Specifies the string used in the
.I .mh_sequences
file to list new/old unread messages.
If this variable is not set, or explicitly unset, "unseen" will
be used.
.TP
.B spoolfile
The path to where the system keeps your inbox;
usually \fI/var/mail/USERNAME\fP or
\fI/var/spool/mail/USERNAME\fP.
.TP
.B lsmbox_padding
The width of the mailbox column.  To never add additional
padding beyond what's needed to align all values, specify '0'
here.

.SH COMMENTS
You cannot specify a path or mailbox that contains whitespace
characters (space, newline, etc.)
Do not bug me about this.
Having such filenames/pathnames is stupid anyway.

I've deliberately tried to use the same syntax as
.B mutt
uses for its configuration-file \fImuttrc\fP
whenever possible, to facilitate
sourcing of \fI$HOME/.lsmboxrc\fP from your
\fI$HOME/.muttrc\fP.
.B lsmbox_mail_command
will, however, cause
.B mutt
to emit an error.

.SH SEE ALSO
.BR lsmbox (1),
.BR muttrc (5)

.SH HISTORY
Apr 16 2006: Updated for v2.1.0 of lsmbox.
.br
Apr 16 2004: Updated for v2.0.0 of lsmbox.
.br
Mar 13 2004: Updated for v1.9.0 of lsmbox.
.br
Jan 16 2003: Minor fixes.
.br
Jan 06 2003: Minor fixes.
.br
Dec 09 2002: Minor fixes.
.br
Nov 15 2002: Updated for v1.6.0 of lsmbox.
.br
Nov 13 2002: Add note about '+' and '='.
.br
Nov 06 2002: Minor changes.
.br
Nov 04 2002: Minor change.
.br
Oct 29 2002: Fixed a typo.
.br
Oct 28 2002: Fixed a typo.
.br
Oct 26 2002: Updated for v1.1.0 of lsmbox.
.br
Oct 26 2002: Updated for v1.0.1 of lsmbox.
.br
Oct 21 2002: Initial release.

.SH AUTHOR
lsmbox and its manual-pages are written by
David Weinehall <\fItao@acc.umu.se\fP>

.SH REPORTING BUGS
Report bugs to
<\fItao@acc.umu.se\fP>.

.SH COPYRIGHT
Copyright \(co 2002-2006 David Weinehall
.br
This is free software; see the source for copying conditions.
There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR
A PARTICULAR PURPOSE.