.TH xtitle 1 "29 March 2012" "Mark Wooding" "Toys"
.SH NAME
xtitle \- set or read an xterm title string
.SH SYNOPSIS
.B xtitle
.RB [ \-q ]
.br
.B xtitle
.I string
\&...
.SH DESCRIPTION
The
.B xtitle
program sets or reads the title string of an
.BR xterm (1)
or compatible terminal emulator.
.PP
Without
.BR \-q ,
concatenate the
.IR string s
provided on the command line
with spaces between them,
and set the result as the title string.
.PP
With
.BR \-q ,
read the current title and
write it to standard output
followed by a newline.
.PP
If standard input is a terminal then
.B xtitle
will use it
(writing to file descriptor 0!);
otherwise it will open
.B /dev/tty
and use that.
.SH BUGS
.B xtitle
makes no attempt to determine whether its terminal is in fact
.B xterm
or something compatible.
.PP
In
.B \-q
mode,
if the terminal doesn't understand the necessary control sequence,
or the feature has been disabled for (quite sensible) security reasons,
then
.B xtitle
will wait forever for the title string to appear.
.SH AUTHOR
Mark Wooding, <mdw@distorted.org.uk>