From 247379d11e51d5baf8c4f7d37b52e8179642be0d Mon Sep 17 00:00:00 2001 From: root Date: Thu, 19 Jan 2006 19:26:30 +0000 Subject: [PATCH] *** empty log message *** --- Changes | 2 +- README.FAQ | 15 ++++--- doc/rxvt.1.html | 44 ++++++++++++++----- doc/rxvt.1.man.in | 37 ++++++++++------ doc/rxvt.1.txt | 33 +++++++++----- doc/rxvt.7.html | 19 ++++---- doc/rxvt.7.man.in | 18 ++++---- doc/rxvt.7.txt | 17 +++---- doc/rxvtperl.3.html | 100 +++++++++++++++++++++++++++++++++++------- doc/rxvtperl.3.man.in | 92 ++++++++++++++++++++++++++++++-------- doc/rxvtperl.3.txt | 79 ++++++++++++++++++++++++++------- src/version.h | 2 +- 12 files changed, 342 insertions(+), 116 deletions(-) diff --git a/Changes b/Changes index f147ea8b..e21394ae 100644 --- a/Changes +++ b/Changes @@ -16,7 +16,7 @@ WISH: OnTheSpot editing, or maybe switch to miiiiiiif. or maybe use perl and an WISH: just for fun, do shade and tint with XRender. WISH: support tex fonts -7.1 Thu Jan 19 18:56:55 CET 2006 +7.1 Thu Jan 19 20:25:34 CET 2006 - setuid/setgid operation is now _encouraged_: security has been improved by moving privileged operations into a separate process and permanently dropping privileges within the terminal. This diff --git a/README.FAQ b/README.FAQ index fa901b14..c43ab29e 100644 --- a/README.FAQ +++ b/README.FAQ @@ -130,13 +130,14 @@ FREQUENTLY ASKED QUESTIONS I am using Debian GNU/Linux and have a problem... The Debian GNU/Linux package of rxvt-unicode in sarge contains large - patches that considerably change the behaviour of rxvt-unicode. - Before reporting a bug to the original rxvt-unicode author please - download and install the genuine version - () and try to reproduce the - problem. If you cannot, chances are that the problems are specific - to Debian GNU/Linux, in which case it should be reported via the - Debian Bug Tracking System (use "reportbug" to report the bug). + patches that considerably change the behaviour of rxvt-unicode (but + unfortunately this notice has been removed). Before reporting a bug + to the original rxvt-unicode author please download and install the + genuine version () and try + to reproduce the problem. If you cannot, chances are that the + problems are specific to Debian GNU/Linux, in which case it should + be reported via the Debian Bug Tracking System (use "reportbug" to + report the bug). For other problems that also affect the Debian package, you can and probably should use the Debian BTS, too, because, after all, it's diff --git a/doc/rxvt.1.html b/doc/rxvt.1.html index 50b9fcc1..0b86d86e 100644 --- a/doc/rxvt.1.html +++ b/doc/rxvt.1.html @@ -48,7 +48,7 @@

DESCRIPTION

-

rxvt-unicode, version 7.0, is a colour vt102 terminal +

rxvt-unicode, version 7.1, 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 -- @@ -417,6 +417,13 @@ if honoured by the WM, the rxvt-unicode window will not have window decorations; resource borderLess.

+
-override-redirect
+
+
+Compile frills: Sets override-redirect on the window; resource +override-redirect. +
+

-sbg
@@ -1283,13 +1290,13 @@ character is passed through. It may contain escape values as described in the entry on keysym following.

-
secondaryScreen: bool
+
secondaryScreen: boolean
Turn on/off secondary screen (default enabled).

-
secondaryScroll: bool
+
secondaryScroll: boolean
Turn on/off secondary screen scroll (default enabled). If the this @@ -1298,7 +1305,7 @@ scrollback buffer and switching to/from the secondary screen will instead scroll the screen up.

-
hold: bool
+
hold: boolean
Turn on/off hold window after exit support. If enabled, rxvt @@ -1516,7 +1523,14 @@ Specifies the program to be started with a URL argument. Used by the
transient-for: windowid
-Sets the WM_TRANSIENT_FOR property to the given window iw. +Compile frills: Sets the WM_TRANSIENT_FOR property to the given window id. +
+

+
override-redirect: boolean
+
+
+Compile frills: Sets override-redirect for the terminal window, making +it almost invisible to window managers; option -override-redirect.

@@ -1861,20 +1875,30 @@ Project Coordinator (changes.txt 2.21a to 2.4.5)

Geoff Wing >
-Rewrote screen display and text selection routines. Project Coordinator -(changes.txt 2.4.6 - rxvt-unicode) +Rewrote screen display and text selection routines. + +
+
+
+
+Project Coordinator (changes.txt 2.4.6 - rxvt-unicode)

Marc Alexander Lehmann >
-Forked rxvt-unicode, rewrote most of the display code and internal -character handling to store text in unicode, improve xterm -compatibility and apply numerous other bugfixes and extensions. +Forked rxvt-unicode, unicode support, rewrote almost all the code, perl +extension, random hacks, numerous bugfixes and extensions.

Project Coordinator (Changes 1.0 -)

+

+
Emanuele Giaquinta >
+
+
+Pty/tty/utmp/wtmp rewrite, lots of random hacking and bugxifing. +

