NAME

xtset —

Set title text for xterm

SYNOPSIS

xtset [-i] [-t] text

DESCRIPTION

xtset writes an xterm ``set title text'' command sequence based on the text argument to stdout. If the TERM environment variable does not start with xterm, xtset does nothing.

OPTIONS

-t: Set the title only.
-i: Set the icon name only.

By default, xtset sets both the title and the icon name.

METAVARIABLES

A number of metavariables allow substituting environmental information:

%h: is replaced by the hostname, excluding domain name.
%H: is replaced by the hostname, including domain name if gethostname returns it.
%d: is replaced by the current directory name.
%D: is replaced by the current directory name, only last part (unless this is src, man, doc, etc., in which case the previous part is included as well).
%u: is replaced by the current user name.
%g: is replaced by the current group name.
%U: is replaced by the current real user name.
%G: is replaced by the current real group name.
%m: is replaced by the octal current umask.
%e: is replaced by the value of environment variable XTXTRA or null string.
%t: is replaced by the complete name of the stdin terminal, if it is a terminal.
%T: is replaced by the last part of the stdin file name, if it is a terminal.
%%: is replaced by the real percent sign.

ENVIRONMENT

Uses the TERM and XTXTRA variables.

FILES

xtset always writes to stdout.

EXAMPLES

xtset -i Foo

will expand to

Foo

but only on the icon. The title will remain unchanged.

xtset %d@%h (%u:%g)

might expand to

/home/sol/msmith@rheya
  (msmith:group2)"

xtset -t %u (%T) %h:%D

xtset -i %u@%h:%D

might set the title text to

root (ttyp0)
  myhost:usr/src

and the icon text to

root@myhost:usr/src

AUTHORS

Written by Martin Smith <msmith@lssec.bt.co.uk>. Modifications by Greg Lehey <grog@FreeBSD.org>