Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XMAILWATCHER(1)		    General Commands Manual	       XMAILWATCHER(1)

NAME
       xmailwatcher -- periodically check for mail

SYNOPSIS
       xmailwatcher [-toolkitoption ...] [-option ...]

DESCRIPTION
       xmailwatcher  checks  the user's	mailbox	periodically.  If there	is new
       mail, or	optionally if there is any mail	at all,	the user is  notified.
       Two  methods  of	 display are used: if the application is in the	iconic
       state the icon window displays a	nomail or mail bitmap, with foreground
       and background values inverted by default in the	latter	case;  if  the
       application  is non-iconic a list of senders and	subjects is displayed,
       with a vertical scrollbar if necessary.

       xmailwatcher will attempt to decode RFC 1522  Q-encoded	headers,  pro-
       vided a suitable	ISO8859	font is	being used.  Due to limitations	of the
       Label  widget  used  to	display	the list of messages, each instance of
       xmailwatcher is able to decode only one	class  of  ISO8859-n  encoding
       (the default is ISO8859-1).

       xmailwatcher  understands both sendmail and MMDF	formats	of mailbox au-
       tomatically.

OPTIONS
       xmailwatcher accepts all	of the standard	toolkit	command	line  options.
       In addition, the	following are accepted:

       -allmail	(or -allMail)
	       Report  whenever	 there is any mail in the mailbox.  By default
	       only new	mail is	reported.  Sets	the .newMail  application  re-
	       source to False.

       -doMime (and -noMime)
	       Controls	whether	RFC1522	should be decoded or not.  The default
	       is to attempt to	decode.

       -icongeometry geometryspec (or -iconGeometry)
	       Specifies  the  geometry	 for the icon window.  Sets the	.icon-
	       Shell.geometry resource.

       -mailbox	mailboxname
	       Specifies the name of the mailbox to  be	 polled	 (defaults  to
	       .mail  in the user's current directory).	 Sets the .mailbox ap-
	       plication resource.

       -newmail	(or -newMail)
	       Report only new mail in the mailbox (the	 default).   Sets  the
	       .newMail	application resource to	True.

       -poll pollinterval
	       Specifies  the  interval	 in seconds between successive mailbox
	       checks (defaults	to 67 seconds).	 Sets the .pollInterval	appli-
	       cation resource.

       -silent Don't ring the bell when	new mail arrives.   Sets  the  .silent
	       application resource to True.

       -soundfile soundFileName	(or -soundFile)
	       If  on a	Sun-4, attempt to copy soundFileName to	/dev/audio in-
	       stead of	ringing	the bell.  NOTE	that the audio device  on  the
	       client  host is used, not the server host, so you don't want to
	       do this if you're using an X-terminal.  Sets the	.soundFile ap-
	       plication resource.

WIDGET HIERARCHY
       xmailwatcher has	the following widget hierarchy:

	    MailWatcher	xmailwatcher
		 Viewport viewport
		      Label messages
		 TransientShell	iconShell
		      Label icon

X DEFAULTS
       In addition to the usual	resources and classes used by the  widgets  in
       its  hierarchy,	xmailwatcher understands the following application re-
       sources:

       bellVolume (class BellVolume)
	       Specifies the volume with which the bell	should	be  rung  when
	       mail  arrives  (default	zero).	See the	Xlib documentation for
	       details.

       bufferSize (class BufferSize)
	       Defines the size	of the buffer used to hold the	sender/subject
	       details (default	8K).

       doMime (class DoMime)
	       If True (the default) attempt to	decode RFC1522 Q-encoding.

       fullNames (class	FullNames)
	       If True,	display	the full text of the "From:" header.  If False
	       (the  default),	attempt	to extract the sender's	real name from
	       the "From:" header.

       iconBackground (class Background)
	       Specifies the background	colour of the nomail icon and the  de-
	       fault foreground	colour of the mail icon.

       iconForeground (class Foreground)
	       Specifies  the foreground colour	of the nomail icon and the de-
	       fault background	colour of the mail icon.

       iconMailBackground (default iconForeground)
	       Specifies the background	colour of the mail icon.

       iconMailForeground (default iconBackground)
	       Specifies the foreground	colour of the mail icon.

       mailBitmap (classMailBitmap)
	       Specifies the name of a bitmap to display in  the  icon	window
	       when  mail  has arrived (defaults to letters).  The Xmu string-
	       to-bitmap converter is registered to handle this	resource.

       mailbox (class Mailbox)
	       Specifies the name of the mailbox to  be	 polled	 (defaults  to
	       .mail in	the user's current directory).

       newMail (class NewMail)
	       If  True	 (the  default)	the user is only informed of new mail.
	       If False	the user is informed whenever there is any mail	in the
	       mailbox.	 In the	latter case if the application is iconic  then
	       a  complete  parse  of  the mailbox is unnecessary; if it is of
	       non-zero	size, the parse	is deferred until the  application  is
	       de-iconified.

       nomailBitmap (class NomailBitmap)
	       Specifies  the  name  of	a bitmap to display in the icon	window
	       when no mail has	arrived	 (defaults  to	noletters).   The  Xmu
	       string-to-bitmap	 converter  is	registered  to handle this re-
	       source.

       pollInterval (class PollInterval)
	       Specifies the interval in seconds  between  successive  mailbox
	       checks (defaults	to 67 seconds).

       setTitle	(class SetTitle)
	       If  True	 (the  default), sets the main window's	title, as dis-
	       played by the window manager, to	indicate when the mailbox  was
	       last altered.  If False,	leaves the title unchanged.

       silent (class Silent)
	       If True don't ring the bell when	new mail arrives.

       soundFile (class	SoundFile)
	       If  on  a  Sun-4, the name of a file to copy to /dev/audio when
	       new mail	arrives.  NOTE that this takes	place  on  the	client
	       host, not the server host.

SEE ALSO
       mailbox(1), xbiff(1)

AUTHOR
       George Ross, gdmr@dcs.ed.ac.uk

GDMR				  April	1996		       XMAILWATCHER(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=xmailwatcher&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help