1 files changed, 93 insertions, 0 deletions
diff --git a/static/plan9-4e/man1/faces.1 b/static/plan9-4e/man1/faces.1
new file mode 100644
index 00000000..74c693da
--- /dev/null
+++ b/static/plan9-4e/man1/faces.1
@@ -0,0 +1,93 @@
+.TH FACES 1
+.SH NAME
+faces, seemail, vwhois \-  mailbox interface
+.SH SYNOPSIS
+.B faces
+[
+.B -ih
+]
+.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.
+.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
+.B /mail/fs/mbox
+or in the named mail directory upon startup.
+.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 "SEE ALSO"
+.IR mail (1),
+.IR plumber (4),
+.IR face (6),
+.IR plumb (6)