crxvt-gb-2.3 - VT100 emulator for the X Window System

crxvt-gb-2.3 [ options ]

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

The options supported by crxvt-gb-2.3 (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

Create the window with the specified X window geometry.

"-bg

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

"-fg

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

"-font

Set the main text font used by crxvt.

"-fh/fnb5/fngb

Set the main hanzi text font used by crxvt.

"-font_list

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

"-T

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

"-n

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.

"-GB/gb

Use GB(GuoBiao) Chinese encoding.

"-Big5/big5/B5/b5

Use Big5 Chinese encoding.

"-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.

"

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

"

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

"

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

"

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

"

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

"

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

"

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

"

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

"

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

"

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.

"

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:

The same as command line argument -geometry.

"crxvt.background:

The same as command line argument -bg.

"crxvt.foreground:

The same as command line argument -fg.

"crxvt.font:

The same as command line argument -font.

"crxvt.font_list:

The same as command line argument -font_list.

"crxvt.title:

The same as command line argument -T.

"crxvt.icon_name:

The same as command line argument -n.

"crxvt.mapalert:

The same as command line argument -ma.

"crxvt.bits:

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 must be True or False. True is the same as -ls, and False is the same as -ls-.

"crxvt.scrollbar:

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

"

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

"

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

"

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

"

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

"

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

"

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

"

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

"

See the -meta command line option.

"

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"

"

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

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.

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

The xterm-style scroll bar

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.

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.

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.

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.

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.

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

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.

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