faces 2.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124
  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)