\input texinfo   @c -*-texinfo-*-
@c
@c $Id: xphone.texinfo,v 1.4 1995/05/29 13:02:23 zappo Exp $
@c
@setfilename xphone.info
@settitle The GNU X phone

@ifinfo
@format
START-INFO-DIR-ENTRY
* Xphone: (xphone).       The GNU X phone utility
END-INFO-DIR-ENTRY
@end format
@end ifinfo

@titlepage
@sp 10
@center @titlefont{GNU X phone}
@vskip 0pt plus 1 fill
Copyright @copyright{} 1995 Free Software Foundation
@end titlepage

@node Top, , (dir),   (dir)

Copyright @copyright{} 1995 Free Software Foundation

This file documents the GNU X phone.  Xphone is a simple utility which
displays a phone icon in a small window.  If the system is using the
GNU talk daemon for handling talk requests, then this program will be
contacted whenever there is a request directed to you.

This program is ONLY USEFUL IF GTALKD IS RUNNING ON YOUR TARGET
SYSTEM.  The BSD ntalkd does not know about xphone, and will not
attempt to contact it.

When this application is contacted you may use emacs talk (etalk) with
the command @kbd{M-x etalk-reply} which will be able to determine who
contacted you.  If you do not use etalk, then the contact information
will be displayed upon the starting TTY for xphone.

If you have problems with xphone, you can always reach me as:
zappo@@gnu.ai.mit.edu

The command line parameters are:
@table @asis
@item --bellcommand, -b
Alternate command used to make a ringing noise.
@item --geometry
Start up geometry of xphone.  Only the position part is used.
@item --help, -h,-?
Print this help.
@item --silent, -s
Start silently, and print no announcements.
@item --ibg, --ibackground
Set background color of idle phone.
@item --ifg, --iforeground
Set foreground color of idle phone.
@item --idleimage
Set idle image bitmap file data.
@item --rbg, --rbackground
Set background color of ringing phone.
@item --rfg, --rforeground
Set foreground color of ringing phone.
@item --ringimage
Set ringing image bitmap file data.
@item --verbose -v
Print debugging information as we go.
@item --version
Print version and exit.
@end table

X resources you can set to control the behavior of xphone are:

@table @asis
@item xphone.title
The title which appears in the window managers title bar
@item xphone.icontitle
The title which appears under an icon
@item xphone.ringcommand
Alternate command used to make a ringing sound
@item xphone.idle.foreground
Foreground color of idle phone
@item xphone.idle.background
Background color of idle phone
@item xphone.ring.foreground
Foreground color of ringing phone
@item xphone.ring.background
Background color of ringing phone
@item xphone.idle.bitmap
Alternate bitmap for idle phone
@item xphone.ring.bitmap
Alternate bitmap for ringing phone
@end table

These resources should be self explanitory, or map directly to command
line options of the same name.

This documentation and the xphone program are still primitive in the
extreme.  Please send suggestions or patches to me on topics you would
like to see included.

@bye
