NAME

XTerm::Conf - change configuration of a running xterm

SYNOPSIS

use XTerm::Conf;
xterm_conf(-fg => "white", -bg => "black", -title => "Hello, world", ...);

DESCRIPTION

xterm_conf(options ...)

The xterm_conf function (exported by default) checks first if the current terminal looks like an xterm (by looking at the TERM environment variable) and prints the escape sequences for the following options:

-iconname string

Change the name of the associated X11 icon.

-title string

Change the xterm's title bar.

-fg color
-foreground color

Change the text color. You can use either X11 named colors or the #rrggbb notation.

-bg color
-background color

Change the background color

-textcursor ...

???

-mousefg color
-mouseforeground color

Change the foreground color of the mouse pointer.

-mousebg color
-mousebackground color

Change the background/border color of the mouse pointer.

-tekfg color
-tekforeground color

???

-tekbg color
-tekbackground color

???

-highlightcolor color

???

-bell

Ring the bell (either visual or audible)

-cs ...

???

-fullreset

Perform a full reset.

-softreset

Perform a soft reset.

-[no]smoothscroll

Turn smooth scrolling on or off. Does not have a visual effect, though.

-[no]reverse
-[no]reversevideo

Turn reverse video on or off.

-[no]origin

???

-[no]wraparound

???

-[no]autorepeat

Turn auto repeat on or off

-[no]formfeed

???

-[no]showcursor

???

-[no]showscrollbar

rxvt only?

-[no]tektronix

???

-[no]marginbell

???

-[no]reversewraparound

???

-[no]backsendsdelete

???

-[no]bottomscrolltty

rxvt only?

-[no]bottomscrollkey

rxvt only?

-[no]metasendsesc
-[no]metasendsescape

???

-scrollregion ...

???

-deiconify

Deiconify an iconified xterm window.

-iconify

Iconify the xterm window.

-geometry geomtry

Change the geometry of the xterm window. The geometry is in the usual X11 notation widthxheight+left+top. The numbers are in pixels. The width and height may be suffixed with a c, which means that the number are interpreted as characters.

-raise

Raise the xterm window.

-lower

Lower the xterm window

-refresh
-x11refresh

Force a X11 refresh

-maximize

Maximize the xterm window

-unmaximize

Restore to the state before maximization.

-xproperty ...
-x11property ...

???

-font ...

???

-nextfont

???

-prevfont

???

-report ...

???

-debugreport

???

-resize integer

???

xterm_conf_string(options ...)

xterm_conf_string just returns a string with the escape sequences for the given options (same as in xterm_conf). No terminal check will be performed here.

xterm_conf_string may be exported.

AUTHOR

Slaven Rezić

SEE ALSO

Term::Title, xterm(1).