diff --git a/doc/rxvt.1.man.in b/doc/rxvt.1.man.in index 2c4ba35a..6811138c 100644 --- a/doc/rxvt.1.man.in +++ b/doc/rxvt.1.man.in @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "rxvt 1" -.TH rxvt 1 "2006-01-16" "7.0" "RXVT-UNICODE" +.TH rxvt 1 "2006-01-19" "7.1" "RXVT-UNICODE" .SH "NAME" rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system) .SH "SYNOPSIS" @@ -387,6 +387,10 @@ and \fB\-borderwidth\fR. See resource entry for limits; resource Compile \fIfrills\fR: Set \s-1MWM\s0 hints to request a borderless window, i.e. if honoured by the \s-1WM\s0, the rxvt-unicode window will not have window decorations; resource \fBborderLess\fR. +.IP "\fB\-override\-redirect\fR" 4 +.IX Item "-override-redirect" +Compile \fIfrills\fR: Sets override-redirect on the window; resource +\&\fBoverride-redirect\fR. .IP "\fB\-sbg\fR" 4 .IX Item "-sbg" Compile \fIfrills\fR: Disable the usage of the built-in block graphics/line @@ -969,17 +973,17 @@ Set the key to be interpreted as the Meta key to: \fBalt\fR, \fBmeta\fR, Specify the reply rxvt-unicode sends to the shell when an \s-1ENQ\s0 (control\-E) character is passed through. It may contain escape values as described in the entry on \fBkeysym\fR following. -.IP "\fBsecondaryScreen:\fR \fIbool\fR" 4 -.IX Item "secondaryScreen: bool" +.IP "\fBsecondaryScreen:\fR \fIboolean\fR" 4 +.IX Item "secondaryScreen: boolean" Turn on/off secondary screen (default enabled). -.IP "\fBsecondaryScroll:\fR \fIbool\fR" 4 -.IX Item "secondaryScroll: bool" +.IP "\fBsecondaryScroll:\fR \fIboolean\fR" 4 +.IX Item "secondaryScroll: boolean" Turn on/off secondary screen scroll (default enabled). If the this option is enabled, scrolls on the secondary screen will change the scrollback buffer and switching to/from the secondary screen will instead scroll the screen up. -.IP "\fBhold\fR: \fIbool\fR" 4 -.IX Item "hold: bool" +.IP "\fBhold\fR: \fIboolean\fR" 4 +.IX Item "hold: boolean" Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@ will not immediately destroy its window when the program executed within it exits. Instead, it will wait till it is being killed or closed by the @@ -1150,7 +1154,11 @@ Specifies the program to be started with a \s-1URL\s0 argument. Used by the \&\f(CW\*(C`selection\-popup\*(C'\fR and \f(CW\*(C`mark\-urls\*(C'\fR perl extensions. .IP "\fBtransient-for\fR: \fIwindowid\fR" 4 .IX Item "transient-for: windowid" -Sets the \s-1WM_TRANSIENT_FOR\s0 property to the given window iw. +Compile \fIfrills\fR: Sets the \s-1WM_TRANSIENT_FOR\s0 property to the given window id. +.IP "\fBoverride-redirect\fR: \fIboolean\fR" 4 +.IX Item "override-redirect: boolean" +Compile \fIfrills\fR: Sets override-redirect for the terminal window, making +it almost invisible to window managers; option \fB\-override\-redirect\fR. .SH "THE SCROLLBAR" .IX Header "THE SCROLLBAR" Lines of text that scroll off the top of the \fB@@RXVT_NAME@@\fR window @@ -1410,12 +1418,15 @@ Project Coordinator (changes.txt 2.11 to 2.21) Project Coordinator (changes.txt 2.21a to 2.4.5) .IP "Geoff Wing " 4 .IX Item "Geoff Wing " -Rewrote screen display and text selection routines. Project Coordinator -(changes.txt 2.4.6 \- rxvt\-unicode) +Rewrote screen display and text selection routines. +.Sp +Project Coordinator (changes.txt 2.4.6 \- rxvt\-unicode) .IP "Marc Alexander Lehmann " 4 .IX Item "Marc Alexander Lehmann " -Forked rxvt\-unicode, rewrote most of the display code and internal -character handling to store text in unicode, improve xterm -compatibility and apply numerous other bugfixes and extensions. +Forked rxvt\-unicode, unicode support, rewrote almost all the code, perl +extension, random hacks, numerous bugfixes and extensions. .Sp Project Coordinator (Changes 1.0 \-) +.IP "Emanuele Giaquinta " 4 +.IX Item "Emanuele Giaquinta " +Pty/tty/utmp/wtmp rewrite, lots of random hacking and bugxifing. diff --git a/doc/rxvt.1.txt b/doc/rxvt.1.txt index 1d86a652..181d3eff 100644 --- a/doc/rxvt.1.txt +++ b/doc/rxvt.1.txt @@ -6,7 +6,7 @@ SYNOPSIS rxvt [options] [-e command [ args ]] DESCRIPTION - rxvt-unicode, version 7.0, is a colour vt102 terminal emulator intended + rxvt-unicode, version 7.1, 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 @@ -254,6 +254,10 @@ OPTIONS if honoured by the WM, the rxvt-unicode window will not have window decorations; resource borderLess. + -override-redirect + Compile *frills*: Sets override-redirect on the window; resource + override-redirect. + -sbg Compile *frills*: Disable the usage of the built-in block graphics/line drawing characters and just rely on what the specified @@ -820,16 +824,16 @@ RESOURCES (available also as long-options) (control-E) character is passed through. It may contain escape values as described in the entry on keysym following. - secondaryScreen: *bool* + secondaryScreen: *boolean* Turn on/off secondary screen (default enabled). - secondaryScroll: *bool* + secondaryScroll: *boolean* Turn on/off secondary screen scroll (default enabled). If the this option is enabled, scrolls on the secondary screen will change the scrollback buffer and switching to/from the secondary screen will instead scroll the screen up. - hold: *bool* + hold: *boolean* Turn on/off hold window after exit support. If enabled, rxvt will not immediately destroy its window when the program executed within it exits. Instead, it will wait till it is being killed or closed by @@ -984,7 +988,13 @@ RESOURCES (available also as long-options) "selection-popup" and "mark-urls" perl extensions. transient-for: *windowid* - Sets the WM_TRANSIENT_FOR property to the given window iw. + Compile *frills*: Sets the WM_TRANSIENT_FOR property to the given + window id. + + override-redirect: *boolean* + Compile *frills*: Sets override-redirect for the terminal window, + making it almost invisible to window managers; option + -override-redirect. THE SCROLLBAR Lines of text that scroll off the top of the rxvt window (resource: @@ -1237,13 +1247,16 @@ AUTHORS Project Coordinator (changes.txt 2.21a to 2.4.5) Geoff Wing - Rewrote screen display and text selection routines. Project - Coordinator (changes.txt 2.4.6 - rxvt-unicode) + Rewrote screen display and text selection routines. + + Project Coordinator (changes.txt 2.4.6 - rxvt-unicode) Marc Alexander Lehmann - Forked rxvt-unicode, rewrote most of the display code and internal - character handling to store text in unicode, improve xterm - compatibility and apply numerous other bugfixes and extensions. + Forked rxvt-unicode, unicode support, rewrote almost all the code, + perl extension, random hacks, numerous bugfixes and extensions. Project Coordinator (Changes 1.0 -) + Emanuele Giaquinta + Pty/tty/utmp/wtmp rewrite, lots of random hacking and bugxifing. + diff --git a/doc/rxvt.7.html b/doc/rxvt.7.html index c7c3b127..5a554653 100644 --- a/doc/rxvt.7.html +++ b/doc/rxvt.7.html @@ -241,13 +241,13 @@ daemon.
The Debian GNU/Linux package of rxvt-unicode in sarge contains large -patches that considerably change the behaviour of rxvt-unicode. Before -reporting a bug to the original rxvt-unicode author please download and -install the genuine version (http://software.schmorp.de#rxvt-unicode) -and try to reproduce the problem. If you cannot, chances are that the -problems are specific to Debian GNU/Linux, in which case it should be -reported via the Debian Bug Tracking System (use reportbug to report -the bug). +patches that considerably change the behaviour of rxvt-unicode (but +unfortunately this notice has been removed). Before reporting a bug to +the original rxvt-unicode author please download and install the genuine +version (http://software.schmorp.de#rxvt-unicode) and try to reproduce +the problem. If you cannot, chances are that the problems are specific to +Debian GNU/Linux, in which case it should be reported via the Debian Bug +Tracking System (use reportbug to report the bug).

For other problems that also affect the Debian package, you can and @@ -256,7 +256,8 @@ bug in the Debian version and it serves as a reminder for other users that might encounter the same issue.

-
I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation?
+
I am maintaining rxvt-unicode for distribution/OS XXX, any +recommendation?
You should build one binary with the default options. configure @@ -1949,7 +1950,7 @@ Set XTerm Parameters. 8-bit ST: 0x9c, 7-bit ST sequence: ESC \ (0x1b, Ps = 17Change colour of highlight characters to Pt Ps = 18Change colour of bold characters to Pt [deprecated, see 706] Ps = 19Change colour of underlined characters to Pt [deprecated, see 707] -Ps = 20Change default background to Pt +Ps = 20Change background pixmap parameters (see section XPM) (Compile XPM). Ps = 39Change default foreground colour to Pt. Ps = 46Change Log File to Pt unimplemented Ps = 49Change default background colour to Pt. diff --git a/doc/rxvt.7.man.in b/doc/rxvt.7.man.in index d563d136..bd7aa015 100644 --- a/doc/rxvt.7.man.in +++ b/doc/rxvt.7.man.in @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "rxvt 7" -.TH rxvt 7 "2006-01-17" "7.1" "RXVT-UNICODE" +.TH rxvt 7 "2006-01-19" "7.1" "RXVT-UNICODE" .SH "NAME" RXVT REFERENCE \- FAQ, command sequences and other background information .SH "SYNOPSIS" @@ -301,13 +301,13 @@ daemon. .IP "I am using Debian GNU/Linux and have a problem..." 4 .IX Item "I am using Debian GNU/Linux and have a problem..." The Debian GNU/Linux package of rxvt-unicode in sarge contains large -patches that considerably change the behaviour of rxvt\-unicode. Before -reporting a bug to the original rxvt-unicode author please download and -install the genuine version () -and try to reproduce the problem. If you cannot, chances are that the -problems are specific to Debian GNU/Linux, in which case it should be -reported via the Debian Bug Tracking System (use \f(CW\*(C`reportbug\*(C'\fR to report -the bug). +patches that considerably change the behaviour of rxvt-unicode (but +unfortunately this notice has been removed). Before reporting a bug to +the original rxvt-unicode author please download and install the genuine +version () and try to reproduce +the problem. If you cannot, chances are that the problems are specific to +Debian GNU/Linux, in which case it should be reported via the Debian Bug +Tracking System (use \f(CW\*(C`reportbug\*(C'\fR to report the bug). .Sp For other problems that also affect the Debian package, you can and probably should use the Debian \s-1BTS\s0, too, because, after all, it's also a @@ -1811,7 +1811,7 @@ Ps = 13 Change colour of mouse foreground to Pt Ps = 17 Change colour of highlight characters to Pt Ps = 18 Change colour of bold characters to Pt [deprecated, see 706] Ps = 19 Change colour of underlined characters to Pt [deprecated, see 707] -Ps = 20 Change default background to Pt +Ps = 20 Change background pixmap parameters (see section XPM) (Compile XPM). Ps = 39 Change default foreground colour to Pt. Ps = 46 Change Log File to Pt unimplemented Ps = 49 Change default background colour to Pt. diff --git a/doc/rxvt.7.txt b/doc/rxvt.7.txt index 810fab1a..4ce96c17 100644 --- a/doc/rxvt.7.txt +++ b/doc/rxvt.7.txt @@ -151,13 +151,14 @@ FREQUENTLY ASKED QUESTIONS I am using Debian GNU/Linux and have a problem... The Debian GNU/Linux package of rxvt-unicode in sarge contains large - patches that considerably change the behaviour of rxvt-unicode. - Before reporting a bug to the original rxvt-unicode author please - download and install the genuine version - () and try to reproduce the - problem. If you cannot, chances are that the problems are specific - to Debian GNU/Linux, in which case it should be reported via the - Debian Bug Tracking System (use "reportbug" to report the bug). + patches that considerably change the behaviour of rxvt-unicode (but + unfortunately this notice has been removed). Before reporting a bug + to the original rxvt-unicode author please download and install the + genuine version () and try + to reproduce the problem. If you cannot, chances are that the + problems are specific to Debian GNU/Linux, in which case it should + be reported via the Debian Bug Tracking System (use "reportbug" to + report the bug). For other problems that also affect the Debian package, you can and probably should use the Debian BTS, too, because, after all, it's @@ -1346,7 +1347,7 @@ XTerm Operating System Commands Ps = 17 Change colour of highlight characters to Pt Ps = 18 Change colour of bold characters to Pt [deprecated, see 706] Ps = 19 Change colour of underlined characters to Pt [deprecated, see 707] - Ps = 20 Change default background to Pt + Ps = 20 Change background pixmap parameters (see section XPM) (Compile XPM). Ps = 39 Change default foreground colour to Pt. Ps = 46 Change Log File to Pt unimplemented Ps = 49 Change default background colour to Pt. diff --git a/doc/rxvtperl.3.html b/doc/rxvtperl.3.html index d34b1730..82d0c820 100644 --- a/doc/rxvtperl.3.html +++ b/doc/rxvtperl.3.html @@ -149,6 +149,30 @@ Binds a popup menu to Ctrl-Button3 that lets you convert the selection text into various other formats/action (such as uri unescaping, perl evalution, web-browser starting etc.), depending on content.
+
+

Other extensions can extend this popup menu by pushing a code reference +onto @{ $term-{selection_popup_hook} }>, that is called whenever the +popup is displayed.

+
+
+

It's sole argument is the popup menu, which can be modified. The selection +is in $_, which can be used to decide wether to add something or not. +It should either return nothing or a string and a code reference. The +string will be used as button text and the code reference will be called +when the button gets activated and should transform $_.

+
+
+

The following will add an entry a to b that transforms all as in +the selection to bs, but only if the selection currently contains any +as:

+
+
+
+   push @{ $self->{term}{selection_popup_hook} }, sub {
+      /a/ ? ("a to be" => sub { s/a/b/g }
+          : ()
+   };
+

searchable-scrollback<hotkey> (enabled by default)
@@ -199,7 +223,7 @@ paste directly into your (vi :) editor:

-   URxvt.selection-autotransform.0: s/^([^:[:space:]]+(\\d+):?$/\\x1b:e \\Q$1\\E\\x0d:$2\\x0d/
+ URxvt.selection-autotransform.0: s/^([^:[:space:]]+(\\d+):?$/:e \\Q$1\\E\\x0d:$2\\x0d/

Of course, this can be modified to suit your needs and your editor :)

@@ -210,8 +234,8 @@ FILENAME line YYY.''), you need a slightly more elaborate solution:

-   URxvt.selection.pattern-0: ( at .*? line \\d+\\.)
-   URxvt.selection-autotransform.0: s/^ at (.*?) line (\\d+)\\.$/\x1b:e \\Q$1\E\\x0d:$2\\x0d/
+ URxvt.selection.pattern-0: ( at .*? line \\d+[,.]) + URxvt.selection-autotransform.0: s/^ at (.*?) line (\\d+)[,.]$/:e \\Q$1\E\\x0d:$2\\x0d/

The first line tells the selection code to treat the unchanging part of @@ -228,6 +252,18 @@ resource urlLauncher (default x-www-browser) will be s the URL as first argument.

+
automove-background
+
+
+This is basically a one-line extension that dynamically changes the background pixmap offset +to the window position, in effect creating the same effect as pseudo transparency with +a custom pixmap. No scaling is supported in this mode. Exmaple: +
+
+
+   rxvt -pixmap background.xpm -pe automove-background
+
+

block-graphics-to-ascii
@@ -404,6 +440,19 @@ Called at the very end of initialisation of a new terminal, just before returning to the mainloop.

+
on_child_start $term, $pid
+
+
+Called just after the child process has been forked. +
+

+
on_child_exit $term, $status
+
+
+Called just after the child process has exited. $status is the status +from waitpid. +
+

on_sel_make $term, $eventtime
@@ -558,6 +607,8 @@ Called wheneever the window loses keyboard focus, before rxvt-unicode does focus out processing.

+
on_configure_notify $term, $event
+
on_key_press $term, $event, $keysym, $octets
on_key_release $term, $event, $keysym
@@ -775,6 +826,18 @@ etc.). Please note that rxvt will not exit as long as any event watchers (timers, io watchers) are still active.

+
$term->exec_async ($cmd[, @args])
+
+
+Works like the combination of the fork/exec builtins, which executes +(``starts'') programs in the background. This function takes care of setting +the user environment before exec'ing the command (e.g. PATH) and should +be preferred over explicit calls to exec or system. +
+
+

Returns the pid of the subprocess or undef on error.

+
+

$isset = $term->option ($optval[, $set])
@@ -790,10 +853,10 @@ source file /src/optinc.h to see the actual list:

  borderLess console cursorBlink cursorUnderline hold iconic insecure
  intensityStyles jumpScroll loginShell mapAlert meta8 mouseWheelScrollPage
- pastableTabs pointerBlank reverseVideo scrollBar scrollBar_floating
- scrollBar_right scrollTtyKeypress scrollTtyOutput scrollWithBuffer
- secondaryScreen secondaryScroll skipBuiltinGlyphs transparent
- tripleclickwords utmpInhibit visualBell
+ override-redirect pastableTabs pointerBlank reverseVideo scrollBar + scrollBar_floating scrollBar_right scrollTtyKeypress scrollTtyOutput + scrollWithBuffer secondaryScreen secondaryScroll skipBuiltinGlyphs + transparent tripleclickwords utmpInhibit visualBell

$value = $term->resource ($name[, $newval])
@@ -828,14 +891,15 @@ to see the actual list:

borderLess color cursorBlink cursorUnderline cutchars delete_key display_name embed ext_bwidth fade font geometry hold iconName imFont imLocale inputMethod insecure int_bwidth intensityStyles - italicFont jumpScroll lineSpace loginShell mapAlert menu meta8 modifier - mouseWheelScrollPage name pastableTabs path perl_eval perl_ext_1 perl_ext_2 - perl_lib pointerBlank pointerBlankDelay preeditType print_pipe pty_fd - reverseVideo saveLines scrollBar scrollBar_align scrollBar_floating - scrollBar_right scrollBar_thickness scrollTtyKeypress scrollTtyOutput - scrollWithBuffer scrollstyle secondaryScreen secondaryScroll selectstyle - shade term_name title transparent transparent_all tripleclickwords - utmpInhibit visualBell + italicFont jumpScroll lineSpace loginShell mapAlert meta8 modifier + mouseWheelScrollPage name override_redirect pastableTabs path perl_eval + perl_ext_1 perl_ext_2 perl_lib pointerBlank pointerBlankDelay + preeditType print_pipe pty_fd reverseVideo saveLines scrollBar + scrollBar_align scrollBar_floating scrollBar_right scrollBar_thickness + scrollTtyKeypress scrollTtyOutput scrollWithBuffer scrollstyle + secondaryScreen secondaryScroll selectstyle shade term_name title + transient_for transparent transparent_all tripleclickwords utmpInhibit + visualBell

$value = $term->x_resource ($pattern)
@@ -1408,6 +1472,12 @@ Start the timer. Set the event trigger time to $tstamp and start the timer.

+
$timer = $timer->after ($delay)
+
+
+Like start, but sets the expiry timer to c<urxvt::NOW + $delay>. +
+

$timer = $timer->stop
diff --git a/doc/rxvtperl.3.man.in b/doc/rxvtperl.3.man.in index c1612b85..ac316052 100644 --- a/doc/rxvtperl.3.man.in +++ b/doc/rxvtperl.3.man.in @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "rxvt 3" -.TH rxvt 3 "2006-01-18" "7.1" "RXVT-UNICODE" +.TH rxvt 3 "2006-01-19" "7.1" "RXVT-UNICODE" .SH "NAME" @@RXVT_NAME@@perl \- rxvt\-unicode's embedded perl interpreter .SH "SYNOPSIS" @@ -226,6 +226,27 @@ runtime. Binds a popup menu to Ctrl\-Button3 that lets you convert the selection text into various other formats/action (such as uri unescaping, perl evalution, web-browser starting etc.), depending on content. +.Sp +Other extensions can extend this popup menu by pushing a code reference +onto \f(CW\*(C`@{ $term\-\*(C'\fR{selection_popup_hook} }>, that is called whenever the +popup is displayed. +.Sp +It's sole argument is the popup menu, which can be modified. The selection +is in \f(CW$_\fR, which can be used to decide wether to add something or not. +It should either return nothing or a string and a code reference. The +string will be used as button text and the code reference will be called +when the button gets activated and should transform \f(CW$_\fR. +.Sp +The following will add an entry \f(CW\*(C`a to b\*(C'\fR that transforms all \f(CW\*(C`a\*(C'\fRs in +the selection to \f(CW\*(C`b\*(C'\fRs, but only if the selection currently contains any +\&\f(CW\*(C`a\*(C'\fRs: +.Sp +.Vb 4 +\& push @{ $self->{term}{selection_popup_hook} }, sub { +\& /a/ ? ("a to be" => sub { s/a/b/g } +\& : () +\& }; +.Ve .IP "searchable\-scrollback (enabled by default)" 4 .IX Item "searchable-scrollback (enabled by default)" Adds regex search functionality to the scrollback buffer, triggered @@ -266,7 +287,7 @@ And this example matches the same,but replaces it with vi-commands you can paste directly into your (vi :) editor: .Sp .Vb 1 -\& URxvt.selection-autotransform.0: s/^([^:[:space:]]+(\e\ed+):?$/\e\ex1b:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/ +\& URxvt.selection-autotransform.0: s/^([^:[:space:]]+(\e\ed+):?$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/ .Ve .Sp Of course, this can be modified to suit your needs and your editor :) @@ -275,8 +296,8 @@ To expand the example above to typical perl error messages (\*(L"\s-1XXX\s0 at \&\s-1FILENAME\s0 line \s-1YYY\s0.\*(R"), you need a slightly more elaborate solution: .Sp .Vb 2 -\& URxvt.selection.pattern-0: ( at .*? line \e\ed+\e\e.) -\& URxvt.selection-autotransform.0: s/^ at (.*?) line (\e\ed+)\e\e.$/\ex1b:e \e\eQ$1\eE\e\ex0d:$2\e\ex0d/ +\& URxvt.selection.pattern-0: ( at .*? line \e\ed+[,.]) +\& URxvt.selection-autotransform.0: s/^ at (.*?) line (\e\ed+)[,.]$/:e \e\eQ$1\eE\e\ex0d:$2\e\ex0d/ .Ve .Sp The first line tells the selection code to treat the unchanging part of @@ -288,6 +309,15 @@ Uses per-line display filtering (\f(CW\*(C`on_line_update\*(C'\fR) to underline 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 "automove-background" 4 +.IX Item "automove-background" +This is basically a one-line extension that dynamically changes the background pixmap offset +to the window position, in effect creating the same effect as pseudo transparency with +a custom pixmap. No scaling is supported in this mode. Exmaple: +.Sp +.Vb 1 +\& @@RXVT_NAME@@ -pixmap background.xpm -pe automove-background +.Ve .IP "block-graphics-to-ascii" 4 .IX Item "block-graphics-to-ascii" A not very useful example of filtering all text output to the terminal, @@ -425,6 +455,15 @@ variables. .IX Item "on_start $term" Called at the very end of initialisation of a new terminal, just before returning to the mainloop. +.ie n .IP "on_child_start $term\fR, \f(CW$pid" 4 +.el .IP "on_child_start \f(CW$term\fR, \f(CW$pid\fR" 4 +.IX Item "on_child_start $term, $pid" +Called just after the child process has been \f(CW\*(C`fork\*(C'\fRed. +.ie n .IP "on_child_exit $term\fR, \f(CW$status" 4 +.el .IP "on_child_exit \f(CW$term\fR, \f(CW$status\fR" 4 +.IX Item "on_child_exit $term, $status" +Called just after the child process has exited. \f(CW$status\fR is the status +from \f(CW\*(C`waitpid\*(C'\fR. .ie n .IP "on_sel_make $term\fR, \f(CW$eventtime" 4 .el .IP "on_sel_make \f(CW$term\fR, \f(CW$eventtime\fR" 4 .IX Item "on_sel_make $term, $eventtime" @@ -542,10 +581,13 @@ does focus in processing. .IX Item "on_focus_out $term" Called wheneever the window loses keyboard focus, before rxvt-unicode does focus out processing. +.ie n .IP "on_configure_notify $term\fR, \f(CW$event" 4 +.el .IP "on_configure_notify \f(CW$term\fR, \f(CW$event\fR" 4 +.IX Item "on_configure_notify $term, $event" +.PD 0 .ie n .IP "on_key_press $term\fR, \f(CW$event\fR, \f(CW$keysym\fR, \f(CW$octets" 4 .el .IP "on_key_press \f(CW$term\fR, \f(CW$event\fR, \f(CW$keysym\fR, \f(CW$octets\fR" 4 .IX Item "on_key_press $term, $event, $keysym, $octets" -.PD 0 .ie n .IP "on_key_release $term\fR, \f(CW$event\fR, \f(CW$keysym" 4 .el .IP "on_key_release \f(CW$term\fR, \f(CW$event\fR, \f(CW$keysym\fR" 4 .IX Item "on_key_release $term, $event, $keysym" @@ -706,6 +748,15 @@ initialise perl, and the terminal object otherwise. The \f(CW\*(C`init\*(C'\fR a Destroy the terminal object (close the window, free resources etc.). Please note that @@RXVT_NAME@@ will not exit as long as any event watchers (timers, io watchers) are still active. +.ie n .IP "$term\->exec_async ($cmd[, @args])" 4 +.el .IP "$term\->exec_async ($cmd[, \f(CW@args\fR])" 4 +.IX Item "$term->exec_async ($cmd[, @args])" +Works like the combination of the \f(CW\*(C`fork\*(C'\fR/\f(CW\*(C`exec\*(C'\fR builtins, which executes +(\*(L"starts\*(R") programs in the background. This function takes care of setting +the user environment before exec'ing the command (e.g. \f(CW\*(C`PATH\*(C'\fR) and should +be preferred over explicit calls to \f(CW\*(C`exec\*(C'\fR or \f(CW\*(C`system\*(C'\fR. +.Sp +Returns the pid of the subprocess or \f(CW\*(C`undef\*(C'\fR on error. .ie n .IP "$isset = $term\fR\->option ($optval[, \f(CW$set])" 4 .el .IP "$isset = \f(CW$term\fR\->option ($optval[, \f(CW$set\fR])" 4 .IX Item "$isset = $term->option ($optval[, $set])" @@ -719,10 +770,10 @@ source file \fI/src/optinc.h\fR to see the actual list: .Vb 6 \& borderLess console cursorBlink cursorUnderline hold iconic insecure \& intensityStyles jumpScroll loginShell mapAlert meta8 mouseWheelScrollPage -\& pastableTabs pointerBlank reverseVideo scrollBar scrollBar_floating -\& scrollBar_right scrollTtyKeypress scrollTtyOutput scrollWithBuffer -\& secondaryScreen secondaryScroll skipBuiltinGlyphs transparent -\& tripleclickwords utmpInhibit visualBell +\& override-redirect pastableTabs pointerBlank reverseVideo scrollBar +\& scrollBar_floating scrollBar_right scrollTtyKeypress scrollTtyOutput +\& scrollWithBuffer secondaryScreen secondaryScroll skipBuiltinGlyphs +\& transparent tripleclickwords utmpInhibit visualBell .Ve .ie n .IP "$value = $term\fR\->resource ($name[, \f(CW$newval])" 4 .el .IP "$value = \f(CW$term\fR\->resource ($name[, \f(CW$newval\fR])" 4 @@ -746,19 +797,20 @@ Here is a a likely non-exhaustive list of resource names, not all of which are supported in every build, please see the source file \fI/src/rsinc.h\fR to see the actual list: .Sp -.Vb 12 +.Vb 13 \& answerbackstring backgroundPixmap backspace_key boldFont boldItalicFont \& borderLess color cursorBlink cursorUnderline cutchars delete_key \& display_name embed ext_bwidth fade font geometry hold iconName \& imFont imLocale inputMethod insecure int_bwidth intensityStyles -\& italicFont jumpScroll lineSpace loginShell mapAlert menu meta8 modifier -\& mouseWheelScrollPage name pastableTabs path perl_eval perl_ext_1 perl_ext_2 -\& perl_lib pointerBlank pointerBlankDelay preeditType print_pipe pty_fd -\& reverseVideo saveLines scrollBar scrollBar_align scrollBar_floating -\& scrollBar_right scrollBar_thickness scrollTtyKeypress scrollTtyOutput -\& scrollWithBuffer scrollstyle secondaryScreen secondaryScroll selectstyle -\& shade term_name title transparent transparent_all tripleclickwords -\& utmpInhibit visualBell +\& italicFont jumpScroll lineSpace loginShell mapAlert meta8 modifier +\& mouseWheelScrollPage name override_redirect pastableTabs path perl_eval +\& perl_ext_1 perl_ext_2 perl_lib pointerBlank pointerBlankDelay +\& preeditType print_pipe pty_fd reverseVideo saveLines scrollBar +\& scrollBar_align scrollBar_floating scrollBar_right scrollBar_thickness +\& scrollTtyKeypress scrollTtyOutput scrollWithBuffer scrollstyle +\& secondaryScreen secondaryScroll selectstyle shade term_name title +\& transient_for transparent transparent_all tripleclickwords utmpInhibit +\& visualBell .Ve .ie n .IP "$value = $term\->x_resource ($pattern)" 4 .el .IP "$value = \f(CW$term\fR\->x_resource ($pattern)" 4 @@ -1203,6 +1255,10 @@ Start the timer. .el .IP "$timer = \f(CW$timer\fR\->start ($tstamp)" 4 .IX Item "$timer = $timer->start ($tstamp)" Set the event trigger time to \f(CW$tstamp\fR and start the timer. +.ie n .IP "$timer = $timer\->after ($delay)" 4 +.el .IP "$timer = \f(CW$timer\fR\->after ($delay)" 4 +.IX Item "$timer = $timer->after ($delay)" +Like \f(CW\*(C`start\*(C'\fR, but sets the expiry timer to c. .ie n .IP "$timer = $timer\->stop" 4 .el .IP "$timer = \f(CW$timer\fR\->stop" 4 .IX Item "$timer = $timer->stop" diff --git a/doc/rxvtperl.3.txt b/doc/rxvtperl.3.txt index 251977d0..8b86656d 100644 --- a/doc/rxvtperl.3.txt +++ b/doc/rxvtperl.3.txt @@ -76,6 +76,26 @@ PREPACKAGED EXTENSIONS unescaping, perl evalution, web-browser starting etc.), depending on content. + Other extensions can extend this popup menu by pushing a code + reference onto "@{ $term-"{selection_popup_hook} }>, that is called + whenever the popup is displayed. + + It's sole argument is the popup menu, which can be modified. The + selection is in $_, which can be used to decide wether to add + something or not. It should either return nothing or a string and a + code reference. The string will be used as button text and the code + reference will be called when the button gets activated and should + transform $_. + + The following will add an entry "a to b" that transforms all "a"s in + the selection to "b"s, but only if the selection currently contains + any "a"s: + + push @{ $self->{term}{selection_popup_hook} }, sub { + /a/ ? ("a to be" => sub { s/a/b/g } + : () + }; + searchable-scrollback (enabled by default) Adds regex search functionality to the scrollback buffer, triggered by a hotkey (default: "M-s"). While in search mode, normal terminal @@ -110,7 +130,7 @@ PREPACKAGED EXTENSIONS And this example matches the same,but replaces it with vi-commands you can paste directly into your (vi :) editor: - URxvt.selection-autotransform.0: s/^([^:[:space:]]+(\\d+):?$/\\x1b:e \\Q$1\\E\\x0d:$2\\x0d/ + URxvt.selection-autotransform.0: s/^([^:[:space:]]+(\\d+):?$/:e \\Q$1\\E\\x0d:$2\\x0d/ Of course, this can be modified to suit your needs and your editor :) @@ -118,8 +138,8 @@ PREPACKAGED EXTENSIONS To expand the example above to typical perl error messages ("XXX at FILENAME line YYY."), you need a slightly more elaborate solution: - URxvt.selection.pattern-0: ( at .*? line \\d+\\.) - URxvt.selection-autotransform.0: s/^ at (.*?) line (\\d+)\\.$/\x1b:e \\Q$1\E\\x0d:$2\\x0d/ + URxvt.selection.pattern-0: ( at .*? line \\d+[,.]) + URxvt.selection-autotransform.0: s/^ at (.*?) line (\\d+)[,.]$/:e \\Q$1\E\\x0d:$2\\x0d/ The first line tells the selection code to treat the unchanging part of every error message as a selection pattern, and the second line @@ -131,6 +151,14 @@ PREPACKAGED EXTENSIONS in the resource "urlLauncher" (default "x-www-browser") will be started with the URL as first argument. + automove-background + This is basically a one-line extension that dynamically changes the + background pixmap offset to the window position, in effect creating + the same effect as pseudo transparency with a custom pixmap. No + scaling is supported in this mode. Exmaple: + + rxvt -pixmap background.xpm -pe automove-background + block-graphics-to-ascii A not very useful example of filtering all text output to the terminal, by replacing all line-drawing characters (U+2500 .. @@ -257,6 +285,13 @@ API DOCUMENTATION Called at the very end of initialisation of a new terminal, just before returning to the mainloop. + on_child_start $term, $pid + Called just after the child process has been "fork"ed. + + on_child_exit $term, $status + Called just after the child process has exited. $status is the + status from "waitpid". + on_sel_make $term, $eventtime Called whenever a selection has been made by the user, but before the selection text is copied, so changes to the beginning, end or @@ -363,6 +398,7 @@ API DOCUMENTATION Called wheneever the window loses keyboard focus, before rxvt-unicode does focus out processing. + on_configure_notify $term, $event on_key_press $term, $event, $keysym, $octets on_key_release $term, $event, $keysym on_button_press $term, $event @@ -502,6 +538,15 @@ API DOCUMENTATION Please note that rxvt will not exit as long as any event watchers (timers, io watchers) are still active. + $term->exec_async ($cmd[, @args]) + Works like the combination of the "fork"/"exec" builtins, which + executes ("starts") programs in the background. This function takes + care of setting the user environment before exec'ing the command + (e.g. "PATH") and should be preferred over explicit calls to "exec" + or "system". + + Returns the pid of the subprocess or "undef" on error. + $isset = $term->option ($optval[, $set]) Returns true if the option specified by $optval is enabled, and optionally change it. All option values are stored by name in the @@ -513,10 +558,10 @@ API DOCUMENTATION borderLess console cursorBlink cursorUnderline hold iconic insecure intensityStyles jumpScroll loginShell mapAlert meta8 mouseWheelScrollPage - pastableTabs pointerBlank reverseVideo scrollBar scrollBar_floating - scrollBar_right scrollTtyKeypress scrollTtyOutput scrollWithBuffer - secondaryScreen secondaryScroll skipBuiltinGlyphs transparent - tripleclickwords utmpInhibit visualBell + override-redirect pastableTabs pointerBlank reverseVideo scrollBar + scrollBar_floating scrollBar_right scrollTtyKeypress scrollTtyOutput + scrollWithBuffer secondaryScreen secondaryScroll skipBuiltinGlyphs + transparent tripleclickwords utmpInhibit visualBell $value = $term->resource ($name[, $newval]) Returns the current resource value associated with a given name and @@ -543,14 +588,15 @@ API DOCUMENTATION borderLess color cursorBlink cursorUnderline cutchars delete_key display_name embed ext_bwidth fade font geometry hold iconName imFont imLocale inputMethod insecure int_bwidth intensityStyles - italicFont jumpScroll lineSpace loginShell mapAlert menu meta8 modifier - mouseWheelScrollPage name pastableTabs path perl_eval perl_ext_1 perl_ext_2 - perl_lib pointerBlank pointerBlankDelay preeditType print_pipe pty_fd - reverseVideo saveLines scrollBar scrollBar_align scrollBar_floating - scrollBar_right scrollBar_thickness scrollTtyKeypress scrollTtyOutput - scrollWithBuffer scrollstyle secondaryScreen secondaryScroll selectstyle - shade term_name title transparent transparent_all tripleclickwords - utmpInhibit visualBell + italicFont jumpScroll lineSpace loginShell mapAlert meta8 modifier + mouseWheelScrollPage name override_redirect pastableTabs path perl_eval + perl_ext_1 perl_ext_2 perl_lib pointerBlank pointerBlankDelay + preeditType print_pipe pty_fd reverseVideo saveLines scrollBar + scrollBar_align scrollBar_floating scrollBar_right scrollBar_thickness + scrollTtyKeypress scrollTtyOutput scrollWithBuffer scrollstyle + secondaryScreen secondaryScroll selectstyle shade term_name title + transient_for transparent transparent_all tripleclickwords utmpInhibit + visualBell $value = $term->x_resource ($pattern) Returns the X-Resource for the given pattern, excluding the program @@ -905,6 +951,9 @@ API DOCUMENTATION $timer = $timer->start ($tstamp) Set the event trigger time to $tstamp and start the timer. + $timer = $timer->after ($delay) + Like "start", but sets the expiry timer to c. + $timer = $timer->stop Stop the timer. diff --git a/src/version.h b/src/version.h index b42a35d5..09f111ce 100644 --- a/src/version.h +++ b/src/version.h @@ -1,3 +1,3 @@ // VERSION _must_ be \d.\d+ #define VERSION "7.1" -#define DATE "2006-01-13" +#define DATE "2006-01-19" -- 2.34.1