.TH FACES 1.SH NAMEfaces, seemail, vwhois \- mailbox interface.SH SYNOPSIS.B faces[.B -ih] [.B -m.I maildir].br.B seemail.br.B vwhois.I person\&....SH DESCRIPTIONThe.I facescommand monitors incoming mail anddisplays in its window a representation of the user's mail boxusing a small image for each message.The image is typically a portrait of the sender. Which image to display is determined by two directories /usr/$user/lib/face and /lib/face. Entries in /usr/$user/lib/face take priority over those in /lib/face. See .IR face (6),for how these directories are organised..PPIf the user is running.IR plumber (4),.I facesreacts to plumb messages to the.B seemailport,typically from.BR upas/fs ,and is thus notified of message additions and deletions..PPRight-clicking on a message icon causes that message to be `plumbed' to.BR showmail .A typical plumb action will be to display the message, such as bythe rule.EX plumb start window mail -s $0.EEThe.IR acme (1)mail reader listens to the.B showmailport automatically..PPIf the user is not running.IR plumber ,.I facesreads the log file.F /sys/log/mailand right-clicking has no effect..PPIf arrows are visible, clicking on them will scroll the display.Middle-clicking on the arrows scrolls to the end..PPStarting.B faceswith the.B -iflag causes.B facesto read the messages in.BR /mail/fs/mbox— or the mailboxes specified with the.B -mflag —upon startup..PPThe.B -moption directs.I facesto watch for messages arriving in.I maildirinstead of.BR /mail/fs/mbox .Multiple.B -mflags may be used to watch multiple mailboxes..PPThe.B -hflag causes a different, venerable behavior in whichthe window displays the history of messages receivedrather than the current state of the mail box.In particular, faces are not removed from the screen when messages are deleted.Also, in this mode clicking button 1 in the display will clear the window..PP.I Seemailis an.IR rc (1)script that invokes.B faces.BR -h ..PP.I Vwhoistells.I facesto display the icons of the named.IR persons ,without sending a message..SH FILES.BR /mail/fs/mbox " mail directory..SH SOURCE.B /sys/src/cmd/faces.br.B /rc/bin/seemail.br.B /rc/bin/vwhois.SH "SEE ALSO".IR mail (1),.IR marshal (1),.IR nedmail (1),.IR plumber (4),.IR face (6),.IR plumb (6)
.TH FACES 1
.SH NAME
faces, seemail, vwhois \- mailbox interface
.SH SYNOPSIS
.B faces
[
.B -ih
] [
.B -m
.I maildir
]
.br
.B seemail
.br
.B vwhois
.I person
\&...
.SH DESCRIPTION
The
.I faces
command monitors incoming mail and
displays in its window a representation of the user's mail box
using a small image for each message.
The image is typically a portrait of the sender. Which image to
display is determined by two directories /usr/$user/lib/face
and /lib/face. Entries in /usr/$user/lib/face take priority over
those in /lib/face. See
.IR face (6),
for how these directories are organised.
.PP
If the user is running
.IR plumber (4),
.I faces
reacts to plumb messages to the
.B seemail
port,
typically from
.BR upas/fs ,
and is thus notified of message additions and deletions.
.PP
Right-clicking on a message icon 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 faces
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
Starting
.B faces
with the
.B -i
flag causes
.B faces
to read the messages in
.BR /mail/fs/mbox
— or the mailboxes specified with the
.B -m
flag —
upon startup.
.PP
The
.B -m
option directs
.I faces
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.
.PP
The
.B -h
flag causes a different, venerable behavior in which
the window displays the history of messages received
rather than the current state of the mail box.
In particular, faces are not removed from the screen when messages are deleted.
Also, in this mode clicking button 1 in the display will clear the window.
.PP
.I Seemail
is an
.IR rc (1)
script that invokes
.B faces
.BR -h .
.PP
.I Vwhois
tells
.I faces
to display the icons of the named
.IR persons ,
without sending a message.
.SH FILES
.BR /mail/fs/mbox " mail directory.
.SH SOURCE
.B /sys/src/cmd/faces
.br
.B /rc/bin/seemail
.br
.B /rc/bin/vwhois
.SH "SEE ALSO"
.IR mail (1),
.IR marshal (1),
.IR nedmail (1),
.IR plumber (4),
.IR face (6),
.IR plumb (6)