RXVT(1.61)

NAME
crxvt - VT100 emulator for the X window system

SYNOPSIS
crxvt [ options ]

DESCRIPTION
Crxvt is a VT100 terminal emulator for X. It is intended as a replacement for xterm(1) for users who do not require the more esoteric features of xterm. Specifically crxvt does not implement the Tektronix 4014 emulation, session logging and toolkit style configurability. As a result, crxvt uses much less swap space than xterm - a significant advantage on a machine serving many X sessions.

OPTIONS
The options supported by crxvt (which are a subset of those supported by xterm) are listed below.

-e command [ arguments ]
    Run the command with its command line arguments in the xvt window. If this option is used, it must be the last on the command line. If there is no -e option then the default is to run the program specified by the SHELL environment variable or, failing that, sh(1).

-display display-name
    Attempt to open the xvt window on the named X display. In the absence if this option, the display specified by the DISPLAY environment variable is used.

-geometry window-geometry
    Create the window with the specified X window geometry.

-bg color
    Use the specified color as the window's background color.

-fg color
    Use the specified color as the window's foreground color.

-font fontname
    Set the main text font used by crxvt.

-font_list list-of-fontnames
    A space-delimited list of font names. These are used when changing font sizes on the fly with alt-">" or alt-"<".

-T text
    Set the string that is displayed in the window's title bar if it has one.

-n text
    Set the name that will be used to label the window's icon or displayed in an icon manager window. This option also sets the window's title unless it is set explicitly.

-C  Capture system console messages.

-7  Run in 7 bit mode, stripping the 8th bit from all character typed on the keyboard.

-8  Run in 8 bit clean mode, allowing the 8th bit of characters typed at the keyboard to be passed to the application.

-ls Prepend a "-" to argv[0] of the shell which is initiated for the window, causing it to be a login shell.

-ls-
    Do not prepend a "-" to argv[0] of the shell which is initiated for the window, causing it to be a regular shell. Used only to over-ride a resources setting.

-ma Make crxvt automatically de-iconify itself if it receives a bell character.

-ls-
    Suppress the automatic de-iconify on bell. Used only to over-ride a resources setting.

-ic Start iconified, if the window manager supports that option.

-fat
    Use an xterm-style fat scrollbar instead of crxvt's native thin scrollbar.

-thin
    Use crxvt's native thin scrollbar, no matter what the resources say.

-smallfont keysym
    Makes crxvt use key alt-keysym instead of alt-"<" to toggle to a smaller font.

-bigfont keysym
    Makes crxvt use key alt-keysym instead of alt-">" to toggle to a bigger font.

-pageup keysym
    Makes crxvt use key alt-keysym instead of alt-Prev_Page to toggle to scroll up a page.

-pagedown keysym
    Makes crxvt use key alt-keysym instead of alt-Next_Page to toggle to scroll down a page.

-secure keysym
    Makes crxvt use key alt-keysym instead of alt-"s" to toggle to a bigger font.

-prkey keysym
    Makes crxvt us key keysym instead of PrintScreen to initiate a screen dump to the printer.

-sl number
    Causes crxvt to save number lines in he scroll back buffer instead of the default 64.

-meta string
    Causes crxvt to alter its handling of meta (alt) + keypress. By default, crxvt will send an escape prefix when it receives a meta keypress. You can specify either "escape","8thbit", or "ignore" for string. "8thbit" causes the 8th bit to be set in the received character.

-grk9 | -grk4
    For greek mode, select elot-928 or ibm-437 keyboard translation. The former is an ISO-8859 standard, the latter is still used a lot.

X RESOURCES
crxvt accepts resources set in each users ~/.Xdefaults, and probably from a few dozen other places too. If no resources are specified, suitable defaults will be used. Command line arguments can be used to over-ride resources settings. The following resources are allowed:

crxvt.command: command [ arguments ]
    The same as command line argument -e.

crxvt.geometry: window-geometry
    The same as command line argument -geometry.

crxvt.background: color
    The same as command line argument -bg.

crxvt.foreground: color
    The same as command line argument -fg.

crxvt.font: fontname
    The same as command line argument -font.

crxvt.font_list: list-of-fontnames
    The same as command line argument -font_list.

crxvt.title: text
    The same as command line argument -T.

crxvt.icon_name: text
    The same as command line argument -n.

crxvt.mapalert: true
    The same as command line argument -ma.

crxvt.bits: text
    text must be 7 or 8. 7 is the same as command line option -7, and 8 is the same as -8.

crxvt.login_shell: text
    text must be True or False. True is the same as -ls, and False is the same as -ls-.

crxvt.scrollbar: text
    text must be Fat or Thin. Fat is the same as -fat, and thin is the same as -thin.

crxvt.smaller_font_key: keysym
    Makes crxvt use key alt-keysym instead of alt-"<" to toggle to a smaller font.

