.TH INBOX 1
.SH NAME
inbox \-  mailbox interface
.SH SYNOPSIS
.B inbox
[
.B -m
.I maildir
]
.SH DESCRIPTION
The
.I inbox
command monitors incoming mail and displays in its
window a representation of the user's mailbox, along with
the current time. Each message in the mailbox is
represented by a small image and brief description of the
message. The image is typically a portrait of the sender or
an icon representing the sending domain. Which image to 
display is determined by two directories, $home/lib/face 
and /lib/face. Entries in $home/lib/face take priority over 
those in /lib/face. See 
.IR face (6),
for how these directories are organised. The description is
the sender's username, the message's date, and the subject.
.PP
If the user is running
.IR plumber (4),
.I inbox
reacts to plumb messages to the
.B seemail
port,
typically from
.BR upas/fs ,
and is thus notified of message additions and deletions.
.PP
Middle-clicking on a message selects it and causes
.I inbox
to display the string "Del | " followed by the message subject at
the top of its window. Middle-clicking on "Del" will delete the
selected message; most other clicks will de-select the message.
.PP
Right-clicking on a message causes that message to be `plumbed' to
.BR showmail .
A typical plumb action will be to display the message, such as by
the rule
.EX
    plumb start window mail -s $0
.EE
The
.IR acme (1)
mail reader listens to the
.B showmail
port automatically.
.PP
If the user is not running
.IR plumber ,
.I inbox
reads the log file
.F /sys/log/mail
and right-clicking has no effect.
.PP
If arrows are visible, clicking on them will scroll the display.
Middle-clicking on the arrows scrolls to the end.
.PP
The
.B -m
option directs
.I inbox
to watch for messages arriving in
.I maildir
instead of
.BR /mail/fs/mbox .
Multiple
.B -m
flags may be used to watch multiple mailboxes.
.SH FILES
.BR /mail/fs/mbox   "   mail directory.
.SH SOURCE
.B /n/sources/contrib/anothy/src/cmd/inbox
.SH "SEE ALSO"
.IR faces (1),
.IR mail (1),
.IR marshal (1),
.IR nedmail (1),
.IR plumber (4),
.IR face (6),
.IR plumb (6)
.br
The 9srv.net faces collection, described on the Plan 9 wiki at
.BR http://www.plan9.bell-labs.com/wiki/plan9/adding_your_face/index.html .
.SH BUGS
There are a pair of display refresh bug sometimes
triggered when messages message lines are added
or removed; scrolling the list will refresh things properly.