--- rxvt-unicode/doc/rxvt.7.txt 2006/01/13 12:40:46 1.43 +++ rxvt-unicode/doc/rxvt.7.txt 2006/01/16 14:48:39 1.44 @@ -46,7 +46,7 @@ If you only want to disable specific features, you first have to identify which perl extension is responsible. For this, read the - section PREPACKAGED EXTENSIONS in the urxvtperl(3) manpage. For + section PREPACKAGED EXTENSIONS in the rxvtperl(3) manpage. For example, to disable the selection-popup and option-popup, specify this perl-ext-common resource: @@ -146,7 +146,7 @@ How do I know which rxvt-unicode version I'm using? The version number is displayed with the usage (-h). Also the escape sequence "ESC [ 8 n" sets the window title to the version number. - When using the urxvtc client, the version displayed is that of the + When using the rxvtc client, the version displayed is that of the daemon. I am using Debian GNU/Linux and have a problem... @@ -240,7 +240,7 @@ Most likely it's the empty definition for "enacs=". Just replace it by "enacs=\E[0@" and try again. - "bash"'s readline does not work correctly under urxvt. + "bash"'s readline does not work correctly under rxvt. I need a termcap file entry. One reason you might want this is that some distributions or operating systems still compile some programs using the @@ -361,7 +361,7 @@ In that case, select a font of your taste and add it to the font list, e.g.: - urxvt -fn basefont,font2,font3... + rxvt -fn basefont,font2,font3... When rxvt-unicode sees a character, it will first look at the base font. If the base font does not contain the character, it will go to @@ -721,9 +721,9 @@ URxvt.color7: #e1dddd URxvt.color15: #e1dddd - How can I start urxvtd in a race-free way? - Try "urxvtd -f -o", which tells urxvtd to open the display, create - the listening socket and then fork. + How can I start rxvtd in a race-free way? + Try "rxvtd -f -o", which tells rxvtd to open the display, create the + listening socket and then fork. What's with the strange Backspace/Delete key behaviour? Assuming that the physical Backspace key corresponds to the @@ -746,11 +746,11 @@ # use Backspace = ^H $ stty erase ^H - $ urxvt + $ rxvt # use Backspace = ^? $ stty erase ^? - $ urxvt + $ rxvt Toggle with "ESC [ 36 h" / "ESC [ 36 l". @@ -788,7 +788,7 @@ option you can use the `keysym' resource to alter the keystrings associated with keysyms. - Here's an example for a URxvt session started using "urxvt -name + Here's an example for a URxvt session started using "rxvt -name URxvt" URxvt.keysym.Home: \033[1~ @@ -1254,10 +1254,6 @@ h Send Mouse X & Y on button press. l No mouse reporting. - "Ps = 10" (rxvt) - h menuBar visible - l menuBar invisible - "Ps = 25" h Visible cursor {cnorm/cvvis} l Invisible cursor {civis} @@ -1360,7 +1356,6 @@ 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 = 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 @@ -1375,334 +1370,6 @@ -menuBar - The exact syntax used is *almost* solidified. In the menus, DON'T try to - use menuBar commands that add or remove a menuBar. - - Note that in all of the commands, the */path/* *cannot* be omitted: use - ./ to specify a menu relative to the current menu. - - Overview of menuBar operation - For the menuBar XTerm escape sequence "ESC ] 703 ; Pt ST", the syntax of - "Pt" can be used for a variety of tasks: - - At the top level is the current menuBar which is a member of a circular - linked-list of other such menuBars. - - The menuBar acts as a parent for the various drop-down menus, which in - turn, may have labels, separator lines, menuItems and subMenus. - - 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. - - The menuBar syntax is intended to provide a simple yet robust method of - constructing and manipulating menus and navigating through the menuBars. - - The first step is to use the tag [menu:*name*] which creates the menuBar - called *name* and allows access. You may now or menus, subMenus, and - menuItems. Finally, use the tag [done] to set the menuBar access as - readonly to prevent accidental corruption of the menus. To re-access the - current menuBar for alterations, use the tag [menu], make the - alterations and then use [done] - - - - Commands - [menu:+*name*] - access the named menuBar for creation or alteration. If a new - menuBar is created, it is called *name* (max of 15 chars) and the - current menuBar is pushed onto the stack - - [menu] - access the current menuBar for alteration - - [title:+*string*] - set the current menuBar's title to *string*, which may contain the - following format specifiers: - - B<%n> rxvt name (as per the B<-name> command-line option) - B<%v> rxvt version - B<%%> literal B<%> character - - [done] - set menuBar access as readonly. End-of-file tag for [read:+*file*] - operations. - - [read:+*file*] - read menu commands directly from *file* (extension ".menu" will be - appended if required.) Start reading at a line with [menu] or - [menu:+*name* and continuing until [done] is encountered. - - Blank and comment lines (starting with #) 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!. - - [read:+*file*;+*name*] - The same as [read:+*file*], but start reading at a line with - [menu:+*name*] and continuing until [done:+*name*] or [done] is - encountered. - - [dump] - dump all menuBars to the file /tmp/rxvt-PID in a format suitable for - later rereading. - - [rm:name] - remove the named menuBar - - [rm] [rm:] - remove the current menuBar - - [rm*] [rm:*] - remove all menuBars - - [swap] - swap the top two menuBars - - [prev] - access the previous menuBar - - [next] - access the next menuBar - - [show] - Enable display of the menuBar - - [hide] - Disable display of the menuBar - - [pixmap:+*name*] - [pixmap:+*name*;*scaling*] - (set the background pixmap globally - - A Future implementation *may* make this local to the menubar) - - [:+*command*:] - ignore the menu readonly status and issue a *command* to or a menu - or menuitem or change the ; a useful shortcut for setting the quick - arrows from a menuBar. - - - - Adding and accessing menus - The following commands may also be + prefixed. - - /+ access menuBar top level - - ./+ access current menu level - - ../+ - access parent menu (1 level up) - - ../../ - access parent menu (multiple levels up) - - */path/*menu - add/access menu - - */path/*menu/* - add/access menu and clear it if it exists - - */path/*{-} - add separator - - */path/*{item} - add item as a label - - */path/*{item} action - add/alter *menuitem* with an associated *action* - - */path/*{item}{right-text} - add/alter *menuitem* with right-text as the right-justified text and - as the associated *action* - - */path/*{item}{rtext} action - add/alter *menuitem* with an associated *action* and with rtext as - the right-justified text. - - Special characters in *action* must be backslash-escaped: - \a \b \E \e \n \r \t \octal - - or in control-character notation: - ^@, ^A .. ^Z .. ^_, ^? - - To send a string starting with a NUL (^@) character to the program, - start *action* with a pair of NUL characters (^@^@), the first of which - will be stripped off and the balance directed to the program. Otherwise - if *action* begins with NUL followed by non-+NUL characters, the leading - NUL is stripped off and the balance is sent back to rxvt. - - As a convenience for the many Emacs-type editors, *action* may start - with M- (eg, M-$ is equivalent to \E$) and a CR will be appended if - missed from M-x commands. - - As a convenience for issuing XTerm ESC ] sequences from a menubar (or - quick arrow), a BEL (^G) will be appended if needed. - - For example, - M-xapropos is equivalent to \Exapropos\r - - and \E]703;mona;100 is equivalent to \E]703;mona;100\a - - The option {*right-rtext*} will be right-justified. In the absence of a - specified action, this text will be used as the *action* as well. - - For example, - /File/{Open}{^X^F} is equivalent to /File/{Open}{^X^F} ^X^F - - The left label *is* 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. - - For example, - /File/{Open}{Open} Open-File-Action - - or hiding it - /File/{.anylabel}{Open} Open-File-Action - - - - Removing menus - -/*+ - remove all menus from the menuBar, the same as [clear] - - -+*/path*menu+ - remove menu - - -+*/path*{item}+ - remove item - - -+*/path*{-} - remove separator) - - -/path/menu/* - remove all items, separators and submenus from menu - - - - Quick Arrows - The menus also provide a hook for *quick arrows* 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: - - +*Right* - +*Left* - +*Up* - +*Down* - Define actions for the respective arrow buttons - - +*Begin* - +*End* - Define common beginning/end parts for *quick arrows* which used in - conjunction with the above constructs - - For example, define arrows individually, - \E[A - - \E[B - - \E[C - - \E[D - - or all at once - \E[AZ<>\E[BZ<>\E[CZ<>\E[D - - or more compactly (factoring out common parts) - \E[AZ<>BZ<>CZ<>D - - - - Command Summary - A short summary of the most *common* commands: - - [menu:name] - use an existing named menuBar or start a new one - - [menu] - use the current menuBar - - [title:string] - set menuBar title - - [done] - set menu access to readonly and, if reading from a file, signal EOF - - [done:name] - if reading from a file using [read:file;name] signal EOF - - [rm:name] - remove named menuBar(s) - - [rm] [rm:] - remove current menuBar - - [rm*] [rm:*] - remove all menuBar(s) - - [swap] - swap top two menuBars - - [prev] - access the previous menuBar - - [next] - access the next menuBar - - [show] - map menuBar - - [hide] - unmap menuBar - - [pixmap;file] - [pixmap;file;scaling] - set a background pixmap - - [read:file] - [read:file;name] - read in a menu from a file - - [dump] - dump out all menuBars to /tmp/rxvt-PID - - / access menuBar top level - - ./ - ../ - ../../ - access current or parent menu level - - /path/menu - add/access menu - - /path/{-} - add separator - - /path/{item}{rtext} action - add/alter menu item - - -/* remove all menus from the menuBar - - -/path/menu - remove menu items, separators and submenus from menu - - -/path/menu - remove menu - - -/path/{item} - remove item - - -/path/{-} - remove separator - - BeginRightLeftUpDownEnd - menu quick arrows - XPM For the XPM XTerm escape sequence "ESC ] 20 ; Pt ST" then value of "Pt" can be the name of the background pixmap followed by a sequence of @@ -1967,11 +1634,6 @@ Add support for tinting of transparent backgrounds (requires "--enable-transparency"). - --enable-menubar (default: off) [DEPRECATED] - Add support for our menu bar system (this interacts badly with - dynamic locale switching currently). This option is DEPRECATED and - will be removed in the future. - --enable-rxvt-scroll (default: on) Add support for the original rxvt scrollbar. @@ -2005,13 +1667,6 @@ --disable-resources Removes any support for resource checking. - --enable-strings (default: off) - Add support for our possibly faster memset() 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). - --disable-swapscreen Remove support for secondary/swap screen. @@ -2042,7 +1697,7 @@ sgr modes 90..97 and 100..107 --enable-iso14755 (default: on) - Enable extended ISO 14755 support (see urxvt(1), or doc/rxvt.1.txt). + Enable extended ISO 14755 support (see rxvt(1), or doc/rxvt.1.txt). Basic support (section 5.1) is enabled by "--enable-frills", while support for 5.2, 5.3 and 5.4 is enabled with this switch. @@ -2083,7 +1738,7 @@ Add support to have the pointer disappear when typing or inactive. --enable-perl (default: off) - Enable an embedded perl interpreter. See the urxvtperl(3) manpage + 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 perl interpreter that is used can be specified via the "PERL"