Subversion Repositories planix.SVN

Rev

Rev 2 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
2 - 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)