--- rxvt-unicode/doc/rxvt.1.man.in 2006/08/07 16:17:30 1.63 +++ rxvt-unicode/doc/rxvt.1.man.in 2006/12/07 21:31:01 1.65 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pod::Man 2.09 (Pod::Simple 3.04) +.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 .\" .\" Standard preamble: .\" ======================================================================== @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "@@RXVT_NAME@@ 1" -.TH @@RXVT_NAME@@ 1 "2006-08-07" "7.9" "RXVT-UNICODE" +.TH @@RXVT_NAME@@ 1 "2006-12-07" "8.1" "RXVT-UNICODE" .SH "NAME" rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system) .SH "SYNOPSIS" @@ -147,7 +147,7 @@ See @@RXVT_NAME@@(7) (try \f(CW\*(C`man 7 @@RXVT_NAME@@\*(C'\fR) for a list of frequently asked questions and answer to them and some common problems. That document is also accessible on the World-Wide-Web at -. +. .SH "RXVT-UNICODE VS. RXVT" .IX Header "RXVT-UNICODE VS. RXVT" Unlike the original rxvt, \fBrxvt-unicode\fR stores all text in Unicode @@ -255,7 +255,7 @@ \&\fItintColor\fR. Example: .Sp .Vb 1 -\& @@RXVT_NAME@@ \-tr \-tint blue \-sh 40 +\& @@RXVT_NAME@@ -tr -tint blue -sh 40 .Ve .IP "\fB\-sh\fR" 4 .IX Item "-sh" @@ -300,8 +300,8 @@ e.g.: .Sp .Vb 2 -\& @@RXVT_NAME@@ \-fn "xft:Bitstream Vera Sans Mono:pixelsize=15" -\& @@RXVT_NAME@@ \-fn "9x15bold,xft:Bitstream Vera Sans Mono" +\& @@RXVT_NAME@@ -fn "xft:Bitstream Vera Sans Mono:pixelsize=15" +\& @@RXVT_NAME@@ -fn "9x15bold,xft:Bitstream Vera Sans Mono" .Ve .Sp See also the question \*(L"How does rxvt-unicode choose fonts?\*(R" in the \s-1FAQ\s0 @@ -430,7 +430,7 @@ run shell commands, you have to specify the shell, like this: .Sp .Vb 1 -\& @@RXVT_NAME@@ \-e sh \-c "shell commands" +\& @@RXVT_NAME@@ -e sh -c "shell commands" .Ve .IP "\fB\-title\fR \fItext\fR" 4 .IX Item "-title text" @@ -517,9 +517,9 @@ .Sp .Vb 5 \& my $rxvt = new Gtk2::Socket; -\& $rxvt\->signal_connect_after (realize => sub { -\& my $xid = $_[0]\->window\->get_xid; -\& system "@@RXVT_NAME@@ \-embed $xid &"; +\& $rxvt->signal_connect_after (realize => sub { +\& my $xid = $_[0]->window->get_xid; +\& system "@@RXVT_NAME@@ -embed $xid &"; \& }); .Ve .IP "\fB\-pty\-fd\fR \fIfile descriptor\fR" 4 @@ -542,14 +542,18 @@ .Vb 2 \& use IO::Pty; \& use Fcntl; -\& +.Ve +.Sp +.Vb 4 \& my $pty = new IO::Pty; -\& fcntl $pty, F_SETFD, 0; # clear close\-on\-exec -\& system "@@RXVT_NAME@@ \-pty\-fd " . (fileno $pty) . "&"; +\& fcntl $pty, F_SETFD, 0; # clear close-on-exec +\& system "@@RXVT_NAME@@ -pty-fd " . (fileno $pty) . "&"; \& close $pty; -\& +.Ve +.Sp +.Vb 3 \& # now communicate with rxvt -\& my $slave = $pty\->slave; +\& my $slave = $pty->slave; \& while (<$slave>) { print $slave "got <$_>\en" } .Ve .IP "\fB\-pe\fR \fIstring\fR" 4 @@ -567,11 +571,11 @@ with later settings overwriting earlier ones: .PP .Vb 5 -\& 1. system\-wide app\-defaults file, either locale\-dependent OR global -\& 2. app\-defaults file in $XAPPLRESDIR -\& 3. RESOURCE_MANAGER property on root\-window OR $HOME/.Xdefaults +\& 1. system-wide app-defaults file, either locale-dependent OR global +\& 2. app-defaults file in $XAPPLRESDIR +\& 3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults \& 4. SCREEN_RESOURCES for the current screen -\& 5. $XENVIRONMENT file OR $HOME/.Xdefaults\- +\& 5. $XENVIRONMENT file OR $HOME/.Xdefaults- .Ve .PP Note that when reading X resources, \fB@@RXVT_NAME@@\fR recognizes two class @@ -722,8 +726,8 @@ .Sp .Vb 5 \& URxvt.font: 9x15bold,\e -\& \-misc\-fixed\-bold\-r\-normal\-\-15\-140\-75\-75\-c\-90\-iso10646\-1,\e -\& \-misc\-fixed\-medium\-r\-normal\-\-15\-140\-75\-75\-c\-90\-iso10646\-1, \e +\& -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\e +\& -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \e \& [codeset=JISX0208]xft:Kochi Gothic:antialias=false, \e \& xft:Code2000:antialias=false .Ve @@ -821,7 +825,7 @@ Example: .Sp .Vb 1 -\& URxvt.print\-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX) +\& URxvt.print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX) .Ve .Sp This creates a new file in your home directory with the screen contents @@ -1033,7 +1037,8 @@ \&\f(CW\*(C`\ee\*(C'\fR, \f(CW\*(C`\eE\*(C'\fR: escape, \f(CW\*(C`\en\*(C'\fR: newline, \f(CW\*(C`\er\*(C'\fR: carriage return, \f(CW\*(C`\et\*(C'\fR: tab, \&\f(CW\*(C`\e000\*(C'\fR: octal number) or verbatim control characters (\f(CW\*(C`^?\*(C'\fR: delete, \&\f(CW\*(C`^@\*(C'\fR: null, \f(CW\*(C`^A\*(C'\fR ...) and may be enclosed with double quotes so that it -can start or end with whitespace. +can start or end with whitespace. \fBThis feature is deprecated and will +be removed\fR. .Sp Please note that you need to double the \f(CW\*(C`\e\*(C'\fR in resource files, as Xlib itself does its own de-escaping (you can use \f(CW\*(C`\e033\*(C'\fR instead of @@ -1047,15 +1052,15 @@ Its usage can be demonstrated by an example: .Sp .Vb 1 -\& URxvt.keysym.M\-C\-0x61: list|\e033 +\& URxvt.keysym.M-C-0x61: list|\e033 .Ve .Sp The above line is equivalent to the following three lines: .Sp .Vb 3 -\& URxvt.keysym.Meta\-Control\-0x61: \e033 -\& URxvt.keysym.Meta\-Control\-0x62: \e033 -\& URxvt.keysym.Meta\-Control\-0x63: \e033 +\& URxvt.keysym.Meta-Control-0x61: \e033 +\& URxvt.keysym.Meta-Control-0x62: \e033 +\& URxvt.keysym.Meta-Control-0x63: \e033 .Ve .Sp If \fIstring\fR takes the form of \f(CW\*(C`command:STRING\*(C'\fR, the specified \fB\s-1STRING\s0\fR @@ -1064,7 +1069,7 @@ when Control-Meta-c is being pressed": .Sp .Vb 1 -\& URxvt.keysym.M\-C\-c: command:\e033]701;zh_CN.GBK\e007 +\& URxvt.keysym.M-C-c: command:\e033]701;zh_CN.GBK\e007 .Ve .Sp If \fIstring\fR takes the form \f(CW\*(C`perl:STRING\*(C'\fR, then the specified \fB\s-1STRING\s0\fR @@ -1073,7 +1078,7 @@ \&\f(CW\*(C`@@RXVT_NAME@@ \-pe selection\*(C'\fR) listens for \f(CW\*(C`selection:rot13\*(C'\fR events: .Sp .Vb 1 -\& URxvt.keysym.M\-C\-c: perl:selection:rot13 +\& URxvt.keysym.M-C-c: perl:selection:rot13 .Ve .Sp Due the the large number of modifier combinations, a defined key mapping @@ -1090,7 +1095,7 @@ .Sp .Vb 2 \& URxvt.keysym.Insert: -\& URxvt.keysym.S\-Insert: builtin: +\& URxvt.keysym.S-Insert: builtin: .Ve .Sp The first line defines a mapping for \f(CW\*(C`Insert\*(C'\fR and \fIany\fR combination @@ -1102,16 +1107,16 @@ font-switching at runtime: .Sp .Vb 2 -\& URxvt.keysym.M\-C\-1: command:\e033]50;suxuseuro\e007 -\& URxvt.keysym.M\-C\-2: command:\e033]50;9x15bold\e007 +\& URxvt.keysym.M-C-1: command:\e033]50;suxuseuro\e007 +\& URxvt.keysym.M-C-2: command:\e033]50;9x15bold\e007 .Ve .Sp Other things are possible, e.g. resizing (see @@RXVT_NAME@@(7) for more info): .Sp .Vb 2 -\& URxvt.keysym.M\-C\-3: command:\e033[8;25;80t -\& URxvt.keysym.M\-C\-4: command:\e033[8;48;110t +\& URxvt.keysym.M-C-3: command:\e033[8;25;80t +\& URxvt.keysym.M-C-4: command:\e033[8;48;110t .Ve .IP "\fBperl-ext-common\fR: \fIstring\fR" 4 .IX Item "perl-ext-common: string" @@ -1170,7 +1175,7 @@ .IP "\fBurlLauncher\fR: \fIstring\fR" 4 .IX Item "urlLauncher: string" 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. +\&\f(CW\*(C`selection\-popup\*(C'\fR and \f(CW\*(C`matcher\*(C'\fR perl extensions. .IP "\fBtransient-for\fR: \fIwindowid\fR" 4 .IX Item "transient-for: windowid" Compile \fIfrills\fR: Sets the \s-1WM_TRANSIENT_FOR\s0 property to the given window id. @@ -1240,8 +1245,8 @@ You can use keyboard shortcuts, too: .PP .Vb 2 -\& URxvt.keysym.M\-C\-1: command:\e033]710;suxuseuro\e007\e033]711;suxuseuro\e007 -\& URxvt.keysym.M\-C\-2: command:\e033]710;9x15bold\e007\e033]711;9x15bold\e007 +\& URxvt.keysym.M-C-1: command:\e033]710;suxuseuro\e007\e033]711;suxuseuro\e007 +\& URxvt.keysym.M-C-2: command:\e033]710;9x15bold\e007\e033]711;9x15bold\e007 .Ve .PP rxvt-unicode will automatically re-apply these fonts to the output so far. @@ -1252,9 +1257,8 @@ first part is available rxvt-unicode has been compiled with \&\f(CW\*(C`\-\-enable\-frills\*(C'\fR, the rest is available when rxvt-unicode was compiled with \f(CW\*(C`\-\-enable\-iso14755\*(C'\fR. -.IP "\(bu" 4 -5.1: Basic method -.Sp +.IP "* 5.1: Basic method" 4 +.IX Item "5.1: Basic method" This allows you to enter unicode characters using their hexcode. .Sp Start by pressing and holding both \f(CW\*(C`Control\*(C'\fR and \f(CW\*(C`Shift\*(C'\fR, then enter @@ -1269,9 +1273,8 @@ address printed as hexcodes, e.g. \f(CW\*(C`671d 65e5\*(C'\fR. You can enter this easily by pressing \f(CW\*(C`Control\*(C'\fR and \f(CW\*(C`Shift\*(C'\fR, followed by \f(CW\*(C`6\-7\-1\-D\-SPACE\-6\-5\-E\-5\*(C'\fR, followed by releasing the modifier keys. -.IP "\(bu" 4 -5.2: Keyboard symbols entry method -.Sp +.IP "* 5.2: Keyboard symbols entry method" 4 +.IX Item "5.2: Keyboard symbols entry method" This mode lets you input characters representing the keycap symbols of your keyboard, if representable in the current locale encoding. .Sp @@ -1282,14 +1285,12 @@ released, otherwise pressing e.g. \f(CW\*(C`Shift\*(C'\fR would enter the symbol for \&\f(CW\*(C`ISO Level 2 Switch\*(C'\fR, although your intention might have been to enter a reverse tab (Shift\-Tab). -.IP "\(bu" 4 -5.3: Screen-selection entry method -.Sp +.IP "* 5.3: Screen-selection entry method" 4 +.IX Item "5.3: Screen-selection entry method" While this is implemented already (it's basically the selection mechanism), it could be extended by displaying a unicode character map. -.IP "\(bu" 4 -5.4: Feedback method for identifying displayed characters for later input -.Sp +.IP "* 5.4: Feedback method for identifying displayed characters for later input" 4 +.IX Item "5.4: Feedback method for identifying displayed characters for later input" This method lets you display the unicode character code associated with characters already displayed. .Sp @@ -1338,6 +1339,7 @@ foreground = Black background = White .TE + .PP It is also possible to specify the colour values of \fBforeground\fR, \&\fBbackground\fR, \fBcursorColor\fR, \fBcursorColor2\fR, \fBcolorBD\fR, \fBcolorUL\fR as @@ -1368,8 +1370,10 @@ (recommended, but \fB\s-1MUST\s0\fR have 4 digits/component) colour specifications, in addition to the ones provided by X, where the additional A component specifies opacity (alpha) values. The minimum value of \f(CW0\fR is completely -transparent). You can also prefix any color with \f(CW\*(C`[a]\*(C'\fR, where \f(CW\*(C`a\*(C'\fR is on -to four hex digits specifiying the opacity value. +transparent). You can also prefix any color with \f(CW\*(C`[percent]\*(C'\fR, where +\&\f(CW\*(C`percent\*(C'\fR is a decimal percentage (0\-100) that specifies the opacity of +the color, where \f(CW0\fR is completely transparent and \f(CW100\fR is completelxy +opaque. .PP You probably need to specify \fB\*(L"\-depth 32\*(R"\fR, too, and have the luck that your X\-server uses \s-1ARGB\s0 pixel layout, as X is far from just supporting @@ -1379,7 +1383,7 @@ background, and an almost opaque pink foreground: .PP .Vb 1 -\& @@RXVT_NAME@@ \-depth 32 \-bg rgba:0000/0000/0000/2222 \-fg "[e]pink" +\& @@RXVT_NAME@@ -depth 32 -bg rgba:0000/0000/0000/aaaa -fg "[80]pink" .Ve .PP \&\fIPlease note that transparency of any kind if completely unsupported by @@ -1426,7 +1430,7 @@ The unix domain socket path used by @@RXVT_NAME@@c(1) and @@RXVT_NAME@@d(1). .Sp -Default \fI\f(CI$HOME\fI/.rxvt\-unicode\-\fI