~kklimonda/ubuntu/lucid/rxvt-unicode/lp-514821

« back to all changes in this revision

Viewing changes to doc/rxvt.7.man.in

  • Committer: Bazaar Package Importer
  • Author(s): Decklin Foster
  • Date: 2006-09-01 14:44:58 UTC
  • mfrom: (1.1.8 upstream) (3.1.1 etch)
  • Revision ID: james.westby@ubuntu.com-20060901144458-98hrz8zg01w8a3vy
Tags: 7.9-2
* Edit the comments in the app-defaults file, and disable all settings by
  default. If font autoselection fails, I would prefer to open a new bug
  specifically for that. (Closes: #385481)
* Reorganize and edit README.Debian, pushing as much as possible into FAQ
  format (with resource setting issues first).

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.14
 
1
.\" Automatically generated by Pod::Man 2.09 (Pod::Simple 3.04)
2
2
.\"
3
3
.\" Standard preamble:
4
4
.\" ========================================================================
128
128
.rm #[ #] #H #V #F C
129
129
.\" ========================================================================
130
130
.\"
131
 
.IX Title "rxvt 7"
132
 
.TH rxvt 7 "2006-02-21" "7.7" "RXVT-UNICODE"
 
131
.IX Title "@@RXVT_NAME@@ 7"
 
132
.TH @@RXVT_NAME@@ 7 "2006-08-07" "7.9" "RXVT-UNICODE"
133
133
.SH "NAME"
134
134
RXVT REFERENCE \- FAQ, command sequences and other background information
135
135
.SH "SYNOPSIS"
137
137
.Vb 2
138
138
\&   # set a new font set
139
139
\&   printf '\e33]50;%s\e007' 9x15,xft:Kochi" Mincho"
140
 
.Ve
141
 
.PP
142
 
.Vb 2
143
 
\&   # change the locale and tell rxvt-unicode about it
144
 
\&   export LC_CTYPE=ja_JP.EUC-JP; printf "\e33]701;$LC_CTYPE\e007"
145
 
.Ve
146
 
.PP
147
 
.Vb 2
 
140
\&
 
141
\&   # change the locale and tell rxvt\-unicode about it
 
142
\&   export LC_CTYPE=ja_JP.EUC\-JP; printf "\e33]701;$LC_CTYPE\e007"
 
143
\&
148
144
\&   # set window title
149
145
\&   printf '\e33]2;%s\e007' "new window title"
150
146
.Ve
174
170
give you tabs:
175
171
.PP
176
172
.Vb 1
177
 
\&   @@URXVT_NAME@@ -pe tabbed
178
 
.Ve
179
 
.PP
180
 
.Vb 1
181
 
\&   URxvt.perl-ext-common: default,tabbed
 
173
\&   @@URXVT_NAME@@ \-pe tabbed
 
174
\&
 
175
\&   URxvt.perl\-ext\-common: default,tabbed
182
176
.Ve
183
177
.PP
184
178
It will also work fine with tabbing functionality of many window managers
226
220
.Vb 6
227
221
\&   #!/bin/sh
228
222
\&   @@URXVT_NAME@@c "$@"
229
 
\&   if [ $? -eq 2 ]; then
230
 
\&      @@URXVT_NAME@@d -q -o -f
 
223
\&   if [ $? \-eq 2 ]; then
 
224
\&      @@URXVT_NAME@@d \-q \-o \-f
231
225
\&      @@URXVT_NAME@@c "$@"
232
226
\&   fi
233
227
.Ve
237
231
re-run the command. Subsequent invocations of the script will re-use the
238
232
existing daemon.
239
233
.PP
240
 
\fIHow do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc.\fR
241
 
.IX Subsection "How do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc."
 
234
\fIHow do I distinguish whether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc.\fR
 
235
.IX Subsection "How do I distinguish whether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc."
242
236
.PP
243
237
The original rxvt and rxvt-unicode always export the variable \*(L"\s-1COLORTERM\s0\*(R",
244
238
so you can check and see if that is set. Note that several programs, \s-1JED\s0,
260
254
.PP
261
255
.Vb 12
262
256
\&   # Bourne/Korn/POSIX family of shells:
263
 
\&   [ ${TERM:-foo} = foo ] && TERM=xterm # assume an xterm if we don't know
264
 
\&   if [ ${TERM:-foo} = xterm ]; then
265
 
\&      stty -icanon -echo min 0 time 15 # see if enhanced rxvt or not
266
 
\&      echo -n '^[Z'
 
257
\&   [ ${TERM:\-foo} = foo ] && TERM=xterm # assume an xterm if we don't know
 
258
\&   if [ ${TERM:\-foo} = xterm ]; then
 
259
\&      stty \-icanon \-echo min 0 time 15 # see if enhanced rxvt or not
 
260
\&      echo \-n '^[Z'
267
261
\&      read term_id
268
262
\&      stty icanon echo
269
 
\&      if [ ""${term_id} = '^[[?1;2C' -a ${DISPLAY:-foo} = foo ]; then
270
 
\&         echo -n '^[[7n'        # query the rxvt we are in for the DISPLAY string
 
263
\&      if [ ""${term_id} = '^[[?1;2C' \-a ${DISPLAY:\-foo} = foo ]; then
 
264
\&         echo \-n '^[[7n'        # query the rxvt we are in for the DISPLAY string
271
265
\&         read DISPLAY           # set it in our local shell
272
266
\&      fi
273
267
\&   fi
293
287
.PP
294
288
.Vb 3
295
289
\&    text    data     bss     drs     rss filename
296
 
\&   98398    1664      24   15695    1824 rxvt --disable-everything
297
 
\&  188985    9048   66616   18222    1788 urxvt --disable-everything
 
290
\&   98398    1664      24   15695    1824 rxvt \-\-disable\-everything
 
291
\&  188985    9048   66616   18222    1788 urxvt \-\-disable\-everything
298
292
.Ve
299
293
.PP
300
294
When you \f(CW\*(C`\-\-enable\-everything\*(C'\fR (which \fIis\fR unfair, as this involves xft
301
295
and full locale/XIM support which are quite bloaty inside libX11 and my
302
 
libc), the two diverge, but not unreasnobaly so.
 
296
libc), the two diverge, but not unreasonably so.
303
297
.PP
304
298
.Vb 3
305
299
\&    text    data     bss     drs     rss filename
306
 
\&  163431    2152      24   20123    2060 rxvt --enable-everything
307
 
\& 1035683   49680   66648   29096    3680 urxvt --enable-everything
 
300
\&  163431    2152      24   20123    2060 rxvt \-\-enable\-everything
 
301
\& 1035683   49680   66648   29096    3680 urxvt \-\-enable\-everything
308
302
.Ve
309
303
.PP
310
304
The very large size of the text section is explained by the east-asian
350
344
\&   libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000)
351
345
\&   libc.so.6 => /lib/libc.so.6 (0x00002aaaaadde000)
352
346
\&   libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab01d000)
353
 
\&   /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)
 
347
\&   /lib64/ld\-linux\-x86\-64.so.2 (0x00002aaaaaaab000)
354
348
.Ve
355
349
.PP
356
350
And here is rxvt\-unicode:
360
354
\&   libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x00002aaaaada2000)
361
355
\&   libc.so.6 => /lib/libc.so.6 (0x00002aaaaaeb0000)     
362
356
\&   libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab0ee000)   
363
 
\&   /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)
 
357
\&   /lib64/ld\-linux\-x86\-64.so.2 (0x00002aaaaaaab000)
364
358
.Ve
365
359
.PP
366
360
No large bloated libraries (of course, none were linked in statically),
382
376
.PP
383
377
.Vb 2
384
378
\&   Esetroot wallpaper.jpg
385
 
\&   @@URXVT_NAME@@ -ip -tint red -sh 40
 
379
\&   @@URXVT_NAME@@ \-ip \-tint red \-sh 40
386
380
.Ve
387
381
.PP
388
382
That works. If you think it doesn't, you lack transparency and tinting
393
387
your picture with gimp or any other tool:
394
388
.PP
395
389
.Vb 2
396
 
\&   convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm
397
 
\&   @@URXVT_NAME@@ -pixmap background.xpm -pe automove-background
 
390
\&   convert wallpaper.jpg \-blur 20x20 \-modulate 30 background.xpm
 
391
\&   @@URXVT_NAME@@ \-pixmap background.xpm \-pe automove\-background
398
392
.Ve
399
393
.PP
400
394
That works. If you think it doesn't, you lack \s-1XPM\s0 and Perl support, or you
403
397
3. Use an \s-1ARGB\s0 visual:
404
398
.PP
405
399
.Vb 1
406
 
\&   @@URXVT_NAME@@ -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc
 
400
\&   @@URXVT_NAME@@ \-depth 32 \-fg grey90 \-bg rgba:0000/0000/4444/cccc
407
401
.Ve
408
402
.PP
409
403
This requires \s-1XFT\s0 support, and the support of your X\-server. If that
410
404
doesn't work for you, blame Xorg and Keith Packard. \s-1ARGB\s0 visuals aren't
411
 
there yet, no matter what they claim. Rxvt-Unicode contains the neccessary
 
405
there yet, no matter what they claim. Rxvt-Unicode contains the necessary
412
406
bugfixes and workarounds for Xft and Xlib to make it work, but that
413
407
doesn't mean that your \s-1WM\s0 has the required kludges in place.
414
408
.PP
415
409
4. Use xcompmgr and let it do the job:
416
410
.PP
417
411
.Vb 2
418
 
\&  xprop -frame -f _NET_WM_WINDOW_OPACITY 32c \e
419
 
\&        -set _NET_WM_WINDOW_OPACITY 0xc0000000
 
412
\&  xprop \-frame \-f _NET_WM_WINDOW_OPACITY 32c \e
 
413
\&        \-set _NET_WM_WINDOW_OPACITY 0xc0000000
420
414
.Ve
421
415
.PP
422
416
Then click on a window you want to make transparent. Replace \f(CW0xc0000000\fR
438
432
ask for the character bounding box, which unfortunately is wrong in these
439
433
cases).
440
434
.PP
441
 
It's not clear (to me at least), wether this is a bug in Xft, freetype,
 
435
It's not clear (to me at least), whether this is a bug in Xft, freetype,
442
436
or the respective font. If you encounter this problem you might try using
443
437
the \f(CW\*(C`\-lsp\*(C'\fR option to give the font more height. If that doesn't work, you
444
438
might be forced to use a different font.
478
472
effect as using the \f(CW\*(C`\-fn\*(C'\fR switch, and takes effect immediately:
479
473
.PP
480
474
.Vb 1
481
 
\&   printf '\ee]50;%s\e007' "9x15bold,xft:Kochi Gothic"
 
475
\&   printf '\e33]50;%s\e007' "9x15bold,xft:Kochi Gothic"
482
476
.Ve
483
477
.PP
484
478
This is useful if you e.g. work primarily with japanese (and prefer a
492
486
.PP
493
487
Many fonts have difficulties with italic characters and hinting. For
494
488
example, the otherwise very nicely hinted font \f(CW\*(C`xft:Bitstream Vera Sans
495
 
Mono\*(C'\fR completely fails in it's italic face. A workaround might be to
 
489
Mono\*(C'\fR completely fails in its italic face. A workaround might be to
496
490
enable freetype autohinting, i.e. like this:
497
491
.PP
498
492
.Vb 2
512
506
.IX Subsection "Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?"
513
507
.PP
514
508
Rxvt-unicode will use whatever you specify as a font. If it needs to
515
 
fall back to it's default font search list it will prefer X11 core
 
509
fall back to its default font search list it will prefer X11 core
516
510
fonts, because they are small and fast, and then use Xft fonts. It has
517
511
antialiasing disabled for most of them, because the author thinks they
518
512
look best that way.
555
549
\&   URxvt.color5:   #A800A8
556
550
\&   URxvt.color6:   #00A8A8
557
551
\&   URxvt.color7:   #A8A8A8
558
 
.Ve
559
 
.PP
560
 
.Vb 8
 
552
\&
561
553
\&   URxvt.color8:   #000054
562
554
\&   URxvt.color9:   #FF0054
563
555
\&   URxvt.color10:  #00FF54
570
562
.PP
571
563
And here is a more complete set of non-standard colors.
572
564
.PP
573
 
.Vb 18
 
565
.Vb 10
574
566
\&   URxvt.cursorColor:  #dc74d1
575
567
\&   URxvt.pointerColor: #dc74d1
576
568
\&   URxvt.background:   #0e0e0e
617
609
e.g.:
618
610
.PP
619
611
.Vb 1
620
 
\&   @@URXVT_NAME@@ -fn basefont,font2,font3...
 
612
\&   @@URXVT_NAME@@ \-fn basefont,font2,font3...
621
613
.Ve
622
614
.PP
623
615
When rxvt-unicode sees a character, it will first look at the base
652
644
fonts for the same character at the same time, but no interface for this
653
645
has been designed yet).
654
646
.PP
655
 
Until then, you might get away with switching fonts at runtime (see \*(L"Can I switch the fonts at runtime?\*(R" later in this document).
 
647
Until then, you might get away with switching fonts at runtime (see \*(L"Can
 
648
I switch the fonts at runtime?\*(R" later in this document).
656
649
.Sh "Keyboard, Mouse & User Interaction"
657
650
.IX Subsection "Keyboard, Mouse & User Interaction"
658
651
\fIThe new selection selects pieces that are too big, how can I select single words?\fR
662
655
setting:
663
656
.PP
664
657
.Vb 1
665
 
\&   URxvt.selection.pattern-0: ([[:word:]]+)
 
658
\&   URxvt.selection.pattern\-0: ([[:word:]]+)
666
659
.Ve
667
660
.PP
668
661
If you click more than twice, the selection will be extended
671
664
To get a selection that is very similar to the old code, try this pattern:
672
665
.PP
673
666
.Vb 1
674
 
\&   URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\e\e\e\e]^`{|})]+)
 
667
\&   URxvt.selection.pattern\-0: ([^"&'()*,;<=>?@[\e\e\e\e]^`{|})]+)
675
668
.Ve
676
669
.PP
677
670
Please also note that the \fILeftClick Shift-LeftClik\fR combination also
691
684
this \fBperl-ext-common\fR resource:
692
685
.PP
693
686
.Vb 1
694
 
\&   URxvt.perl-ext-common: default,-selection-popup,-option-popup
 
687
\&   URxvt.perl\-ext\-common: default,\-selection\-popup,\-option\-popup
695
688
.Ve
696
689
.PP
697
690
This will keep the default extensions, but disable the two popup
700
693
other combination either by setting the \fBsearchable-scrollback\fR resource:
701
694
.PP
702
695
.Vb 1
703
 
\&   URxvt.searchable-scrollback: CM-s
 
696
\&   URxvt.searchable\-scrollback: CM\-s
704
697
.Ve
705
698
.PP
706
699
\fIThe cursor moves when selecting text in the current input line, how do I switch this off?\fR
717
710
but when running a program that doesn't parse cursor movements or in some
718
711
cases during rlogin sessions, it fails to detect this properly.
719
712
.PP
720
 
You can permamently switch this feature off by disabling the \f(CW\*(C`readline\*(C'\fR
 
713
You can permanently switch this feature off by disabling the \f(CW\*(C`readline\*(C'\fR
721
714
extension:
722
715
.PP
723
716
.Vb 1
724
 
\&   URxvt.perl-ext-common: default,-readline
 
717
\&   URxvt.perl\-ext\-common: default,\-readline
725
718
.Ve
726
719
.PP
727
720
\fIMy numerical keypad acts weird and generates differing output?\fR
729
722
.PP
730
723
Some Debian GNUL/Linux users seem to have this problem, although no
731
724
specific details were reported so far. It is possible that this is caused
732
 
by the wrong \f(CW\*(C`TERM\*(C'\fR setting, although the details of wether and how
 
725
by the wrong \f(CW\*(C`TERM\*(C'\fR setting, although the details of whether and how
733
726
this can happen are unknown, as \f(CW\*(C`TERM=rxvt\*(C'\fR should offer a compatible
734
727
keymap. See the answer to the previous question, and please report if that
735
728
helped.
769
762
.IX Subsection "What's with the strange Backspace/Delete key behaviour?"
770
763
.PP
771
764
Assuming that the physical Backspace key corresponds to the
772
 
BackSpace keysym (not likely for Linux ... see the following
 
765
Backspace keysym (not likely for Linux ... see the following
773
766
question) there are two standard values that can be used for
774
767
Backspace: \f(CW\*(C`^H\*(C'\fR and \f(CW\*(C`^?\*(C'\fR.
775
768
.PP
789
782
\&   # use Backspace = ^H
790
783
\&   $ stty erase ^H
791
784
\&   $ @@URXVT_NAME@@
792
 
.Ve
793
 
.PP
794
 
.Vb 3
 
785
\&
795
786
\&   # use Backspace = ^?
796
787
\&   $ stty erase ^?
797
788
\&   $ @@URXVT_NAME@@
804
795
.Vb 3
805
796
\&   # use Backspace = ^H
806
797
\&   $ stty erase ^H
807
 
\&   $ echo -n "^[[36h"
808
 
.Ve
809
 
.PP
810
 
.Vb 3
 
798
\&   $ echo \-n "^[[36h"
 
799
\&
811
800
\&   # use Backspace = ^?
812
801
\&   $ stty erase ^?
813
 
\&   $ echo -n "^[[36l"
 
802
\&   $ echo \-n "^[[36l"
814
803
.Ve
815
804
.PP
816
805
This helps satisfy some of the Backspace discrepancies that occur, but
839
828
.PP
840
829
Here's an example for a URxvt session started using \f(CW\*(C`@@URXVT_NAME@@ \-name URxvt\*(C'\fR
841
830
.PP
842
 
.Vb 20
 
831
.Vb 10
843
832
\&   URxvt.keysym.Home:          \e033[1~
844
833
\&   URxvt.keysym.End:           \e033[4~
845
 
\&   URxvt.keysym.C-apostrophe:  \e033<C-'>
846
 
\&   URxvt.keysym.C-slash:       \e033<C-/>
847
 
\&   URxvt.keysym.C-semicolon:   \e033<C-;>
848
 
\&   URxvt.keysym.C-grave:       \e033<C-`>
849
 
\&   URxvt.keysym.C-comma:       \e033<C-,>
850
 
\&   URxvt.keysym.C-period:      \e033<C-.>
851
 
\&   URxvt.keysym.C-0x60:        \e033<C-`>
852
 
\&   URxvt.keysym.C-Tab:         \e033<C-Tab>
853
 
\&   URxvt.keysym.C-Return:      \e033<C-Return>
854
 
\&   URxvt.keysym.S-Return:      \e033<S-Return>
855
 
\&   URxvt.keysym.S-space:       \e033<S-Space>
856
 
\&   URxvt.keysym.M-Up:          \e033<M-Up>
857
 
\&   URxvt.keysym.M-Down:        \e033<M-Down>
858
 
\&   URxvt.keysym.M-Left:        \e033<M-Left>
859
 
\&   URxvt.keysym.M-Right:       \e033<M-Right>
860
 
\&   URxvt.keysym.M-C-0:         list \e033<M-C- 0123456789 >
861
 
\&   URxvt.keysym.M-C-a:         list \e033<M-C- abcdefghijklmnopqrstuvwxyz >
 
834
\&   URxvt.keysym.C\-apostrophe:  \e033<C\-'>
 
835
\&   URxvt.keysym.C\-slash:       \e033<C\-/>
 
836
\&   URxvt.keysym.C\-semicolon:   \e033<C\-;>
 
837
\&   URxvt.keysym.C\-grave:       \e033<C\-`>
 
838
\&   URxvt.keysym.C\-comma:       \e033<C\-,>
 
839
\&   URxvt.keysym.C\-period:      \e033<C\-.>
 
840
\&   URxvt.keysym.C\-0x60:        \e033<C\-`>
 
841
\&   URxvt.keysym.C\-Tab:         \e033<C\-Tab>
 
842
\&   URxvt.keysym.C\-Return:      \e033<C\-Return>
 
843
\&   URxvt.keysym.S\-Return:      \e033<S\-Return>
 
844
\&   URxvt.keysym.S\-space:       \e033<S\-Space>
 
845
\&   URxvt.keysym.M\-Up:          \e033<M\-Up>
 
846
\&   URxvt.keysym.M\-Down:        \e033<M\-Down>
 
847
\&   URxvt.keysym.M\-Left:        \e033<M\-Left>
 
848
\&   URxvt.keysym.M\-Right:       \e033<M\-Right>
 
849
\&   URxvt.keysym.M\-C\-0:         list \e033<M\-C\- 0123456789 >
 
850
\&   URxvt.keysym.M\-C\-a:         list \e033<M\-C\- abcdefghijklmnopqrstuvwxyz >
862
851
\&   URxvt.keysym.F12:           command:\e033]701;zh_CN.GBK\e007
863
852
.Ve
864
853
.PP
894
883
.PP
895
884
.Vb 2
896
885
\&   URxvt.cutchars: "()*,<>[]{}|'
897
 
\&   URxvt.print-pipe: cat >/tmp/xxx
 
886
\&   URxvt.print\-pipe: cat >/tmp/xxx
898
887
.Ve
899
888
.PP
900
889
These are just for testing stuff.
901
890
.PP
902
891
.Vb 2
903
 
\&   URxvt.imLocale: ja_JP.UTF-8
 
892
\&   URxvt.imLocale: ja_JP.UTF\-8
904
893
\&   URxvt.preeditType: OnTheSpot,None
905
894
.Ve
906
895
.PP
910
899
with correct-looking fonts.
911
900
.PP
912
901
.Vb 6
913
 
\&   URxvt.perl-lib: /root/lib/urxvt
914
 
\&   URxvt.perl-ext-common: default,selection-autotransform,selection-pastebin,xim-onthespot,remote-clipboard
915
 
\&   URxvt.selection.pattern-0: ( at .*? line \e\ed+)
916
 
\&   URxvt.selection.pattern-1: ^(/[^:]+):\e 
917
 
\&   URxvt.selection-autotransform.0: s/^([^:[:space:]]+):(\e\ed+):?$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/
918
 
\&   URxvt.selection-autotransform.1: s/^ at (.*?) line (\e\ed+)$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/
 
902
\&   URxvt.perl\-lib: /root/lib/urxvt
 
903
\&   URxvt.perl\-ext\-common: default,selection\-autotransform,selection\-pastebin,xim\-onthespot,remote\-clipboard
 
904
\&   URxvt.selection.pattern\-0: ( at .*? line \e\ed+)
 
905
\&   URxvt.selection.pattern\-1: ^(/[^:]+):\e 
 
906
\&   URxvt.selection\-autotransform.0: s/^([^:[:space:]]+):(\e\ed+):?$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/
 
907
\&   URxvt.selection\-autotransform.1: s/^ at (.*?) line (\e\ed+)$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/
919
908
.Ve
920
909
.PP
921
910
This is my perl configuration. The first two set the perl library
924
913
write.
925
914
.PP
926
915
The selection stuff mainly makes the selection perl-error-message aware
927
 
and tells it to convert pelr error mssages into vi-commands to load the
 
916
and tells it to convert perl error messages into vi-commands to load the
928
917
relevant file and go tot he error line number.
929
918
.PP
930
919
.Vb 2
933
922
.Ve
934
923
.PP
935
924
As the documentation says: plain is the preferred scrollbar for the
936
 
author. The \f(CW\*(C`secondaryScroll\*(C'\fR confgiures urxvt to scroll in full-screen
937
 
apps, like screen, so lines scorlled out of screen end up in urxvt's
 
925
author. The \f(CW\*(C`secondaryScroll\*(C'\fR configures urxvt to scroll in full-screen
 
926
apps, like screen, so lines scrolled out of screen end up in urxvt's
938
927
scrollback buffer.
939
928
.PP
940
929
.Vb 7
1002
991
.PP
1003
992
.Vb 9
1004
993
\&   urxvt.font:             9x15bold,\e
1005
 
\&                           -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\e
1006
 
\&                           -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \e
 
994
\&                           \-misc\-fixed\-bold\-r\-normal\-\-15\-140\-75\-75\-c\-90\-iso10646\-1,\e
 
995
\&                           \-misc\-fixed\-medium\-r\-normal\-\-15\-140\-75\-75\-c\-90\-iso10646\-1, \e
1007
996
\&                           [codeset=JISX0208]xft:Kochi Gothic, \e
1008
997
\&                           xft:Bitstream Vera Sans Mono:autohint=true, \e
1009
998
\&                           xft:Code2000:antialias=false
1010
 
\&   urxvt.boldFont:         -xos4-terminus-bold-r-normal--14-140-72-72-c-80-iso8859-15
 
999
\&   urxvt.boldFont:         \-xos4\-terminus\-bold\-r\-normal\-\-14\-140\-72\-72\-c\-80\-iso8859\-15
1011
1000
\&   urxvt.italicFont:       xft:Bitstream Vera Sans Mono:italic:autohint=true
1012
1001
\&   urxvt.boldItalicFont:   xft:Bitstream Vera Sans Mono:bold:italic:autohint=true
1013
1002
.Ve
1014
1003
.PP
1015
1004
I wrote rxvt-unicode to be able to specify fonts exactly. So don't be
1016
 
overwhelmed. A special note: the \f(CW\*(C`9x15bold\*(C'\fR mentioend above is actually
 
1005
overwhelmed. A special note: the \f(CW\*(C`9x15bold\*(C'\fR mentioned above is actually
1017
1006
the version from XFree\-3.3, as XFree\-4 replaced it by a totally different
1018
1007
font (different glyphs for \f(CW\*(C`;\*(C'\fR and many other harmless characters),
1019
1008
while the second font is actually the \f(CW\*(C`9x15bold\*(C'\fR from XFree4/XOrg. The
1020
1009
bold version has less chars than the medium version, so I use it for rare
1021
 
characters, too. Whene ditign sources with vim, I use italic for comments
 
1010
characters, too. When editing sources with vim, I use italic for comments
1022
1011
and other stuff, which looks quite good with Bitstream Vera anti\-aliased.
1023
1012
.PP
1024
1013
Terminus is a quite bad font (many very wrong glyphs), but for most of my
1039
1028
\&   IRC*font:               suxuseuro
1040
1029
\&   IRC*boldFont:           suxuseuro
1041
1030
\&   IRC*colorBD:            white
1042
 
\&   IRC*keysym.M-C-1:       command:\e033]710;suxuseuro\e007\e033]711;suxuseuro\e007
1043
 
\&   IRC*keysym.M-C-2:       command:\e033]710;9x15bold\e007\e033]711;9x15bold\e007
 
1031
\&   IRC*keysym.M\-C\-1:       command:\e033]710;suxuseuro\e007\e033]711;suxuseuro\e007
 
1032
\&   IRC*keysym.M\-C\-2:       command:\e033]710;9x15bold\e007\e033]711;9x15bold\e007
1044
1033
.Ve
1045
1034
.PP
1046
1035
\&\f(CW\*(C`Alt\-Shift\-1\*(C'\fR and \f(CW\*(C`Alt\-Shift\-2\*(C'\fR switch between two different font
1053
1042
file for different hosts, for example, on ym main desktop, I use:
1054
1043
.PP
1055
1044
.Vb 5
1056
 
\&   URxvt.keysym.C-M-q: command:\e033[3;5;5t
1057
 
\&   URxvt.keysym.C-M-y: command:\e033[3;5;606t
1058
 
\&   URxvt.keysym.C-M-e: command:\e033[3;1605;5t
1059
 
\&   URxvt.keysym.C-M-c: command:\e033[3;1605;606t
1060
 
\&   URxvt.keysym.C-M-p: perl:test
 
1045
\&   URxvt.keysym.C\-M\-q: command:\e033[3;5;5t
 
1046
\&   URxvt.keysym.C\-M\-y: command:\e033[3;5;606t
 
1047
\&   URxvt.keysym.C\-M\-e: command:\e033[3;1605;5t
 
1048
\&   URxvt.keysym.C\-M\-c: command:\e033[3;1605;606t
 
1049
\&   URxvt.keysym.C\-M\-p: perl:test
1061
1050
.Ve
1062
1051
.PP
1063
1052
The first for keysym definitions allow me to quickly bring some windows
1073
1062
applications. Most importantly, this means that if you or your \s-1OS\s0 loads
1074
1063
resources into the X display (the right way to do it), rxvt-unicode will
1075
1064
ignore any resource files in your home directory. It will only read
1076
 
\&\fI$HOME/.Xdefaults\fR when no resources are attached to the display.
 
1065
\&\fI\f(CI$HOME\fI/.Xdefaults\fR when no resources are attached to the display.
1077
1066
.PP
1078
 
If you have or use an \fI$HOME/.Xresources\fR file, chances are that
 
1067
If you have or use an \fI\f(CI$HOME\fI/.Xresources\fR file, chances are that
1079
1068
resources are loaded into your X\-server. In this case, you have to
1080
1069
re-login after every change (or run \fIxrdb \-merge \f(CI$HOME\fI/.Xresources\fR).
1081
1070
.PP
1086
1075
.Ve
1087
1076
.PP
1088
1077
If you want to use another form (there are lots of different ways of
1089
 
specifying resources), make sure you understand wether and why it
 
1078
specifying resources), make sure you understand whether and why it
1090
1079
works. If unsure, use the form above.
1091
1080
.PP
1092
1081
\fIWhen I log-in to another system it tells me about missing terminfo data?\fR
1100
1089
.PP
1101
1090
.Vb 2
1102
1091
\&   REMOTE=remotesystem.domain
1103
 
\&   infocmp rxvt-unicode | ssh $REMOTE "cat >/tmp/ti && tic /tmp/ti"
 
1092
\&   infocmp rxvt\-unicode | ssh $REMOTE "cat >/tmp/ti && tic /tmp/ti"
1104
1093
.Ve
1105
1094
.PP
1106
1095
\&... or by installing rxvt-unicode normally on the remote system,
1141
1130
library (Fedora Core's bash is one example) and rely on a termcap entry
1142
1131
for \f(CW\*(C`rxvt\-unicode\*(C'\fR.
1143
1132
.PP
1144
 
You could use rxvt's termcap entry with resonable results in many cases.
 
1133
You could use rxvt's termcap entry with reasonable results in many cases.
1145
1134
You can also create a termcap entry by using terminfo's infocmp program
1146
1135
like this:
1147
1136
.PP
1148
1137
.Vb 1
1149
 
\&   infocmp -C rxvt-unicode
 
1138
\&   infocmp \-C rxvt\-unicode
1150
1139
.Ve
1151
1140
.PP
1152
1141
Or you could use this termcap entry, generated by the command above:
1153
1142
.PP
1154
 
.Vb 20
1155
 
\&   rxvt-unicode|rxvt-unicode terminal (X Window System):\e
 
1143
.Vb 10
 
1144
\&   rxvt\-unicode|rxvt\-unicode terminal (X Window System):\e
1156
1145
\&           :am:bw:eo:km:mi:ms:xn:xo:\e
1157
1146
\&           :co#80:it#8:li#24:lm#0:\e
1158
1147
\&           :AL=\eE[%dL:DC=\eE[%dP:DL=\eE[%dM:DO=\eE[%dB:IC=\eE[%d@:\e
1178
1167
.IX Subsection "Why does ls no longer have coloured output?"
1179
1168
.PP
1180
1169
The \f(CW\*(C`ls\*(C'\fR in the \s-1GNU\s0 coreutils unfortunately doesn't use terminfo to
1181
 
decide wether a terminal has colour, but uses it's own configuration
1182
 
file. Needless to say, \f(CW\*(C`rxvt\-unicode\*(C'\fR is not in it's default file (among
 
1170
decide whether a terminal has colour, but uses its own configuration
 
1171
file. Needless to say, \f(CW\*(C`rxvt\-unicode\*(C'\fR is not in its default file (among
1183
1172
with most other terminals supporting colour). Either add:
1184
1173
.PP
1185
1174
.Vb 1
1186
 
\&   TERM rxvt-unicode
 
1175
\&   TERM rxvt\-unicode
1187
1176
.Ve
1188
1177
.PP
1189
1178
to \f(CW\*(C`/etc/DIR_COLORS\*(C'\fR or simply add:
1190
1179
.PP
1191
1180
.Vb 1
1192
 
\&   alias ls='ls --color=auto'
 
1181
\&   alias ls='ls \-\-color=auto'
1193
1182
.Ve
1194
1183
.PP
1195
1184
to your \f(CW\*(C`.profile\*(C'\fR or \f(CW\*(C`.bashrc\*(C'\fR.
1238
1227
into other problems. If nothing works you can try this in your .profile.
1239
1228
.PP
1240
1229
.Vb 1
1241
 
\&  printf '\ee]701;%s\e007' "$LC_CTYPE"
 
1230
\&  printf '\e33]701;%s\e007' "$LC_CTYPE"
1242
1231
.Ve
1243
1232
.PP
1244
1233
If this doesn't work, then maybe you use a \f(CW\*(C`LC_CTYPE\*(C'\fR specification not
1274
1263
applications so everybody agrees on character properties such as width
1275
1264
and code number. This mechanism is the \fIlocale\fR. Applications not using
1276
1265
that info will have problems (for example, \f(CW\*(C`xterm\*(C'\fR gets the width of
1277
 
characters wrong as it uses it's own, locale-independent table under all
 
1266
characters wrong as it uses its own, locale-independent table under all
1278
1267
locales).
1279
1268
.PP
1280
1269
Rxvt-unicode uses the \f(CW\*(C`LC_CTYPE\*(C'\fR locale category to select encoding. All
1305
1294
rxvt\-unicode's idea of \f(CW\*(C`LC_CTYPE\*(C'\fR.
1306
1295
.PP
1307
1296
.Vb 1
1308
 
\&  printf '\ee]701;%s\e007' ja_JP.SJIS
 
1297
\&  printf '\e33]701;%s\e007' ja_JP.SJIS
1309
1298
.Ve
1310
1299
.PP
1311
1300
See also the previous answer.
1316
1305
first switches to a locale supported by xjdic and back later:
1317
1306
.PP
1318
1307
.Vb 3
1319
 
\&   printf '\ee]701;%s\e007' ja_JP.SJIS
1320
 
\&   xjdic -js
1321
 
\&   printf '\ee]701;%s\e007' de_DE.UTF-8
 
1308
\&   printf '\e33]701;%s\e007' ja_JP.SJIS
 
1309
\&   xjdic \-js
 
1310
\&   printf '\e33]701;%s\e007' de_DE.UTF\-8
1322
1311
.Ve
1323
1312
.PP
1324
1313
You can also use xterm's \f(CW\*(C`luit\*(C'\fR program, which usually works fine, except
1346
1335
.IX Item "- Make sure the XMODIFIERS environment variable is set correctly when starting rxvt-unicode."
1347
1336
.PD
1348
1337
When you want to use e.g. \fBkinput2\fR, it must be set to
1349
 
\&\f(CW\*(C`@im=kinput2\*(C'\fR. For \fBscim\fR, use \f(CW\*(C`@im=SCIM\*(C'\fR. Youc an see what input
 
1338
\&\f(CW\*(C`@im=kinput2\*(C'\fR. For \fBscim\fR, use \f(CW\*(C`@im=SCIM\*(C'\fR. You can see what input
1350
1339
method servers are running with this command:
1351
1340
.Sp
1352
1341
.Vb 1
1353
 
\&   xprop -root XIM_SERVERS
 
1342
\&   xprop \-root XIM_SERVERS
1354
1343
.Ve
1355
 
.IP "*" 4
 
1344
.IP "" 4
1356
1345
.PP
1357
1346
\fIMy input method wants <some encoding> but I want \s-1UTF\-8\s0, what can I do?\fR
1358
1347
.IX Subsection "My input method wants <some encoding> but I want UTF-8, what can I do?"
1361
1350
terminal, using the resource \f(CW\*(C`imlocale\*(C'\fR:
1362
1351
.PP
1363
1352
.Vb 1
1364
 
\&   URxvt.imlocale: ja_JP.EUC-JP
 
1353
\&   URxvt.imlocale: ja_JP.EUC\-JP
1365
1354
.Ve
1366
1355
.PP
1367
1356
Now you can start your terminal with \f(CW\*(C`LC_CTYPE=ja_JP.UTF\-8\*(C'\fR and still
1404
1393
.PP
1405
1394
You should build one binary with the default options. \fIconfigure\fR
1406
1395
now enables most useful options, and the trend goes to making them
1407
 
runtime\-switchable, too, so there is usually no drawback to enbaling them,
 
1396
runtime\-switchable, too, so there is usually no drawback to enabling them,
1408
1397
except higher disk and possibly memory usage. The perl interpreter should
1409
1398
be enabled, as important functionality (menus, selection, likely more in
1410
1399
the future) depends on it.
1454
1443
.PP
1455
1444
Rxvt-unicode requires the symbol \f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR to be defined
1456
1445
in your compile environment, or an implementation that implements it,
1457
 
wether it defines the symbol or not. \f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR requires that
 
1446
whether it defines the symbol or not. \f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR requires that
1458
1447
\&\fBwchar_t\fR is represented as unicode.
1459
1448
.PP
1460
 
As you might have guessed, FreeBSD does neither define this symobl nor
1461
 
does it support it. Instead, it uses it's own internal representation of
 
1449
As you might have guessed, FreeBSD does neither define this symbol nor
 
1450
does it support it. Instead, it uses its own internal representation of
1462
1451
\&\fBwchar_t\fR. This is, of course, completely fine with respect to standards.
1463
1452
.PP
1464
1453
However, that means rxvt-unicode only works in \f(CW\*(C`POSIX\*(C'\fR, \f(CW\*(C`ISO\-8859\-1\*(C'\fR and
1680
1669
C = C   Finnish character set unimplemented
1681
1670
C = K   German character set unimplemented
1682
1671
.TE
1683
 
 
1684
1672
.PP
1685
1673
 
1686
1674
.IX Xref "CSI"
1739
1727
Ps = 1  Clear Above
1740
1728
Ps = 2  Clear All
1741
1729
.TE
1742
 
 
1743
1730
.ie n .IP "\fB\fB""ESC [ Ps K""\fB\fR" 4
1744
1731
.el .IP "\fB\f(CBESC [ Ps K\fB\fR" 4
1745
1732
.IX Item "ESC [ Ps K"
1750
1737
Ps = 1  Clear to Left
1751
1738
Ps = 2  Clear All
1752
1739
.TE
1753
 
 
1754
1740
.ie n .IP "\fB\fB""ESC [ Ps L""\fB\fR" 4
1755
1741
.el .IP "\fB\f(CBESC [ Ps L\fB\fR" 4
1756
1742
.IX Item "ESC [ Ps L"
1778
1764
Ps = 2  Tab Clear (TBC), Clear Current Column (default)
1779
1765
Ps = 5  Tab Clear (TBC), Clear All
1780
1766
.TE
1781
 
 
1782
1767
.ie n .IP "\fB\fB""ESC [ Ps X""\fB\fR" 4
1783
1768
.el .IP "\fB\f(CBESC [ Ps X\fB\fR" 4
1784
1769
.IX Item "ESC [ Ps X"
1823
1808
Ps = 0  Clear Current Column (default)
1824
1809
Ps = 3  Clear All (TBC)
1825
1810
.TE
1826
 
 
1827
1811
.ie n .IP "\fB\fB""ESC [ Pm h""\fB\fR" 4
1828
1812
.el .IP "\fB\f(CBESC [ Pm h\fB\fR" 4
1829
1813
.IX Item "ESC [ Pm h"
1838
1822
Ps = 4  disable transparent print mode (MC4)
1839
1823
Ps = 5  enable transparent print mode (MC5)
1840
1824
.TE
1841
 
 
1842
1825
.ie n .IP "\fB\fB""ESC [ Pm l""\fB\fR" 4
1843
1826
.el .IP "\fB\f(CBESC [ Pm l\fB\fR" 4
1844
1827
.IX Item "ESC [ Pm l"
1852
1835
h       Insert Mode (SMIR)
1853
1836
l       Replace Mode (RMIR)
1854
1837
.TE
1855
 
 
1856
1838
.PD 0
1857
1839
.ie n .IP "\fB\fB""Ps = 20""\fB\fR (partially implemented)" 4
1858
1840
.el .IP "\fB\f(CBPs = 20\fB\fR (partially implemented)" 4
1862
1844
h       Automatic Newline (LNM)
1863
1845
l       Normal Linefeed (LNM)
1864
1846
.TE
1865
 
 
1866
1847
.RE
1867
1848
.RS 4
1868
1849
.RE
1901
1882
Ps = 97 / 107   fg/bg Bright White
1902
1883
Ps = 99 / 109   fg/bg Bright Default
1903
1884
.TE
1904
 
 
1905
1885
.ie n .IP "\fB\fB""ESC [ Ps n""\fB\fR" 4
1906
1886
.el .IP "\fB\f(CBESC [ Ps n\fB\fR" 4
1907
1887
.IX Item "ESC [ Ps n"
1913
1893
Ps = 7  Request Display Name
1914
1894
Ps = 8  Request Version Number (place in window title)
1915
1895
.TE
1916
 
 
1917
1896
.ie n .IP "\fB\fB""ESC [ Ps;Ps r""\fB\fR" 4
1918
1897
.el .IP "\fB\f(CBESC [ Ps;Ps r\fB\fR" 4
1919
1898
.IX Item "ESC [ Ps;Ps r"
1946
1925
Ps = 21 Reports window title (ESC ] l NAME \234)
1947
1926
Ps = 24..       Set window height to Ps rows
1948
1927
.TE
1949
 
 
1950
1928
.ie n .IP "\fB\fB""ESC [ u""\fB\fR" 4
1951
1929
.el .IP "\fB\f(CBESC [ u\fB\fR" 4
1952
1930
.IX Item "ESC [ u"
1981
1959
.IX Item "ESC [ ? Pm t"
1982
1960
Toggle \s-1DEC\s0 Private Mode Values (rxvt extension). \fIwhere\fR
1983
1961
.RS 4
1984
 
.ie n .IP "\fB\fB""Ps = 1""\fB\fR (\s-1DECCKM\s0)" 4
1985
 
.el .IP "\fB\f(CBPs = 1\fB\fR (\s-1DECCKM\s0)" 4
1986
 
.IX Item "Ps = 1 (DECCKM)"
 
1962
.ie n .IP "\fB\fB""Pm = 1""\fB\fR (\s-1DECCKM\s0)" 4
 
1963
.el .IP "\fB\f(CBPm = 1\fB\fR (\s-1DECCKM\s0)" 4
 
1964
.IX Item "Pm = 1 (DECCKM)"
1987
1965
.TS
1988
1966
l l .
1989
1967
h       Application Cursor Keys
1990
1968
l       Normal Cursor Keys
1991
1969
.TE
1992
 
 
1993
1970
.PD 0
1994
 
.ie n .IP "\fB\fB""Ps = 2""\fB\fR (\s-1ANSI/VT52\s0 mode)" 4
1995
 
.el .IP "\fB\f(CBPs = 2\fB\fR (\s-1ANSI/VT52\s0 mode)" 4
1996
 
.IX Item "Ps = 2 (ANSI/VT52 mode)"
 
1971
.ie n .IP "\fB\fB""Pm = 2""\fB\fR (\s-1ANSI/VT52\s0 mode)" 4
 
1972
.el .IP "\fB\f(CBPm = 2\fB\fR (\s-1ANSI/VT52\s0 mode)" 4
 
1973
.IX Item "Pm = 2 (ANSI/VT52 mode)"
1997
1974
.TS
1998
1975
l l .
1999
1976
h       Enter VT52 mode
2000
1977
l       Enter VT52 mode
2001
1978
.TE
2002
 
 
2003
 
.ie n .IP "\fB\fB""Ps = 3""\fB\fR" 4
2004
 
.el .IP "\fB\f(CBPs = 3\fB\fR" 4
2005
 
.IX Item "Ps = 3"
 
1979
.ie n .IP "\fB\fB""Pm = 3""\fB\fR" 4
 
1980
.el .IP "\fB\f(CBPm = 3\fB\fR" 4
 
1981
.IX Item "Pm = 3"
2006
1982
.TS
2007
1983
l l .
2008
1984
h       132 Column Mode (DECCOLM)
2009
1985
l       80 Column Mode (DECCOLM)
2010
1986
.TE
2011
 
 
2012
 
.ie n .IP "\fB\fB""Ps = 4""\fB\fR" 4
2013
 
.el .IP "\fB\f(CBPs = 4\fB\fR" 4
2014
 
.IX Item "Ps = 4"
 
1987
.ie n .IP "\fB\fB""Pm = 4""\fB\fR" 4
 
1988
.el .IP "\fB\f(CBPm = 4\fB\fR" 4
 
1989
.IX Item "Pm = 4"
2015
1990
.TS
2016
1991
l l .
2017
1992
h       Smooth (Slow) Scroll (DECSCLM)
2018
1993
l       Jump (Fast) Scroll (DECSCLM)
2019
1994
.TE
2020
 
 
2021
 
.ie n .IP "\fB\fB""Ps = 5""\fB\fR" 4
2022
 
.el .IP "\fB\f(CBPs = 5\fB\fR" 4
2023
 
.IX Item "Ps = 5"
 
1995
.ie n .IP "\fB\fB""Pm = 5""\fB\fR" 4
 
1996
.el .IP "\fB\f(CBPm = 5\fB\fR" 4
 
1997
.IX Item "Pm = 5"
2024
1998
.TS
2025
1999
l l .
2026
2000
h       Reverse Video (DECSCNM)
2027
2001
l       Normal Video (DECSCNM)
2028
2002
.TE
2029
 
 
2030
 
.ie n .IP "\fB\fB""Ps = 6""\fB\fR" 4
2031
 
.el .IP "\fB\f(CBPs = 6\fB\fR" 4
2032
 
.IX Item "Ps = 6"
 
2003
.ie n .IP "\fB\fB""Pm = 6""\fB\fR" 4
 
2004
.el .IP "\fB\f(CBPm = 6\fB\fR" 4
 
2005
.IX Item "Pm = 6"
2033
2006
.TS
2034
2007
l l .
2035
2008
h       Origin Mode (DECOM)
2036
2009
l       Normal Cursor Mode (DECOM)
2037
2010
.TE
2038
 
 
2039
 
.ie n .IP "\fB\fB""Ps = 7""\fB\fR" 4
2040
 
.el .IP "\fB\f(CBPs = 7\fB\fR" 4
2041
 
.IX Item "Ps = 7"
 
2011
.ie n .IP "\fB\fB""Pm = 7""\fB\fR" 4
 
2012
.el .IP "\fB\f(CBPm = 7\fB\fR" 4
 
2013
.IX Item "Pm = 7"
2042
2014
.TS
2043
2015
l l .
2044
2016
h       Wraparound Mode (DECAWM)
2045
2017
l       No Wraparound Mode (DECAWM)
2046
2018
.TE
2047
 
 
2048
 
.ie n .IP "\fB\fB""Ps = 8""\fB\fR \fIunimplemented\fR" 4
2049
 
.el .IP "\fB\f(CBPs = 8\fB\fR \fIunimplemented\fR" 4
2050
 
.IX Item "Ps = 8 unimplemented"
 
2019
.ie n .IP "\fB\fB""Pm = 8""\fB\fR \fIunimplemented\fR" 4
 
2020
.el .IP "\fB\f(CBPm = 8\fB\fR \fIunimplemented\fR" 4
 
2021
.IX Item "Pm = 8 unimplemented"
2051
2022
.TS
2052
2023
l l .
2053
2024
h       Auto-repeat Keys (DECARM)
2054
2025
l       No Auto-repeat Keys (DECARM)
2055
2026
.TE
2056
 
 
2057
 
.ie n .IP "\fB\fB""Ps = 9""\fB\fR X10 XTerm" 4
2058
 
.el .IP "\fB\f(CBPs = 9\fB\fR X10 XTerm" 4
2059
 
.IX Item "Ps = 9 X10 XTerm"
 
2027
.ie n .IP "\fB\fB""Pm = 9""\fB\fR X10 XTerm" 4
 
2028
.el .IP "\fB\f(CBPm = 9\fB\fR X10 XTerm" 4
 
2029
.IX Item "Pm = 9 X10 XTerm"
2060
2030
.TS
2061
2031
l l .
2062
2032
h       Send Mouse X & Y on button press.
2063
2033
l       No mouse reporting.
2064
2034
.TE
2065
 
 
2066
 
.ie n .IP "\fB\fB""Ps = 25""\fB\fR" 4
2067
 
.el .IP "\fB\f(CBPs = 25\fB\fR" 4
2068
 
.IX Item "Ps = 25"
 
2035
.ie n .IP "\fB\fB""Pm = 25""\fB\fR" 4
 
2036
.el .IP "\fB\f(CBPm = 25\fB\fR" 4
 
2037
.IX Item "Pm = 25"
2069
2038
.TS
2070
2039
l l .
2071
2040
h       Visible cursor {cnorm/cvvis}
2072
2041
l       Invisible cursor {civis}
2073
2042
.TE
2074
 
 
2075
 
.ie n .IP "\fB\fB""Ps = 30""\fB\fR" 4
2076
 
.el .IP "\fB\f(CBPs = 30\fB\fR" 4
2077
 
.IX Item "Ps = 30"
 
2043
.ie n .IP "\fB\fB""Pm = 30""\fB\fR" 4
 
2044
.el .IP "\fB\f(CBPm = 30\fB\fR" 4
 
2045
.IX Item "Pm = 30"
2078
2046
.TS
2079
2047
l l .
2080
2048
h       scrollBar visisble
2081
2049
l       scrollBar invisisble
2082
2050
.TE
2083
 
 
2084
 
.ie n .IP "\fB\fB""Ps = 35""\fB\fR (\fBrxvt\fR)" 4
2085
 
.el .IP "\fB\f(CBPs = 35\fB\fR (\fBrxvt\fR)" 4
2086
 
.IX Item "Ps = 35 (rxvt)"
 
2051
.ie n .IP "\fB\fB""Pm = 35""\fB\fR (\fBrxvt\fR)" 4
 
2052
.el .IP "\fB\f(CBPm = 35\fB\fR (\fBrxvt\fR)" 4
 
2053
.IX Item "Pm = 35 (rxvt)"
2087
2054
.TS
2088
2055
l l .
2089
2056
h       Allow XTerm Shift+key sequences
2090
2057
l       Disallow XTerm Shift+key sequences
2091
2058
.TE
2092
 
 
2093
 
.ie n .IP "\fB\fB""Ps = 38""\fB\fR \fIunimplemented\fR" 4
2094
 
.el .IP "\fB\f(CBPs = 38\fB\fR \fIunimplemented\fR" 4
2095
 
.IX Item "Ps = 38 unimplemented"
 
2059
.ie n .IP "\fB\fB""Pm = 38""\fB\fR \fIunimplemented\fR" 4
 
2060
.el .IP "\fB\f(CBPm = 38\fB\fR \fIunimplemented\fR" 4
 
2061
.IX Item "Pm = 38 unimplemented"
2096
2062
.PD
2097
2063
Enter Tektronix Mode (\s-1DECTEK\s0)
2098
 
.ie n .IP "\fB\fB""Ps = 40""\fB\fR" 4
2099
 
.el .IP "\fB\f(CBPs = 40\fB\fR" 4
2100
 
.IX Item "Ps = 40"
 
2064
.ie n .IP "\fB\fB""Pm = 40""\fB\fR" 4
 
2065
.el .IP "\fB\f(CBPm = 40\fB\fR" 4
 
2066
.IX Item "Pm = 40"
2101
2067
.TS
2102
2068
l l .
2103
2069
h       Allow 80/132 Mode
2104
2070
l       Disallow 80/132 Mode
2105
2071
.TE
2106
 
 
2107
2072
.PD 0
2108
 
.ie n .IP "\fB\fB""Ps = 44""\fB\fR \fIunimplemented\fR" 4
2109
 
.el .IP "\fB\f(CBPs = 44\fB\fR \fIunimplemented\fR" 4
2110
 
.IX Item "Ps = 44 unimplemented"
 
2073
.ie n .IP "\fB\fB""Pm = 44""\fB\fR \fIunimplemented\fR" 4
 
2074
.el .IP "\fB\f(CBPm = 44\fB\fR \fIunimplemented\fR" 4
 
2075
.IX Item "Pm = 44 unimplemented"
2111
2076
.TS
2112
2077
l l .
2113
2078
h       Turn On Margin Bell
2114
2079
l       Turn Off Margin Bell
2115
2080
.TE
2116
 
 
2117
 
.ie n .IP "\fB\fB""Ps = 45""\fB\fR \fIunimplemented\fR" 4
2118
 
.el .IP "\fB\f(CBPs = 45\fB\fR \fIunimplemented\fR" 4
2119
 
.IX Item "Ps = 45 unimplemented"
 
2081
.ie n .IP "\fB\fB""Pm = 45""\fB\fR \fIunimplemented\fR" 4
 
2082
.el .IP "\fB\f(CBPm = 45\fB\fR \fIunimplemented\fR" 4
 
2083
.IX Item "Pm = 45 unimplemented"
2120
2084
.TS
2121
2085
l l .
2122
2086
h       Reverse-wraparound Mode
2123
2087
l       No Reverse-wraparound Mode
2124
2088
.TE
2125
 
 
2126
 
.ie n .IP "\fB\fB""Ps = 46""\fB\fR \fIunimplemented\fR" 4
2127
 
.el .IP "\fB\f(CBPs = 46\fB\fR \fIunimplemented\fR" 4
2128
 
.IX Item "Ps = 46 unimplemented"
2129
 
.ie n .IP "\fB\fB""Ps = 47""\fB\fR" 4
2130
 
.el .IP "\fB\f(CBPs = 47\fB\fR" 4
2131
 
.IX Item "Ps = 47"
 
2089
.ie n .IP "\fB\fB""Pm = 46""\fB\fR \fIunimplemented\fR" 4
 
2090
.el .IP "\fB\f(CBPm = 46\fB\fR \fIunimplemented\fR" 4
 
2091
.IX Item "Pm = 46 unimplemented"
 
2092
.ie n .IP "\fB\fB""Pm = 47""\fB\fR" 4
 
2093
.el .IP "\fB\f(CBPm = 47\fB\fR" 4
 
2094
.IX Item "Pm = 47"
2132
2095
.TS
2133
2096
l l .
2134
2097
h       Use Alternate Screen Buffer
2135
2098
l       Use Normal Screen Buffer
2136
2099
.TE
2137
 
 
2138
2100
.PD
2139
2101
 
2140
2102
.IX Xref "Priv66"
2141
 
.ie n .IP "\fB\fB""Ps = 66""\fB\fR" 4
2142
 
.el .IP "\fB\f(CBPs = 66\fB\fR" 4
2143
 
.IX Item "Ps = 66"
 
2103
.ie n .IP "\fB\fB""Pm = 66""\fB\fR" 4
 
2104
.el .IP "\fB\f(CBPm = 66\fB\fR" 4
 
2105
.IX Item "Pm = 66"
2144
2106
.TS
2145
2107
l l .
2146
2108
h       Application Keypad (DECPAM) == ESC =
2147
2109
l       Normal Keypad (DECPNM) == ESC >
2148
2110
.TE
2149
 
 
2150
2111
.PD 0
2151
 
.ie n .IP "\fB\fB""Ps = 67""\fB\fR" 4
2152
 
.el .IP "\fB\f(CBPs = 67\fB\fR" 4
2153
 
.IX Item "Ps = 67"
 
2112
.ie n .IP "\fB\fB""Pm = 67""\fB\fR" 4
 
2113
.el .IP "\fB\f(CBPm = 67\fB\fR" 4
 
2114
.IX Item "Pm = 67"
2154
2115
.TS
2155
2116
l l .
2156
2117
h       Backspace key sends BS (DECBKM)
2157
2118
l       Backspace key sends DEL
2158
2119
.TE
2159
 
 
2160
 
.ie n .IP "\fB\fB""Ps = 1000""\fB\fR (X11 XTerm)" 4
2161
 
.el .IP "\fB\f(CBPs = 1000\fB\fR (X11 XTerm)" 4
2162
 
.IX Item "Ps = 1000 (X11 XTerm)"
 
2120
.ie n .IP "\fB\fB""Pm = 1000""\fB\fR (X11 XTerm)" 4
 
2121
.el .IP "\fB\f(CBPm = 1000\fB\fR (X11 XTerm)" 4
 
2122
.IX Item "Pm = 1000 (X11 XTerm)"
2163
2123
.TS
2164
2124
l l .
2165
2125
h       Send Mouse X & Y on button press and release.
2166
2126
l       No mouse reporting.
2167
2127
.TE
2168
 
 
2169
 
.ie n .IP "\fB\fB""Ps = 1001""\fB\fR (X11 XTerm) \fIunimplemented\fR" 4
2170
 
.el .IP "\fB\f(CBPs = 1001\fB\fR (X11 XTerm) \fIunimplemented\fR" 4
2171
 
.IX Item "Ps = 1001 (X11 XTerm) unimplemented"
 
2128
.ie n .IP "\fB\fB""Pm = 1001""\fB\fR (X11 XTerm) \fIunimplemented\fR" 4
 
2129
.el .IP "\fB\f(CBPm = 1001\fB\fR (X11 XTerm) \fIunimplemented\fR" 4
 
2130
.IX Item "Pm = 1001 (X11 XTerm) unimplemented"
2172
2131
.TS
2173
2132
l l .
2174
2133
h       Use Hilite Mouse Tracking.
2175
2134
l       No mouse reporting.
2176
2135
.TE
2177
 
 
2178
 
.ie n .IP "\fB\fB""Ps = 1010""\fB\fR (\fBrxvt\fR)" 4
2179
 
.el .IP "\fB\f(CBPs = 1010\fB\fR (\fBrxvt\fR)" 4
2180
 
.IX Item "Ps = 1010 (rxvt)"
 
2136
.ie n .IP "\fB\fB""Pm = 1010""\fB\fR (\fBrxvt\fR)" 4
 
2137
.el .IP "\fB\f(CBPm = 1010\fB\fR (\fBrxvt\fR)" 4
 
2138
.IX Item "Pm = 1010 (rxvt)"
2181
2139
.TS
2182
2140
l l .
2183
2141
h       Don't scroll to bottom on TTY output
2184
2142
l       Scroll to bottom on TTY output
2185
2143
.TE
2186
 
 
2187
 
.ie n .IP "\fB\fB""Ps = 1011""\fB\fR (\fBrxvt\fR)" 4
2188
 
.el .IP "\fB\f(CBPs = 1011\fB\fR (\fBrxvt\fR)" 4
2189
 
.IX Item "Ps = 1011 (rxvt)"
 
2144
.ie n .IP "\fB\fB""Pm = 1011""\fB\fR (\fBrxvt\fR)" 4
 
2145
.el .IP "\fB\f(CBPm = 1011\fB\fR (\fBrxvt\fR)" 4
 
2146
.IX Item "Pm = 1011 (rxvt)"
2190
2147
.TS
2191
2148
l l .
2192
2149
h       Scroll to bottom when a key is pressed
2193
2150
l       Don't scroll to bottom when a key is pressed
2194
2151
.TE
2195
 
 
2196
 
.ie n .IP "\fB\fB""Ps = 1021""\fB\fR (\fBrxvt\fR)" 4
2197
 
.el .IP "\fB\f(CBPs = 1021\fB\fR (\fBrxvt\fR)" 4
2198
 
.IX Item "Ps = 1021 (rxvt)"
 
2152
.ie n .IP "\fB\fB""Pm = 1021""\fB\fR (\fBrxvt\fR)" 4
 
2153
.el .IP "\fB\f(CBPm = 1021\fB\fR (\fBrxvt\fR)" 4
 
2154
.IX Item "Pm = 1021 (rxvt)"
2199
2155
.TS
2200
2156
l l .
2201
2157
h       Bold/italic implies high intensity (see option -is)
2202
2158
l       Font styles have no effect on intensity (Compile styles)
2203
2159
.TE
2204
 
 
2205
 
.ie n .IP "\fB\fB""Ps = 1047""\fB\fR" 4
2206
 
.el .IP "\fB\f(CBPs = 1047\fB\fR" 4
2207
 
.IX Item "Ps = 1047"
 
2160
.ie n .IP "\fB\fB""Pm = 1047""\fB\fR" 4
 
2161
.el .IP "\fB\f(CBPm = 1047\fB\fR" 4
 
2162
.IX Item "Pm = 1047"
2208
2163
.TS
2209
2164
l l .
2210
2165
h       Use Alternate Screen Buffer
2211
2166
l       Use Normal Screen Buffer - clear Alternate Screen Buffer if returning from it
2212
2167
.TE
2213
 
 
2214
 
.ie n .IP "\fB\fB""Ps = 1048""\fB\fR" 4
2215
 
.el .IP "\fB\f(CBPs = 1048\fB\fR" 4
2216
 
.IX Item "Ps = 1048"
 
2168
.ie n .IP "\fB\fB""Pm = 1048""\fB\fR" 4
 
2169
.el .IP "\fB\f(CBPm = 1048\fB\fR" 4
 
2170
.IX Item "Pm = 1048"
2217
2171
.TS
2218
2172
l l .
2219
2173
h       Save cursor position
2220
2174
l       Restore cursor position
2221
2175
.TE
2222
 
 
2223
 
.ie n .IP "\fB\fB""Ps = 1049""\fB\fR" 4
2224
 
.el .IP "\fB\f(CBPs = 1049\fB\fR" 4
2225
 
.IX Item "Ps = 1049"
 
2176
.ie n .IP "\fB\fB""Pm = 1049""\fB\fR" 4
 
2177
.el .IP "\fB\f(CBPm = 1049\fB\fR" 4
 
2178
.IX Item "Pm = 1049"
2226
2179
.TS
2227
2180
l l .
2228
2181
h       Use Alternate Screen Buffer - clear Alternate Screen Buffer if switching to it
2229
2182
l       Use Normal Screen Buffer
2230
2183
.TE
2231
 
 
2232
2184
.RE
2233
2185
.RS 4
2234
2186
.RE
2278
2230
Ps = 721        Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
2279
2231
Ps = 777        Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl).
2280
2232
.TE
2281
 
 
2282
2233
.SH "XPM"
2283
2234
.IX Header "XPM"
2284
2235
For the \s-1XPM\s0 XTerm escape sequence \fB\f(CB\*(C`ESC ] 20 ; Pt ST\*(C'\fB\fR then value
2346
2297
2       Button3 pressed
2347
2298
3       button released (X11 mouse report)
2348
2299
.TE
2349
 
 
2350
2300
.PP
2351
2301
The upper bits of \fB\f(CB\*(C`<b>\*(C'\fB\fR indicate the modifiers when the
2352
2302
button was pressed and are added together (X11 mouse report only):
2360
2310
16      Control
2361
2311
32      Double Click (rxvt extension)
2362
2312
.TE
2363
 
 
2364
2313
Col = \fB\f(CB\*(C`<x> \- SPACE\*(C'\fB\fR
2365
2314
.Sp
2366
2315
Row = \fB\f(CB\*(C`<y> \- SPACE\*(C'\fB\fR
2434
2383
XK_KP_8 8                       ESC O x
2435
2384
XK_KP_9 9                       ESC O y
2436
2385
.TE
2437
 
 
2438
2386
.SH "CONFIGURE OPTIONS"
2439
2387
.IX Header "CONFIGURE OPTIONS"
2440
2388
General hint: if you get compile errors, then likely your configuration
2482
2430
jp_ext  rarely used but big japanese encodings
2483
2431
kr      korean encodings
2484
2432
.TE
2485
 
 
2486
2433
.IP "\-\-enable\-xim (default: on)" 4
2487
2434
.IX Item "--enable-xim (default: on)"
2488
2435
Add support for \s-1XIM\s0 (X Input Method) protocol. This allows using
2600
2547
A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly
2601
2548
in combination with other switches) is:
2602
2549
.Sp
2603
 
.Vb 15
2604
 
\&  MWM-hints
2605
 
\&  EWMH-hints (pid, utf8 names) and protocols (ping)
2606
 
\&  seperate underline colour (-underlineColor)
2607
 
\&  settable border widths and borderless switch (-w, -b, -bl)
2608
 
\&  visual depth selection (-depth)
2609
 
\&  settable extra linespacing /-lsp)
2610
 
\&  iso-14755-2 and -3, and visual feedback
2611
 
\&  tripleclickwords (-tcw)
2612
 
\&  settable insecure mode (-insecure)
 
2550
.Vb 10
 
2551
\&  MWM\-hints
 
2552
\&  EWMH\-hints (pid, utf8 names) and protocols (ping)
 
2553
\&  seperate underline colour (\-underlineColor)
 
2554
\&  settable border widths and borderless switch (\-w, \-b, \-bl)
 
2555
\&  visual depth selection (\-depth)
 
2556
\&  settable extra linespacing /\-lsp)
 
2557
\&  iso\-14755\-2 and \-3, and visual feedback
 
2558
\&  tripleclickwords (\-tcw)
 
2559
\&  settable insecure mode (\-insecure)
2613
2560
\&  keysym remapping support
2614
 
\&  cursor blinking and underline cursor (-cb, -uc)
2615
 
\&  XEmbed support (-embed)
2616
 
\&  user-pty (-pty-fd)
2617
 
\&  hold on exit (-hold)
2618
 
\&  skip builtin block graphics (-sbg)
 
2561
\&  cursor blinking and underline cursor (\-cb, \-uc)
 
2562
\&  XEmbed support (\-embed)
 
2563
\&  user\-pty (\-pty\-fd)
 
2564
\&  hold on exit (\-hold)
 
2565
\&  skip builtin block graphics (\-sbg)
 
2566
\&  separate highlightcolor support (\-hc)
2619
2567
.Ve
2620
2568
.Sp
2621
 
It also enabled some non-essential features otherwise disabled, such as:
 
2569
It also enables some non-essential features otherwise disabled, such as:
2622
2570
.Sp
2623
2571
.Vb 11
2624
 
\&  some round-trip time optimisations
 
2572
\&  some round\-trip time optimisations
2625
2573
\&  nearest color allocation on pseudocolor screens
2626
2574
\&  UTF8_STRING supporr for selection
2627
2575
\&  sgr modes 90..97 and 100..107
2712
2660
reworked it from the original Rxvt documentation, which was done by Geoff
2713
2661
Wing <gcw@pobox.com>, who in turn used the XTerm documentation and other
2714
2662
sources.
 
2663
.SH "POD ERRORS"
 
2664
.IX Header "POD ERRORS"
 
2665
Hey! \fBThe above document had some coding errors, which are explained below:\fR
 
2666
.IP "Around line 2952:" 4
 
2667
.IX Item "Around line 2952:"
 
2668
=back doesn't take any parameters, but you said =back  X<Mouse>
 
2669
.IP "Around line 3048:" 4
 
2670
.IX Item "Around line 3048:"
 
2671
=back doesn't take any parameters, but you said =back  X<KeyCodes>