diff -Nurd -x'*~' xttitle-1.0.orig/xttitle.1x xttitle-1.0/xttitle.1x --- xttitle-1.0.orig/xttitle.1x 1969-12-31 19:00:00.000000000 -0500 +++ xttitle-1.0/xttitle.1x 2011-10-31 12:04:17.000000000 -0400 @@ -0,0 +1,69 @@ +.\" 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 1x "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 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\fP and +.\" \fI\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 , +for the Debian GNU/Linux system (but may be used by others). +