--- rxvt-unicode/doc/rxvt.1.man.in 2006/02/21 01:00:40 1.59 +++ rxvt-unicode/doc/rxvt.1.man.in 2006/07/06 18:56:09 1.60 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.14 +.\" Automatically generated by Pod::Man 2.09 (Pod::Simple 3.04) .\" .\" Standard preamble: .\" ======================================================================== @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "rxvt 1" -.TH rxvt 1 "2006-02-21" "7.6" "RXVT-UNICODE" +.TH rxvt 1 "2006-07-06" "7.7" "RXVT-UNICODE" .SH "NAME" rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system) .SH "SYNOPSIS" @@ -254,7 +254,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" @@ -299,8 +299,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 @@ -429,7 +429,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" @@ -516,9 +516,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 @@ -541,18 +541,14 @@ .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 @@ -570,11 +566,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 @@ -725,8 +721,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 @@ -824,7 +820,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 @@ -1050,15 +1046,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 @@ -1067,7 +1063,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 @@ -1076,7 +1072,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 @@ -1093,7 +1089,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 @@ -1105,16 +1101,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" @@ -1243,8 +1239,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. @@ -1255,8 +1251,9 @@ 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 "* 5.1: Basic method" 4 -.IX Item "5.1: Basic method" +.IP "\(bu" 4 +5.1: Basic method +.Sp 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 @@ -1271,8 +1268,9 @@ 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 "* 5.2: Keyboard symbols entry method" 4 -.IX Item "5.2: Keyboard symbols entry method" +.IP "\(bu" 4 +5.2: Keyboard symbols entry method +.Sp This mode lets you input characters representing the keycap symbols of your keyboard, if representable in the current locale encoding. .Sp @@ -1283,12 +1281,14 @@ 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 "* 5.3: Screen-selection entry method" 4 -.IX Item "5.3: Screen-selection entry method" +.IP "\(bu" 4 +5.3: Screen-selection entry method +.Sp While this is implemented already (it's basically the selection mechanism), it could be extended by displaying a unicode character map. -.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" +.IP "\(bu" 4 +5.4: Feedback method for identifying displayed characters for later input +.Sp This method lets you display the unicode character code associated with characters already displayed. .Sp @@ -1337,7 +1337,6 @@ 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 @@ -1379,7 +1378,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/2222 \-fg "[e]pink" .Ve .PP \&\fIPlease note that transparency of any kind if completely unsupported by @@ -1426,7 +1425,7 @@ The unix domain socket path used by @@RXVT_NAME@@c(1) and @@RXVT_NAME@@d(1). .Sp -Default \fI$HOME/.rxvt\-unicode\-\fI .Sp - + .SH "AUTHORS" .IX Header "AUTHORS" .IP "John Bovey" 4