crxvt.bigger_font_key: keysym
    Makes crxvt use key alt-keysym instead of alt-">" to toggle to a bigger font.

crxvt.page_up_key: keysym
    Makes crxvt use key alt-keysym instead of alt-Prev_Page to toggle to a bigger font.

crxvt.page_down_key: keysym
    Makes crxvt use key alt-keysym instead of alt-Next_Page to toggle to a bigger font.

crxvt.secure_key keysym
    Makes crxvt use key alt-keysym instead of alt-"s" to toggle to a bigger font.

crxvt.printscreen_key keysym
    Makes crxvt use the key keysym instead of PrintScreen to initiate a screen dump to the printer.

crxvt.saveLines number
    Causes crxvt to save number lines in he scroll back buffer instead of the default 64.

crxvt.meta string
    See the -meta command line option.

crxvt.greek_switch_keysym string
    The keysym that toggles between normal and greek keyboard input. Applicable only if crxvt is compiled with greek keyboard support. The default is keysym `Mode_switch'. You may define it to be something else with a command like: xmodmap -e "keycode ... = Mode_switch"

crxvt.cutcharclass string
    The set of characters that are delimiters for double click word selection. The built-in default is: <SPACE>[](){}<>="'*?,&;

TITLES AND ICON NAMES
One occasionally confusing aspect of crxvt and other X applications is the collection of names that an application window can have and the relationship between the names and the command line options used to set them. This section attempts to make the situation a bit clearer in the case of crxvt.

In fact, each terminal window has two names: its title and its icon name. These names are distinct and have different functions, although they usually have the same value. The title is the text that is displayed in the title bar, if there is one, and the icon name is the name that appears in the window's icon or represents it in the icon manager window.

THE SCROLL BAR
Lines of text that scroll off the top of the crxvt window are saved automatically (up to a preset maximum number) and can be viewed by scrolling them back into the window with the scrollbar.

  The crxvt-style scroll bar
Pressing a mouse button while in the scrollbar will cause the window contents to scroll continuously with mouse motion. Pressing the up or down arrows which are at the top and bottom of the scroll bar, will cause the window to scroll by almost a full screen. The same effect can be achieved by typing alt-next-page or alt-prev-page. The actual hotkey which is used can be switched through command line or X resources options described above.

  The xterm-style scroll bar
If the -fat option has been selected, an xterm-compatible scroll bar is used instead of the crxvt-style scroll bar. Pressing a mouse button 2 while in the scrollbar will cause the window contents to scroll continuously with mouse motion. Pressing mouse button 1 will move the line adjacent to the pointer to the top of the display window. Pressing mouse button 2 will move the line at the top of the display window to a position adjacent to the pointer.

TEXT SELECTION AND INSERTION
crxvt uses a similar kind of text selection and insertion mechanism to xterm. Pressing and releasing the middle mouse button in an crxvt window causes the current text selection to be inserted as if it had been typed on the keyboard. For the insertion to take place, both the button press and the button release need to be done with the cursor in the crxvt window.

The left and right mouse buttons are used to select text. A text selection starts at the point where the left or right button is pressed, and ends at the point where it is released. Rxvt can be compiled with support for selecting words if you double click on them, or whole lines if you triple click. This is a compile-time option.

SECURING THE KEYBOARD
You can enter or exit from the secure keyboard mode by typing alt-s. This is typically a good thing to do when you are typing a password. The actual hotkey which is used can be switched through command line or X resources options described above.

CHANGING FONTS
You can change fonts on the fly by typing alt-> or alt-< (that hold down the "Alt" key and press "<" or ">". The actual hotkey which is used can be switched through command line or X resources options described above. This will cycle through your default font and 4 others of various sizes.

AUTOMATIC MAPPING
You can specify that crxvt will automatically de-iconify itself when it receives a bell character. This can be configured on with the -ma command line switch, configured off with the -ma- command line switch. The current state can be toggled with alt-i.

GREEK KEYBOARD INPUT
crxvt can be compiled with support for greek keyboard input. ELOT-928 and IBM-437 keyboard translations are supported (selected by command line options -grk9 (default) or -grk4). Of course, you will need greek X fonts (928 and 437) installed on your system. In addition, the application you run in the crxvt must be 8-bit clean. See file README.greek that comes with the crxvt source distribution for more information. A proper string is appended on your window title to indicate when (and which) greek mode is activated.

BUGS
crxvt-1.6 really is bug free, except for utmp support, which is pretty crazy.

AUTHOR
John Bovey, University of Kent, 1992. Very very very heavily modified by Rob Nation (nation@rocket.sanders.lockheed.com) Greek keyboard input: Angelo Haritsis <ah@doc.ic.ac.uk> Double/triple click: ah@doc.ic.ac.uk with some code from Edward. Der-Hua Liu.

SEE ALSO
xcin(1), cin2tab(1), xcin.HOWTO, cin2tab.HOWTO, Boshiamy.HOWTO, Xfonts.HOWTO