.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH XTTITLE 1 "August  8, 2001"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)

.SH NAME
xttitle \- change X terminal emulator window titles

.SH SYNOPSIS
.B xttitle
.RI title
[ icon ]

.SH DESCRIPTION
This manual page documents briefly the
.B xttitle
command.
This manual page was written for the Debian GNU/Linux distribution
because the original program does not have a manual page.

.PP
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
.\" respectively.
\fBxttitle\fP is a program that changes the title (and possibly icon) of your
X terminal emulator windows. It should work for any program that emulates an
xterm-like terminal under X.

.PP
You may want to create an alias in your shell for 'cd', so that your window
title keeps track of your current working directory. In Bash, the following
seems to work for me:

.nf
	update_title()
	{
		[ $TERM = 'xterm ] && xttitle "[$$] ${USER}@${HOSTNAME}:$PWD"
	}

	function cd()
	{
		builtin cd $*; update_title
 	}
.fi

You can then set up other things that run update_title - for instance you may
want to put it in your shell startup file so that the title gets updated when
you open a new terminal emulator window.

.SH SEE ALSO
http://jarvis.com/xttitle/xttitle.html
.br

.SH AUTHOR
This manual page was written by Dafydd Harries <daf@parnassus.ath.cx>,
for the Debian GNU/Linux system (but may be used by others).