--- rxvt-unicode/doc/rxvt.7.man.in 2006/01/12 05:37:34 1.42 +++ rxvt-unicode/doc/rxvt.7.man.in 2006/01/31 00:53:49 1.57 @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "rxvt 7" -.TH rxvt 7 "2006-01-12" "7.0" "RXVT-UNICODE" +.TH rxvt 7 "2006-01-31" "7.5" "RXVT-UNICODE" .SH "NAME" RXVT REFERENCE \- FAQ, command sequences and other background information .SH "SYNOPSIS" @@ -153,11 +153,30 @@ This document contains the \s-1FAQ\s0, the \s-1RXVT\s0 \s-1TECHNICAL\s0 \s-1REFERENCE\s0 documenting all escape sequences, and other background information. .PP -The newest version of this document is -also available on the World Wide Web at +The newest version of this document is also available on the World Wide Web at . .SH "FREQUENTLY ASKED QUESTIONS" .IX Header "FREQUENTLY ASKED QUESTIONS" +.IP "The new selection selects pieces that are too big, how can I select single words?" 4 +.IX Item "The new selection selects pieces that are too big, how can I select single words?" +Yes. For example, if you want to select alphanumeric words, you can use +the following resource: +.Sp +.Vb 1 +\& URxvt.selection.pattern-0: ([[:word:]]+) +.Ve +.Sp +If you click more than twice, the selection will be extended +more and more. +.Sp +To get a selection that is very similar to the old code, try this pattern: +.Sp +.Vb 1 +\& URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\e\e\e\e]^`{|})]+) +.Ve +.Sp +Please also note that the \fILeftClick Shift-LeftClik\fR combination also +selects words like the old code. .IP "I don't like the new selection/popups/hotkeys/perl, how do I change/disable it?" 4 .IX Item "I don't like the new selection/popups/hotkeys/perl, how do I change/disable it?" You can disable the perl extension completely by setting the @@ -182,6 +201,99 @@ .Vb 1 \& URxvt.searchable-scrollback: CM-s .Ve +.IP "The cursor moves when selecting text in the current input line, how do I switch this off?" 4 +.IX Item "The cursor moves when selecting text in the current input line, how do I switch this off?" +.PD 0 +.IP "During rlogin/ssh/telnet/etc. sessions, clicking near the cursor outputs strange escape sequences, how do I fix this?" 4 +.IX Item "During rlogin/ssh/telnet/etc. sessions, clicking near the cursor outputs strange escape sequences, how do I fix this?" +.PD +These are caused by the \f(CW\*(C`readline\*(C'\fR perl extension. Under normal +circumstances, it will move your cursor around when you click into the +line that contains it. It tries hard not to do this at the wrong moment, +but when running a program that doesn't parse cursor movements or in some +cases during rlogin sessions, it fails to detect this properly. +.Sp +You can permamently switch this feature off by disabling the \f(CW\*(C`readline\*(C'\fR +extension: +.Sp +.Vb 1 +\& URxvt.perl-ext-common: default,-readline +.Ve +.IP "Why doesn't rxvt-unicode read my resources?" 4 +.IX Item "Why doesn't rxvt-unicode read my resources?" +Well, why, indeed? It does, in a way very similar to other X +applications. Most importantly, this means that if you or your \s-1OS\s0 loads +resources into the X display (the right way to do it), rxvt-unicode will +ignore any resource files in your home directory. It will only read +\&\fI$HOME/.Xdefaults\fR when no resources are attached to the display. +.Sp +If you have or use an \fI$HOME/.Xresources\fR file, chances are that +resources are loaded into your X\-server. In this case, you have to +re-login after every change (or run \fIxrdb \-merge \f(CI$HOME\fI/.Xresources\fR). +.Sp +Also consider the form resources have to use: +.Sp +.Vb 1 +\& URxvt.resource: value +.Ve +.Sp +If you want to use another form (there are lots of different ways of +specifying resources), make sure you understand wether and why it +works. If unsure, use the form above. +.IP "I can't get transparency working, what am I doing wrong?" 4 +.IX Item "I can't get transparency working, what am I doing wrong?" +First of all, transparency isn't officially supported in rxvt\-unicode, so +you are mostly on your own. Do not bug the author about it (but you may +bug everybody else). Also, if you can't get it working consider it a rite +of passage: ... and you failed. +.Sp +Here are four ways to get transparency. \fBDo\fR read the manpage and option +descriptions for the programs mentioned and rxvt\-unicode. Really, do it! +.Sp +1. Use inheritPixmap: +.Sp +.Vb 2 +\& Esetroot wallpaper.jpg +\& @@RXVT_NAME@@ -ip -tint red -sh 40 +.Ve +.Sp +That works. If you think it doesn't, you lack transparency and tinting +support, or you are unable to read. +.Sp +2. Use a simple pixmap and emulate pseudo\-transparency. This enables you +to use effects other than tinting and shading: Just shade/tint/whatever +your picture with gimp: +.Sp +.Vb 2 +\& convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm +\& @@RXVT_NAME@@ -pixmap background.xpm -pe automove-background +.Ve +.Sp +That works. If you think it doesn't, you lack \s-1XPM\s0 and Perl support, or you +are unable to read. +.Sp +3. Use an \s-1ARGB\s0 visual: +.Sp +.Vb 1 +\& @@RXVT_NAME@@ -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc +.Ve +.Sp +This requires \s-1XFT\s0 support, and the support of your X\-server. If that +doesn't work for you, blame Xorg and Keith Packard. \s-1ARGB\s0 visuals aren't +there yet, no matter what they claim. Rxvt-Unicode contains the neccessary +bugfixes and workarounds for Xft and Xlib to make it work, but that +doesn't mean that your \s-1WM\s0 has the required kludges in place. +.Sp +4. Use xcompmgr and let it do the job: +.Sp +.Vb 2 +\& xprop -frame -f _NET_WM_WINDOW_OPACITY 32c \e +\& -set _NET_WM_WINDOW_OPACITY 0xc0000000 +.Ve +.Sp +Then click on a window you want to make transparent. Replace \f(CW0xc0000000\fR +by other values to change the degree of opacity. If it doesn't work and +your server crashes, you got to keep the pieces. .IP "Isn't rxvt supposed to be small? Don't all those features bloat?" 4 .IX Item "Isn't rxvt supposed to be small? Don't all those features bloat?" I often get asked about this, and I think, no, they didn't cause extra @@ -266,12 +378,23 @@ except maybe libX11 :) .IP "Does it support tabs, can I have a tabbed rxvt\-unicode?" 4 .IX Item "Does it support tabs, can I have a tabbed rxvt-unicode?" -rxvt-unicode does not directly support tabs. It will work fine with -tabbing functionality of many window managers or similar tabbing programs, -and its embedding-features allow it to be embedded into other programs, -as witnessed by \fIdoc/rxvt\-tabbed\fR or the upcoming \f(CW\*(C`Gtk2::URxvt\*(C'\fR perl -module, which features a tabbed urxvt (murxvt) terminal as an example -embedding application. +Beginning with version 7.3, there is a perl extension that implements a +simple tabbed terminal. It is installed by default, so any of these should +give you tabs: +.Sp +.Vb 1 +\& @@RXVT_NAME@@ -pe tabbed +.Ve +.Sp +.Vb 1 +\& URxvt.perl-ext-common: default,tabbed +.Ve +.Sp +It will also work fine with tabbing functionality of many window managers +or similar tabbing programs, and its embedding-features allow it to be +embedded into other programs, as witnessed by \fIdoc/rxvt\-tabbed\fR or +the upcoming \f(CW\*(C`Gtk2::URxvt\*(C'\fR perl module, which features a tabbed urxvt +(murxvt) terminal as an example embedding application. .IP "How do I know which rxvt-unicode version I'm using?" 4 .IX Item "How do I know which rxvt-unicode version I'm using?" The version number is displayed with the usage (\-h). Also the escape @@ -281,13 +404,13 @@ .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 @@ -314,22 +437,20 @@ encodings built-in that increase download times and are rarely used). .IP "I need to make it setuid/setgid to support utmp/ptys on my \s-1OS\s0, is this safe?" 4 .IX Item "I need to make it setuid/setgid to support utmp/ptys on my OS, is this safe?" -Likely not. While I honestly try to make it secure, and am probably not -bad at it, I think it is simply unreasonable to expect all of freetype -+ fontconfig + xft + xlib + perl + ... + rxvt-unicode itself to all be -secure. Also, rxvt-unicode disables some options when it detects that it -runs setuid or setgid, which is not nice. Besides, with the embedded perl -interpreter the possibility for security problems easily multiplies. -.Sp -Elevated privileges are only required for utmp and pty operations on some -systems (for example, GNU/Linux doesn't need any extra privileges for -ptys, but some need it for utmp support). It is planned to mvoe this into -a forked handler process, but this is not yet done. -.Sp -So, while setuid/setgid operation is supported and not a problem on your -typical single-user-no-other-logins unix desktop, always remember that -its an awful lot of code, most of which isn't checked for security issues -regularly. +It should be, starting with release 7.1. You are encouraged to properly +install urxvt with privileges necessary for your \s-1OS\s0 now. +.Sp +When rxvt-unicode detects that it runs setuid or setgid, it will fork +into a helper process for privileged operations (pty handling on some +systems, utmp/wtmp/lastlog handling on others) and drop privileges +immediately. This is much safer than most other terminals that keep +privileges while running (but is more relevant to urxvt, as it contains +things as perl interpreters, which might be \*(L"helpful\*(R" to attackers). +.Sp +This forking is done as the very first within \fImain()\fR, which is very early +and reduces possible bugs to initialisation code run before \fImain()\fR, or +things like the dynamic loader of your system, which should result in very +little risk. .IP "When I log-in to another system it tells me about missing terminfo data?" 4 .IX Item "When I log-in to another system it tells me about missing terminfo data?" The terminal description used by rxvt-unicode is not as widely available @@ -757,7 +878,7 @@ terminal, using the resource \f(CW\*(C`imlocale\*(C'\fR: .Sp .Vb 1 -\& URxvt*imlocale: ja_JP.EUC-JP +\& URxvt.imlocale: ja_JP.EUC-JP .Ve .Sp Now you can start your terminal with \f(CW\*(C`LC_CTYPE=ja_JP.UTF\-8\*(C'\fR and still @@ -809,7 +930,7 @@ some editors prematurely may leave the mouse in mouse report mode. I've heard that tcsh may use mouse reporting unless it otherwise specified. A quick check is to see if cut/paste works when the Alt or Shift keys are -depressed. See @@RXVT_NAME@@(7) +depressed. .IP "What's with this bold/blink stuff?" 4 .IX Item "What's with this bold/blink stuff?" If no bold colour is set via \f(CW\*(C`colorBD:\*(C'\fR, bold will invert text using the @@ -914,7 +1035,7 @@ \& $ @@RXVT_NAME@@ .Ve .Sp -Toggle with \f(CW\*(C`ESC [ 36 h\*(C'\fR / \f(CW\*(C`ESC [ 36 l\*(C'\fR as documented in @@RXVT_NAME@@(7). +Toggle with \f(CW\*(C`ESC [ 36 h\*(C'\fR / \f(CW\*(C`ESC [ 36 l\*(C'\fR. .Sp For an existing rxvt\-unicode: .Sp @@ -1040,8 +1161,8 @@ .IX Header "DESCRIPTION" The rest of this document describes various technical aspects of \&\fBrxvt-unicode\fR. First the description of supported command sequences, -followed by menu and pixmap support and last by a description of all -features selectable at \f(CW\*(C`configure\*(C'\fR time. +followed by pixmap support and last by a description of all features +selectable at \f(CW\*(C`configure\*(C'\fR time. .SH "Definitions" .IX Header "Definitions" .ie n .IP "\fB\fB""c""\fB\fR" 4 @@ -1598,15 +1719,6 @@ l No mouse reporting. .TE -.ie n .IP "\fB\fB""Ps = 10""\fB\fR (\fBrxvt\fR)" 4 -.el .IP "\fB\f(CBPs = 10\fB\fR (\fBrxvt\fR)" 4 -.IX Item "Ps = 10 (rxvt)" -.TS -l l . -h menuBar visible -l menuBar invisible -.TE - .ie n .IP "\fB\fB""Ps = 25""\fB\fR" 4 .el .IP "\fB\f(CBPs = 25\fB\fR" 4 .IX Item "Ps = 25" @@ -1802,14 +1914,14 @@ 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. Ps = 50 Set fontset to Pt, with the following special values of Pt (rxvt) #+n change up n #-n change down n if n is missing of 0, a value of 1 is used empty change to font0 n change to font n Ps = 55 Log all scrollback buffer and all of screen to Pt Ps = 701 Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills). -Ps = 703 Menubar command Pt (Compile menubar). +Ps = 702 Request version if Pt is ?, returning rxvt-unicode, the resource name, the major and minor version numbers, e.g. ESC ] 702 ; rxvt-unicode ; urxvt ; 7 ; 4 ST. Ps = 704 Change colour of italic characters to Pt Ps = 705 Change background pixmap tint colour to Pt (Compile transparency). Ps = 706 Change colour of bold characters to Pt @@ -1825,380 +1937,7 @@ .PP -.IX Xref "menuBar" -.SH "menuBar" -.IX Header "menuBar" -\&\fBThe exact syntax used is \f(BIalmost\fB solidified.\fR -In the menus, \fB\s-1DON\s0'T\fR try to use menuBar commands that add or remove a -menuBar. -.PP -Note that in all of the commands, the \fB\f(BI/path/\fB\fR \fIcannot\fR be -omitted: use \fB./\fR to specify a menu relative to the current menu. -.Sh "Overview of menuBar operation" -.IX Subsection "Overview of menuBar operation" -For the menuBar XTerm escape sequence \f(CW\*(C`ESC ] 703 ; Pt ST\*(C'\fR, the syntax -of \f(CW\*(C`Pt\*(C'\fR can be used for a variety of tasks: -.PP -At the top level is the current menuBar which is a member of a circular -linked-list of other such menuBars. -.PP -The menuBar acts as a parent for the various drop-down menus, which in -turn, may have labels, separator lines, menuItems and subMenus. -.PP -The menuItems are the useful bits: you can use them to mimic keyboard -input or even to send text or escape sequences back to rxvt. -.PP -The menuBar syntax is intended to provide a simple yet robust method of -constructing and manipulating menus and navigating through the -menuBars. -.PP -The first step is to use the tag \fB[menu:\f(BIname\fB]\fR which creates -the menuBar called \fIname\fR and allows access. You may now or menus, -subMenus, and menuItems. Finally, use the tag \fB[done]\fR to set the -menuBar access as \fBreadonly\fR to prevent accidental corruption of the -menus. To re-access the current menuBar for alterations, use the tag -\&\fB[menu]\fR, make the alterations and then use \fB[done]\fR -.PP - -.IX Xref "menuBarCommands" -.Sh "Commands" -.IX Subsection "Commands" -.IP "\fB[menu:+\f(BIname\fB]\fR" 4 -.IX Item "[menu:+name]" -access the named menuBar for creation or alteration. If a new menuBar -is created, it is called \fIname\fR (max of 15 chars) and the current -menuBar is pushed onto the stack -.IP "\fB[menu]\fR" 4 -.IX Item "[menu]" -access the current menuBar for alteration -.IP "\fB[title:+\f(BIstring\fB]\fR" 4 -.IX Item "[title:+string]" -set the current menuBar's title to \fIstring\fR, which may contain the -following format specifiers: -.Sp -.Vb 3 -\& B<%n> rxvt name (as per the B<-name> command-line option) -\& B<%v> rxvt version -\& B<%%> literal B<%> character -.Ve -.IP "\fB[done]\fR" 4 -.IX Item "[done]" -set menuBar access as \fBreadonly\fR. -End-of-file tag for \fB[read:+\f(BIfile\fB]\fR operations. -.IP "\fB[read:+\f(BIfile\fB]\fR" 4 -.IX Item "[read:+file]" -read menu commands directly from \fIfile\fR (extension \*(L".menu\*(R" will be -appended if required.) Start reading at a line with \fB[menu]\fR or \fB[menu:+\f(BIname\fB\fR and continuing until \fB[done]\fR is encountered. -.Sp -Blank and comment lines (starting with \fB#\fR) are ignored. Actually, -since any invalid menu commands are also ignored, almost anything could -be construed as a comment line, but this may be tightened up in the -future ... so don't count on it!. -.IP "\fB[read:+\f(BIfile\fB;+\f(BIname\fB]\fR" 4 -.IX Item "[read:+file;+name]" -The same as \fB[read:+\f(BIfile\fB]\fR, but start reading at a line with -\&\fB[menu:+\f(BIname\fB]\fR and continuing until \fB[done:+\f(BIname\fB]\fR or -\&\fB[done]\fR is encountered. -.IP "\fB[dump]\fR" 4 -.IX Item "[dump]" -dump all menuBars to the file \fB/tmp/rxvt\-PID\fR in a format suitable for -later rereading. -.IP "\fB[rm:name]\fR" 4 -.IX Item "[rm:name]" -remove the named menuBar -.IP "\fB[rm] [rm:]\fR" 4 -.IX Item "[rm] [rm:]" -remove the current menuBar -.IP "\fB[rm*] [rm:*]\fR" 4 -.IX Item "[rm*] [rm:*]" -remove all menuBars -.IP "\fB[swap]\fR" 4 -.IX Item "[swap]" -swap the top two menuBars -.IP "\fB[prev]\fR" 4 -.IX Item "[prev]" -access the previous menuBar -.IP "\fB[next]\fR" 4 -.IX Item "[next]" -access the next menuBar -.IP "\fB[show]\fR" 4 -.IX Item "[show]" -Enable display of the menuBar -.IP "\fB[hide]\fR" 4 -.IX Item "[hide]" -Disable display of the menuBar -.IP "\fB[pixmap:+\f(BIname\fB]\fR" 4 -.IX Item "[pixmap:+name]" -.PD 0 -.IP "\fB[pixmap:+\f(BIname\fB;\f(BIscaling\fB]\fR" 4 -.IX Item "[pixmap:+name;scaling]" -.PD -(set the background pixmap globally -.Sp -\&\fBA Future implementation \f(BImay\fB make this local to the menubar\fR) -.IP "\fB[:+\f(BIcommand\fB:]\fR" 4 -.IX Item "[:+command:]" -ignore the menu readonly status and issue a \fIcommand\fR to or a menu or -menuitem or change the ; a useful shortcut for setting the quick arrows -from a menuBar. -.PP - -.IX Xref "menuBarAdd" -.Sh "Adding and accessing menus" -.IX Subsection "Adding and accessing menus" -The following commands may also be \fB+\fR prefixed. -.IP "\fB/+\fR" 4 -.IX Item "/+" -access menuBar top level -.IP "\fB./+\fR" 4 -.IX Item "./+" -access current menu level -.IP "\fB../+\fR" 4 -.IX Item "../+" -access parent menu (1 level up) -.IP "\fB../../\fR" 4 -.IX Item "../../" -access parent menu (multiple levels up) -.IP "\fB\f(BI/path/\fBmenu\fR" 4 -.IX Item "/path/menu" -add/access menu -.IP "\fB\f(BI/path/\fBmenu/*\fR" 4 -.IX Item "/path/menu/*" -add/access menu and clear it if it exists -.IP "\fB\f(BI/path/\fB{\-}\fR" 4 -.IX Item "/path/{-}" -add separator -.IP "\fB\f(BI/path/\fB{item}\fR" 4 -.IX Item "/path/{item}" -add \fBitem\fR as a label -.IP "\fB\f(BI/path/\fB{item} action\fR" 4 -.IX Item "/path/{item} action" -add/alter \fImenuitem\fR with an associated \fIaction\fR -.IP "\fB\f(BI/path/\fB{item}{right\-text}\fR" 4 -.IX Item "/path/{item}{right-text}" -add/alter \fImenuitem\fR with \fBright-text\fR as the right-justified text -and as the associated \fIaction\fR -.IP "\fB\f(BI/path/\fB{item}{rtext} action\fR" 4 -.IX Item "/path/{item}{rtext} action" -add/alter \fImenuitem\fR with an associated \fIaction\fR and with \fBrtext\fR as -the right-justified text. -.IP "Special characters in \fIaction\fR must be backslash\-escaped:" 4 -.IX Item "Special characters in action must be backslash-escaped:" -\&\fB\ea \eb \eE \ee \en \er \et \eoctal\fR -.IP "or in control-character notation:" 4 -.IX Item "or in control-character notation:" -\&\fB^@, ^A .. ^Z .. ^_, ^?\fR -.PP -To send a string starting with a \fB\s-1NUL\s0\fR (\fB^@\fR) character to the -program, start \fIaction\fR with a pair of \fB\s-1NUL\s0\fR characters (\fB^@^@\fR), -the first of which will be stripped off and the balance directed to the -program. Otherwise if \fIaction\fR begins with \fB\s-1NUL\s0\fR followed by -non\-+\fB\s-1NUL\s0\fR characters, the leading \fB\s-1NUL\s0\fR is stripped off and the -balance is sent back to rxvt. -.PP -As a convenience for the many Emacs-type editors, \fIaction\fR may start -with \fBM\-\fR (eg, \fBM\-$\fR is equivalent to \fB\eE$\fR) and a \fB\s-1CR\s0\fR will be -appended if missed from \fBM\-x\fR commands. -.PP -As a convenience for issuing XTerm \fB\s-1ESC\s0 ]\fR sequences from a menubar (or -quick arrow), a \fB\s-1BEL\s0\fR (\fB^G\fR) will be appended if needed. -.IP "For example," 4 -.IX Item "For example," -\&\fBM\-xapropos\fR is equivalent to \fB\eExapropos\er\fR -.IP "and" 4 -.IX Item "and" -\&\fB\eE]703;mona;100\fR is equivalent to \fB\eE]703;mona;100\ea\fR -.PP -The option \fB{\f(BIright-rtext\fB}\fR will be right\-justified. In the -absence of a specified action, this text will be used as the \fIaction\fR -as well. -.IP "For example," 4 -.IX Item "For example," -\&\fB/File/{Open}{^X^F}\fR is equivalent to \fB/File/{Open}{^X^F} ^X^F\fR -.PP -The left label \fIis\fR necessary, since it's used for matching, but -implicitly hiding the left label (by using same name for both left and -right labels), or explicitly hiding the left label (by preceeding it -with a dot), makes it possible to have right-justified text only. -.IP "For example," 4 -.IX Item "For example," -\&\fB/File/{Open}{Open} Open-File-Action\fR -.IP "or hiding it" 4 -.IX Item "or hiding it" -\&\fB/File/{.anylabel}{Open} Open-File-Action\fR -.PP - -.IX Xref "menuBarRemove" -.Sh "Removing menus" -.IX Subsection "Removing menus" -.IP "\fB\-/*+\fR" 4 -.IX Item "-/*+" -remove all menus from the menuBar, the same as \fB[clear]\fR -.IP "\fB\-+\f(BI/path\fBmenu+\fR" 4 -.IX Item "-+/pathmenu+" -remove menu -.IP "\fB\-+\f(BI/path\fB{item}+\fR" 4 -.IX Item "-+/path{item}+" -remove item -.IP "\fB\-+\f(BI/path\fB{\-}\fR" 4 -.IX Item "-+/path{-}" -remove separator) -.IP "\fB\-/path/menu/*\fR" 4 -.IX Item "-/path/menu/*" -remove all items, separators and submenus from menu -.PP - -.IX Xref "menuBarArrows" -.Sh "Quick Arrows" -.IX Subsection "Quick Arrows" -The menus also provide a hook for \fIquick arrows\fR to provide easier -user access. If nothing has been explicitly set, the default is to -emulate the curror keys. The syntax permits each arrow to be altered -individually or all four at once without re-entering their common -beginning/end text. For example, to explicitly associate cursor actions -with the arrows, any of the following forms could be used: -.IP "\fB+\f(BIRight\fB\fR" 4 -.IX Item "+Right" -.PD 0 -.IP "\fB+\f(BILeft\fB\fR" 4 -.IX Item "+Left" -.IP "\fB+\f(BIUp\fB\fR" 4 -.IX Item "+Up" -.IP "\fB+\f(BIDown\fB\fR" 4 -.IX Item "+Down" -.PD -Define actions for the respective arrow buttons -.IP "\fB+\f(BIBegin\fB\fR" 4 -.IX Item "+Begin" -.PD 0 -.IP "\fB+\f(BIEnd\fB\fR" 4 -.IX Item "+End" -.PD -Define common beginning/end parts for \fIquick arrows\fR which used in -conjunction with the above constructs -.IP "For example, define arrows individually," 4 -.IX Item "For example, define arrows individually," -.Vb 1 -\& \eE[A -.Ve -.Sp -.Vb 1 -\& \eE[B -.Ve -.Sp -.Vb 1 -\& \eE[C -.Ve -.Sp -.Vb 1 -\& \eE[D -.Ve -.IP "or all at once" 4 -.IX Item "or all at once" -.Vb 1 -\& \eE[AZ<>\eE[BZ<>\eE[CZ<>\eE[D -.Ve -.IP "or more compactly (factoring out common parts)" 4 -.IX Item "or more compactly (factoring out common parts)" -.Vb 1 -\& \eE[AZ<>BZ<>CZ<>D -.Ve -.PP - -.IX Xref "menuBarSummary" -.Sh "Command Summary" -.IX Subsection "Command Summary" -A short summary of the most \fIcommon\fR commands: -.IP "[menu:name]" 4 -.IX Item "[menu:name]" -use an existing named menuBar or start a new one -.IP "[menu]" 4 -.IX Item "[menu]" -use the current menuBar -.IP "[title:string]" 4 -.IX Item "[title:string]" -set menuBar title -.IP "[done]" 4 -.IX Item "[done]" -set menu access to readonly and, if reading from a file, signal \s-1EOF\s0 -.IP "[done:name]" 4 -.IX Item "[done:name]" -if reading from a file using [read:file;name] signal \s-1EOF\s0 -.IP "[rm:name]" 4 -.IX Item "[rm:name]" -remove named menuBar(s) -.IP "[rm] [rm:]" 4 -.IX Item "[rm] [rm:]" -remove current menuBar -.IP "[rm*] [rm:*]" 4 -.IX Item "[rm*] [rm:*]" -remove all menuBar(s) -.IP "[swap]" 4 -.IX Item "[swap]" -swap top two menuBars -.IP "[prev]" 4 -.IX Item "[prev]" -access the previous menuBar -.IP "[next]" 4 -.IX Item "[next]" -access the next menuBar -.IP "[show]" 4 -.IX Item "[show]" -map menuBar -.IP "[hide]" 4 -.IX Item "[hide]" -unmap menuBar -.IP "[pixmap;file]" 4 -.IX Item "[pixmap;file]" -.PD 0 -.IP "[pixmap;file;scaling]" 4 -.IX Item "[pixmap;file;scaling]" -.PD -set a background pixmap -.IP "[read:file]" 4 -.IX Item "[read:file]" -.PD 0 -.IP "[read:file;name]" 4 -.IX Item "[read:file;name]" -.PD -read in a menu from a file -.IP "[dump]" 4 -.IX Item "[dump]" -dump out all menuBars to /tmp/rxvt\-PID -.IP "/" 4 -access menuBar top level -.IP "./" 4 -.PD 0 -.IP "../" 4 -.IP "../../" 4 -.PD -access current or parent menu level -.IP "/path/menu" 4 -.IX Item "/path/menu" -add/access menu -.IP "/path/{\-}" 4 -.IX Item "/path/{-}" -add separator -.IP "/path/{item}{rtext} action" 4 -.IX Item "/path/{item}{rtext} action" -add/alter menu item -.IP "\-/*" 4 -remove all menus from the menuBar -.IP "\-/path/menu" 4 -.IX Item "-/path/menu" -remove menu items, separators and submenus from menu -.IP "\-/path/menu" 4 -.IX Item "-/path/menu" -remove menu -.IP "\-/path/{item}" 4 -.IX Item "-/path/{item}" -remove item -.IP "\-/path/{\-}" 4 -.IX Item "-/path/{-}" -remove separator -.IP "BeginRightLeftUpDownEnd" 4 -.IX Item "BeginRightLeftUpDownEnd" -menu quick arrows +.IX Xref "XPM" .SH "XPM" .IX Header "XPM" For the \s-1XPM\s0 XTerm escape sequence \fB\f(CB\*(C`ESC ] 20 ; Pt ST\*(C'\fB\fR then value @@ -2410,6 +2149,8 @@ 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 @@ -2428,10 +2169,9 @@ 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. @@ -2441,7 +2181,8 @@ 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 @@ -2478,11 +2219,6 @@ .IP "\-\-enable\-tinting (default: on)" 4 .IX Item "--enable-tinting (default: on)" Add support for tinting of transparent backgrounds (requires \f(CW\*(C`\-\-enable\-transparency\*(C'\fR). -.IP "\-\-enable\-menubar (default: off) [\s-1DEPRECATED\s0]" 4 -.IX Item "--enable-menubar (default: off) [DEPRECATED]" -Add support for our menu bar system (this interacts badly with dynamic -locale switching currently). This option is \s-1DEPRECATED\s0 and will be removed -in the future. .IP "\-\-enable\-rxvt\-scroll (default: on)" 4 .IX Item "--enable-rxvt-scroll (default: on)" Add support for the original rxvt scrollbar. @@ -2497,10 +2233,6 @@ Add support for a very unobtrusive, plain-looking scrollbar that is the favourite of the rxvt-unicode author, having used it for many years. -.IP "\-\-enable\-half\-shadow (default: off)" 4 -.IX Item "--enable-half-shadow (default: off)" -Make shadows on the scrollbar only half the normal width & height. -only applicable to rxvt scrollbars. .IP "\-\-enable\-ttygid (default: off)" 4 .IX Item "--enable-ttygid (default: off)" Change tty device setting to group \*(L"tty\*(R" \- only use this if @@ -2515,13 +2247,6 @@ .IP "\-\-disable\-resources" 4 .IX Item "--disable-resources" Removes any support for resource checking. -.IP "\-\-enable\-strings (default: off)" 4 -.IX Item "--enable-strings (default: off)" -Add support for our possibly faster \fImemset()\fR function and other -various routines, overriding your system's versions which may -have been hand-crafted in assembly or may require extra libraries -to link in. (this breaks ANSI-C rules and has problems on many -GNU/Linux systems). .IP "\-\-disable\-swapscreen" 4 .IX Item "--disable-swapscreen" Remove support for secondary/swap screen. @@ -2534,15 +2259,14 @@ A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly in combination with other switches) is: .Sp -.Vb 17 +.Vb 15 \& MWM-hints \& EWMH-hints (pid, utf8 names) and protocols (ping) \& seperate underline colour (-underlineColor) \& settable border widths and borderless switch (-w, -b, -bl) +\& visual depth selection (-depth) \& settable extra linespacing /-lsp) \& iso-14755-2 and -3, and visual feedback -\& backindex and forwardindex escape sequence -\& window op and some xterm/OSC escape sequences \& tripleclickwords (-tcw) \& settable insecure mode (-insecure) \& keysym remapping support @@ -2551,7 +2275,22 @@ \& user-pty (-pty-fd) \& hold on exit (-hold) \& skip builtin block graphics (-sbg) +.Ve +.Sp +It also enabled some non-essential features otherwise disabled, such as: +.Sp +.Vb 11 +\& some round-trip time optimisations +\& nearest color allocation on pseudocolor screens +\& UTF8_STRING supporr for selection \& sgr modes 90..97 and 100..107 +\& backindex and forwardindex escape sequences +\& view change/zero scorllback esacpe sequences +\& locale switching escape sequence +\& window op and some xterm/OSC escape sequences +\& rectangular selections +\& trailing space removal for selections +\& verbose X error handling .Ve .IP "\-\-enable\-iso14755 (default: on)" 4 .IX Item "--enable-iso14755 (default: on)" @@ -2595,8 +2334,8 @@ .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