FACES(1)                                                 FACES(1)

     NAME
          faces, seemail, vwhois -  mailbox interface

     SYNOPSIS
          faces [ -ih ] [ -m maildir ]
          seemail
          vwhois person ...

     DESCRIPTION
          The 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 face(6), for how these directories are organised.

          If the user is running plumber(4), faces reacts to plumb
          messages to the seemail port, typically from upas/fs, and is
          thus notified of message additions and deletions.

          Right-clicking on a message icon causes that message to be
          `plumbed' to showmail.  A typical plumb action will be to
          display the message, such as by the rule
              plumb start window mail -s $0
          The acme(1) mail reader listens to the showmail port auto-
          matically.

          If the user is not running plumber, faces reads the log file
          and right-clicking has no effect.

          If arrows are visible, clicking on them will scroll the dis-
          play.  Middle-clicking on the arrows scrolls to the end.

          Starting faces with the -i flag causes faces to read the
          messages in /mail/fs/mbox — or the mailboxes specified with
          the -m flag — upon startup.

          The -m option directs faces to watch for messages arriving
          in maildir instead of /mail/fs/mbox.  Multiple -m flags may
          be used to watch multiple mailboxes.

          The -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 dis-
          play will clear the window.

          Seemail is an rc(1) script that invokes faces -h.

     Page 1                       Plan 9            (printed 12/26/24)

     FACES(1)                                                 FACES(1)

          Vwhois tells faces to display the icons of the named
          persons, without sending a message.

     FILES
          /mail/fs/mbox   mail directory.

     SOURCE
          /sys/src/cmd/faces
          /rc/bin/seemail
          /rc/bin/vwhois

     SEE ALSO
          mail(1), marshal(1), nedmail(1), plumber(4), face(6),
          plumb(6)

     Page 2                       Plan 9            (printed 12/26/24)