up the input for people using dead keys or compose keys.
--enable-unicode3 (default: off)
+ Recommended to stay off unless you really need non-BMP characters.
+
Enable direct support for displaying unicode codepoints above 65535
(the basic multilingual page). This increases storage requirements
per character from 2 to 4 bytes. X11 fonts do not yet support these
pseudo-characters when no precomposed form exists.
Without --enable-unicode3, the number of additional precomposed
- characters is rather limited (2048, if this is full, rxvt-unicode
- will use the private use area, extending the number of combinations
- to 8448). With --enable-unicode3, no practical limit exists.
+ characters is somewhat limited (the 6400 private use characters will
+ be (ab-)used). With --enable-unicode3, no practical limit exists.
This option will also enable storage (but not display) of characters
beyond plane 0 (>65535) when --enable-unicode3 was not specified.
the favourite of the rxvt-unicode author, having used it for many
years.
+ --enable-ttygid (default: off)
+ Change tty device setting to group "tty" - only use this if your
+ system uses this type of security.
+
--disable-backspace-key
Removes any handling of the backspace key by us - let the X server
do it.
--enable-pointer-blank (default: on)
Add support to have the pointer disappear when typing or inactive.
- --enable-perl (default: off)
+ --enable-perl (default: on)
Enable an embedded perl interpreter. See the rxvtperl(3) manpage
(doc/rxvtperl.txt) for more info on this feature, or the files in
src/perl-ext/ for the extensions that are installed by default. The
</p>
<hr />
<h1><a name="description">DESCRIPTION</a></h1>
-<p><strong>rxvt-unicode</strong>, version <strong>7.1</strong>, is a colour vt102 terminal
+<p><strong>rxvt-unicode</strong>, version <strong>7.2</strong>, is a colour vt102 terminal
emulator intended as an <em>xterm</em>(1) replacement for users who do not
require features such as Tektronix 4014 emulation and toolkit-style
configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space --
<dt><strong><a name="item_insertion_3a"><strong>Insertion</strong>:</a></strong><br />
</dt>
<dd>
-Pressing and releasing the Middle mouse button in an <strong>rxvt</strong> window
-causes the value of the PRIMARY selection (Shift for CLIPBOARD) to be inserted
-as if it had been typed on the keyboard.
-<strong>Shift-Insert</strong> causes the value of the PRIMARY selection to be inserted too.
+Pressing and releasing the Middle mouse button in an <strong>rxvt</strong>
+window causes the value of the PRIMARY selection (or CLIPBOARD with the
+Meta modifier) to be inserted as if it had been typed on the keyboard.
+</dd>
+<dd>
+<p>Pressing <strong>Shift-Insert</strong> causes the value of the PRIMARY selection to be
+inserted too.</p>
</dd>
<p></p></dl>
<p>
-.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.3
+.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.14
.\"
.\" Standard preamble:
.\" ========================================================================
.\" ========================================================================
.\"
.IX Title "rxvt 1"
-.TH rxvt 1 "2006-01-20" "7.1" "RXVT-UNICODE"
+.TH rxvt 1 "2006-01-25" "7.2" "RXVT-UNICODE"
.SH "NAME"
rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system)
.SH "SYNOPSIS"
the selection.
.IP "\fBInsertion\fR:" 4
.IX Item "Insertion:"
-Pressing and releasing the Middle mouse button in an \fB@@RXVT_NAME@@\fR window
-causes the value of the \s-1PRIMARY\s0 selection (Shift for \s-1CLIPBOARD\s0) to be inserted
-as if it had been typed on the keyboard.
-\&\fBShift-Insert\fR causes the value of the \s-1PRIMARY\s0 selection to be inserted too.
+Pressing and releasing the Middle mouse button in an \fB@@RXVT_NAME@@\fR
+window causes the value of the \s-1PRIMARY\s0 selection (or \s-1CLIPBOARD\s0 with the
+Meta modifier) to be inserted as if it had been typed on the keyboard.
+.Sp
+Pressing \fBShift-Insert\fR causes the value of the \s-1PRIMARY\s0 selection to be
+inserted too.
.SH "CHANGING FONTS"
.IX Header "CHANGING FONTS"
Changing fonts (or font sizes, respectively) via the keypad is not yet
rxvt [options] [-e command [ args ]]
DESCRIPTION
- rxvt-unicode, version 7.1, is a colour vt102 terminal emulator intended
+ rxvt-unicode, version 7.2, is a colour vt102 terminal emulator intended
as an *xterm*(1) replacement for users who do not require features such
as Tektronix 4014 emulation and toolkit-style configurability. As a
result, rxvt-unicode uses much less swap space -- a significant
Insertion:
Pressing and releasing the Middle mouse button in an rxvt window
- causes the value of the PRIMARY selection (Shift for CLIPBOARD) to
- be inserted as if it had been typed on the keyboard. Shift-Insert
- causes the value of the PRIMARY selection to be inserted too.
+ causes the value of the PRIMARY selection (or CLIPBOARD with the
+ Meta modifier) to be inserted as if it had been typed on the
+ keyboard.
+
+ Pressing Shift-Insert causes the value of the PRIMARY selection to
+ be inserted too.
CHANGING FONTS
Changing fonts (or font sizes, respectively) via the keypad is not yet
<dt><strong><a name="item_unicode3">--enable-unicode3 (default: off)</a></strong><br />
</dt>
<dd>
-Enable direct support for displaying unicode codepoints above
+Recommended to stay off unless you really need non-BMP characters.
+</dd>
+<dd>
+<p>Enable direct support for displaying unicode codepoints above
65535 (the basic multilingual page). This increases storage
requirements per character from 2 to 4 bytes. X11 fonts do not yet
-support these extra characters, but Xft does.
+support these extra characters, but Xft does.</p>
</dd>
<dd>
<p>Please note that rxvt-unicode can store unicode code points >65535
new pseudo-characters when no precomposed form exists.
</dd>
<dd>
-<p>Without --enable-unicode3, the number of additional precomposed characters
-is rather limited (2048, if this is full, rxvt-unicode will use the
-private use area, extending the number of combinations to 8448). With
---enable-unicode3, no practical limit exists.</p>
+<p>Without --enable-unicode3, the number of additional precomposed
+characters is somewhat limited (the 6400 private use characters will be
+(ab-)used). With --enable-unicode3, no practical limit exists.</p>
</dd>
<dd>
<p>This option will also enable storage (but not display) of characters
<dt><strong><a name="item_fallback">--enable-fallback(=CLASS) (default: Rxvt)</a></strong><br />
</dt>
<dd>
-When reading resource settings, also read settings for class CLASS. To disable resource fallback use --disable-fallback.
+When reading resource settings, also read settings for class CLASS. To
+disable resource fallback use --disable-fallback.
</dd>
<p></p>
<dt><strong><a name="item_name">--with-res-name=NAME (default: urxvt)</a></strong><br />
Add support to have the pointer disappear when typing or inactive.
</dd>
<p></p>
-<dt><strong><a name="item_perl">--enable-perl (default: off)</a></strong><br />
+<dt><strong><a name="item_perl">--enable-perl (default: on)</a></strong><br />
</dt>
<dd>
Enable an embedded perl interpreter. See the <strong>rxvtperl(3)</strong>
.\" ========================================================================
.\"
.IX Title "rxvt 7"
-.TH rxvt 7 "2006-01-19" "7.1" "RXVT-UNICODE"
+.TH rxvt 7 "2006-01-25" "7.2" "RXVT-UNICODE"
.SH "NAME"
RXVT REFERENCE \- FAQ, command sequences and other background information
.SH "SYNOPSIS"
set up the input for people using dead keys or compose keys.
.IP "\-\-enable\-unicode3 (default: off)" 4
.IX Item "--enable-unicode3 (default: off)"
+Recommended to stay off unless you really need non-BMP characters.
+.Sp
Enable direct support for displaying unicode codepoints above
65535 (the basic multilingual page). This increases storage
requirements per character from 2 to 4 bytes. X11 fonts do not yet
done by using precomposited characters when available or creating
new pseudo-characters when no precomposed form exists.
.Sp
-Without \-\-enable\-unicode3, the number of additional precomposed characters
-is rather limited (2048, if this is full, rxvt-unicode will use the
-private use area, extending the number of combinations to 8448). With
-\&\-\-enable\-unicode3, no practical limit exists.
+Without \-\-enable\-unicode3, the number of additional precomposed
+characters is somewhat limited (the 6400 private use characters will be
+(ab\-)used). With \-\-enable\-unicode3, no practical limit exists.
.Sp
This option will also enable storage (but not display) of characters
beyond plane 0 (>65535) when \-\-enable\-unicode3 was not specified.
tell me how these are to be used...).
.IP "\-\-enable\-fallback(=CLASS) (default: Rxvt)" 4
.IX Item "--enable-fallback(=CLASS) (default: Rxvt)"
-When reading resource settings, also read settings for class \s-1CLASS\s0. To disable resource fallback use \-\-disable\-fallback.
+When reading resource settings, also read settings for class \s-1CLASS\s0. To
+disable resource fallback use \-\-disable\-fallback.
.IP "\-\-with\-res\-name=NAME (default: urxvt)" 4
.IX Item "--with-res-name=NAME (default: urxvt)"
Use the given name as default application name when
.IP "\-\-enable\-pointer\-blank (default: on)" 4
.IX Item "--enable-pointer-blank (default: on)"
Add support to have the pointer disappear when typing or inactive.
-.IP "\-\-enable\-perl (default: off)" 4
-.IX Item "--enable-perl (default: off)"
+.IP "\-\-enable\-perl (default: on)" 4
+.IX Item "--enable-perl (default: on)"
Enable an embedded perl interpreter. See the \fB@@RXVT_NAME@@\f(BIperl\fB\|(3)\fR
manpage (\fIdoc/rxvtperl.txt\fR) for more info on this feature, or the files
in \fIsrc/perl\-ext/\fR for the extensions that are installed by default. The
up the input for people using dead keys or compose keys.
--enable-unicode3 (default: off)
+ Recommended to stay off unless you really need non-BMP characters.
+
Enable direct support for displaying unicode codepoints above 65535
(the basic multilingual page). This increases storage requirements
per character from 2 to 4 bytes. X11 fonts do not yet support these
pseudo-characters when no precomposed form exists.
Without --enable-unicode3, the number of additional precomposed
- characters is rather limited (2048, if this is full, rxvt-unicode
- will use the private use area, extending the number of combinations
- to 8448). With --enable-unicode3, no practical limit exists.
+ characters is somewhat limited (the 6400 private use characters will
+ be (ab-)used). With --enable-unicode3, no practical limit exists.
This option will also enable storage (but not display) of characters
beyond plane 0 (>65535) when --enable-unicode3 was not specified.
--enable-pointer-blank (default: on)
Add support to have the pointer disappear when typing or inactive.
- --enable-perl (default: off)
+ --enable-perl (default: on)
Enable an embedded perl interpreter. See the rxvtperl(3) manpage
(doc/rxvtperl.txt) for more info on this feature, or the files in
src/perl-ext/ for the extensions that are installed by default. The
URxvt.selection.pattern-0: \\|([^|]+)\\|</pre>
</dd>
<dd>
+<p>Another example: Programs I use often output ``absolute path: '' at the
+beginning of a line when they process multiple files. The following
+pattern matches the filename (note, there is a single space at the very
+end):</p>
+</dd>
+<dd>
+<pre>
+ URxvt.selection.pattern-0: ^(/[^:]+):\</pre>
+</dd>
+<dd>
<p>You can look at the source of the selection extension to see more
interesting uses, such as parsing a line from beginning to end.</p>
</dd>
the URL as first argument.
</dd>
<p></p>
+<dt><strong><a name="item_xim_2donthespot">xim-onthespot</a></strong><br />
+</dt>
+<dd>
+This (experimental) perl extension implements OnTheSpot editing. It does
+not work perfectly, and some input methods don't seem to work well with
+OnTheSpot editing in general, but it seems to work at leats for SCIM and
+kinput2.
+</dd>
+<dd>
+<p>You enable it by specifying this extension and a preedit style of
+<code>OnTheSpot</code>, i.e.:</p>
+</dd>
+<dd>
+<pre>
+ rxvt -pt OnTheSpot -pe xim-onthespot</pre>
+</dd>
+<p></p>
<dt><strong><a name="item_automove_2dbackground">automove-background</a></strong><br />
</dt>
<dd>
<dt><strong><a name="item_on_destroy__24term">on_destroy $term</a></strong><br />
</dt>
<dd>
-Called whenever something tries to destroy terminal, before doing anything
-yet. If this hook returns true, then destruction is skipped, but this is
-rarely a good idea.
+Called whenever something tries to destroy terminal, when the terminal is
+still fully functional (not for long, though).
</dd>
<p></p>
<dt><strong><a name="item_on_reset__24term">on_reset $term</a></strong><br />
.\" ========================================================================
.\"
.IX Title "rxvt 3"
-.TH rxvt 3 "2006-01-22" "7.2" "RXVT-UNICODE"
+.TH rxvt 3 "2006-01-25" "7.2" "RXVT-UNICODE"
.SH "NAME"
@@RXVT_NAME@@perl \- rxvt\-unicode's embedded perl interpreter
.SH "SYNOPSIS"
\& URxvt.selection.pattern-0: \e\e|([^|]+)\e\e|
.Ve
.Sp
+Another example: Programs I use often output \*(L"absolute path: \*(R" at the
+beginning of a line when they process multiple files. The following
+pattern matches the filename (note, there is a single space at the very
+end):
+.Sp
+.Vb 1
+\& URxvt.selection.pattern-0: ^(/[^:]+):\e
+.Ve
+.Sp
You can look at the source of the selection extension to see more
interesting uses, such as parsing a line from beginning to end.
.Sp
make them clickable. When middle\-clicked, the program specified in the
resource \f(CW\*(C`urlLauncher\*(C'\fR (default \f(CW\*(C`x\-www\-browser\*(C'\fR) will be started with
the \s-1URL\s0 as first argument.
+.IP "xim-onthespot" 4
+.IX Item "xim-onthespot"
+This (experimental) perl extension implements OnTheSpot editing. It does
+not work perfectly, and some input methods don't seem to work well with
+OnTheSpot editing in general, but it seems to work at leats for \s-1SCIM\s0 and
+kinput2.
+.Sp
+You enable it by specifying this extension and a preedit style of
+\&\f(CW\*(C`OnTheSpot\*(C'\fR, i.e.:
+.Sp
+.Vb 1
+\& @@RXVT_NAME@@ -pt OnTheSpot -pe xim-onthespot
+.Ve
.IP "automove-background" 4
.IX Item "automove-background"
This is basically a one-line extension that dynamically changes the background pixmap offset
.ie n .IP "on_destroy $term" 4
.el .IP "on_destroy \f(CW$term\fR" 4
.IX Item "on_destroy $term"
-Called whenever something tries to destroy terminal, before doing anything
-yet. If this hook returns true, then destruction is skipped, but this is
-rarely a good idea.
+Called whenever something tries to destroy terminal, when the terminal is
+still fully functional (not for long, though).
.ie n .IP "on_reset $term" 4
.el .IP "on_reset \f(CW$term\fR" 4
.IX Item "on_reset $term"
URxvt.selection.pattern-0: \\|([^|]+)\\|
+ Another example: Programs I use often output "absolute path: " at
+ the beginning of a line when they process multiple files. The
+ following pattern matches the filename (note, there is a single
+ space at the very end):
+
+ URxvt.selection.pattern-0: ^(/[^:]+):\
+
You can look at the source of the selection extension to see more
interesting uses, such as parsing a line from beginning to end.
in the resource "urlLauncher" (default "x-www-browser") will be
started with the URL as first argument.
+ xim-onthespot
+ This (experimental) perl extension implements OnTheSpot editing. It
+ does not work perfectly, and some input methods don't seem to work
+ well with OnTheSpot editing in general, but it seems to work at
+ leats for SCIM and kinput2.
+
+ You enable it by specifying this extension and a preedit style of
+ "OnTheSpot", i.e.:
+
+ rxvt -pt OnTheSpot -pe xim-onthespot
+
automove-background
This is basically a one-line extension that dynamically changes the
background pixmap offset to the window position, in effect creating
mainloop.
on_destroy $term
- Called whenever something tries to destroy terminal, before doing
- anything yet. If this hook returns true, then destruction is
- skipped, but this is rarely a good idea.
+ Called whenever something tries to destroy terminal, when the
+ terminal is still fully functional (not for long, though).
on_reset $term
Called after the screen is "reset" for any reason, such as resizing
DT_END));
}
+#if 0
static void
xim_preedit_caret (XIC ic, XPointer client_data, XIMPreeditCaretCallbackStruct *call_data)
{
DT_INT, call_data->style,
DT_END));
}
+#endif
#endif
xcb[0].client_data = (XPointer)this; xcb[0].callback = (XIMProc)xim_preedit_start;
xcb[1].client_data = (XPointer)this; xcb[1].callback = (XIMProc)xim_preedit_done;
xcb[2].client_data = (XPointer)this; xcb[2].callback = (XIMProc)xim_preedit_draw;
+#if 0
xcb[3].client_data = (XPointer)this; xcb[3].callback = (XIMProc)xim_preedit_caret;
+#endif
preedit_attr = XVaCreateNestedList (0,
XNPreeditStartCallback, &xcb[0],
XNPreeditDoneCallback , &xcb[1],
XNPreeditDrawCallback , &xcb[2],
+#if 0
XNPreeditCaretCallback, &xcb[3],
+#endif
NULL);
}
const_iv (XIMVisibleToForward),
const_iv (XIMVisibleToBackword),
const_iv (XIMVisibleToCenter),
-
+# if 0
const_iv (XIMForwardChar),
const_iv (XIMBackwardChar),
const_iv (XIMForwardWord),
const_iv (XIMLineEnd),
const_iv (XIMAbsolutePosition),
const_iv (XIMDontChange),
+# endif
# endif
};
resource C<urlLauncher> (default C<x-www-browser>) will be started with
the URL as first argument.
+=item xim-onthespot
+
+This (experimental) perl extension implements OnTheSpot editing. It does
+not work perfectly, and some input methods don't seem to work well with
+OnTheSpot editing in general, but it seems to work at leats for SCIM and
+kinput2.
+
+You enable it by specifying this extension and a preedit style of
+C<OnTheSpot>, i.e.:
+
+ @@RXVT_NAME@@ -pt OnTheSpot -pe xim-onthespot
+
=item automove-background
This is basically a one-line extension that dynamically changes the background pixmap offset
projects / dana / urxvt.git / commitdiff