sys/man/1/faces

   1 .TH FACES 1
   2 .SH NAME
   3 faces, seemail, vwhois \-  mailbox interface
   4 .SH SYNOPSIS
   5 .B faces
   6 [
   7 .B -ih
   8 ] [
   9 .B -m
  10 .I maildir
  11 ]
  12 .br
  13 .B seemail
  14 .br
  15 .B vwhois
  16 .I person
  17 \&...
  18 .SH DESCRIPTION
  19 The
  20 .I faces
  21 command monitors incoming mail and
  22 displays in its window a representation of the user's mail box
  23 using a small image for each message.
  24 The image is typically a portrait of the sender. Which image to
  25 display is determined by two directories /usr/$user/lib/face
  26 and /lib/face. Entries in /usr/$user/lib/face take priority over
  27 those in /lib/face. See
  28 .IR face (6),
  29 for how these directories are organised.
  30 .PP
  31 If the user is running
  32 .IR plumber (4),
  33 .I faces
  34 reacts to plumb messages to the
  35 .B seemail
  36 port,
  37 typically from
  38 .BR upas/fs ,
  39 and is thus notified of message additions and deletions.
  40 .PP
  41 Right-clicking on a message icon causes that message to be `plumbed' to
  42 .BR showmail .
  43 A typical plumb action will be to display the message, such as by
  44 the rule
  45 .EX
  46     plumb start window mail -s $0
  47 .EE
  48 The
  49 .IR acme (1)
  50 mail reader listens to the
  51 .B showmail
  52 port automatically.
  53 .PP
  54 If the user is not running
  55 .IR plumber ,
  56 .I faces
  57 reads the log file
  58 .F /sys/log/mail
  59 and right-clicking has no effect.
  60 .PP
  61 If arrows are visible, clicking on them will scroll the display.
  62 Middle-clicking on the arrows scrolls to the end.
  63 .PP
  64 Starting
  65 .B faces
  66 with the
  67 .B -i
  68 flag causes
  69 .B faces
  70 to read the messages in
  71 .BR /mail/fs/mbox
  72 — or the mailboxes specified with the
  73 .B -m
  74 flag —
  75 upon startup.
  76 .PP
  77 The
  78 .B -m
  79 option directs
  80 .I faces
  81 to watch for messages arriving in
  82 .I maildir
  83 instead of
  84 .BR /mail/fs/mbox .
  85 Multiple
  86 .B -m
  87 flags may be used to watch multiple mailboxes.
  88 .PP
  89 The
  90 .B -h
  91 flag causes a different, venerable behavior in which
  92 the window displays the history of messages received
  93 rather than the current state of the mail box.
  94 In particular, faces are not removed from the screen when messages are deleted.
  95 Also, in this mode clicking button 1 in the display will clear the window.
  96 .PP
  97 .I Seemail
  98 is an
  99 .IR rc (1)
 100 script that invokes
 101 .B faces
 102 .BR -h .
 103 .PP
 104 .I Vwhois
 105 tells
 106 .I faces
 107 to display the icons of the named
 108 .IR persons ,
 109 without sending a message.
 110 .SH FILES
 111 .BR /mail/fs/mbox   "   mail directory.
 112 .SH SOURCE
 113 .B /sys/src/cmd/faces
 114 .br
 115 .B /rc/bin/seemail
 116 .br
 117 .B /rc/bin/vwhois
 118 .SH "SEE ALSO"
 119 .IR mail (1),
 120 .IR marshal (1),
 121 .IR nedmail (1),
 122 .IR plumber (4),
 123 .IR face (6),
 124 .IR plumb (6)