… | |
… | |
127 | .\} |
127 | .\} |
128 | .rm #[ #] #H #V #F C |
128 | .rm #[ #] #H #V #F C |
129 | .\" ======================================================================== |
129 | .\" ======================================================================== |
130 | .\" |
130 | .\" |
131 | .IX Title "rxvt 1" |
131 | .IX Title "rxvt 1" |
132 | .TH rxvt 1 "2006-01-11" "6.3" "RXVT-UNICODE" |
132 | .TH rxvt 1 "2006-01-11" "7.0" "RXVT-UNICODE" |
133 | .SH "NAME" |
133 | .SH "NAME" |
134 | rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system) |
134 | rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system) |
135 | .SH "SYNOPSIS" |
135 | .SH "SYNOPSIS" |
136 | .IX Header "SYNOPSIS" |
136 | .IX Header "SYNOPSIS" |
137 | \&\fB@@RXVT_NAME@@\fR [options] [\-e command [ args ]] |
137 | \&\fB@@RXVT_NAME@@\fR [options] [\-e command [ args ]] |
… | |
… | |
551 | .SH "RESOURCES (available also as long\-options)" |
551 | .SH "RESOURCES (available also as long\-options)" |
552 | .IX Header "RESOURCES (available also as long-options)" |
552 | .IX Header "RESOURCES (available also as long-options)" |
553 | Note: `@@RXVT_NAME@@ \-\-help' gives a list of all resources (long |
553 | Note: `@@RXVT_NAME@@ \-\-help' gives a list of all resources (long |
554 | options) compiled into your version. |
554 | options) compiled into your version. |
555 | .PP |
555 | .PP |
556 | There are two different methods that @@RXVT_NAME@@ can use to get the |
556 | You can set and change the resources using X11 tools like \fBxrdb\fR. Many |
557 | Xresource data: using the X libraries (Xrm*\-functions) or internal |
557 | distribution do also load settings from the \fB~/.Xresources\fR file when X |
558 | Xresources reader (\fB~/.Xdefaults\fR). For the first method (ie. |
558 | starts. @@RXVT_NAME@@ will consult the following files/resources in order, |
559 | \&\fB@@RXVT_NAME@@ \-h\fR lists \fBXGetDefaults\fR), you can set and change the |
559 | with later settings overwriting earlier ones: |
560 | resources using X11 tools like \fBxrdb\fR. Many distribution do also load |
|
|
561 | settings from the \fB~/.Xresources\fR file when X starts. @@RXVT_NAME@@ |
|
|
562 | will consult the following files/resources in order, with later settings |
|
|
563 | overwriting earlier ones: |
|
|
564 | .PP |
560 | .PP |
565 | .Vb 5 |
561 | .Vb 5 |
566 | \& 1. system-wide app-defaults file, either locale-dependent OR global |
562 | \& 1. system-wide app-defaults file, either locale-dependent OR global |
567 | \& 2. app-defaults file in $XAPPLRESDIR |
563 | \& 2. app-defaults file in $XAPPLRESDIR |
568 | \& 3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults |
564 | \& 3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults |
569 | \& 4. SCREEN_RESOURCES for the current screen |
565 | \& 4. SCREEN_RESOURCES for the current screen |
570 | \& 5. $XENVIRONMENT file OR $HOME/.Xdefaults-<nodename> |
566 | \& 5. $XENVIRONMENT file OR $HOME/.Xdefaults-<nodename> |
571 | .Ve |
567 | .Ve |
572 | .PP |
568 | .PP |
573 | If compiled with internal Xresources support (i.e. \fB@@RXVT_NAME@@ \-h\fR |
|
|
574 | lists \fB.Xdefaults\fR) then \fB@@RXVT_NAME@@\fR accepts application defaults |
|
|
575 | set in XAPPLOADDIR/URxvt (compile\-time defined: usually |
|
|
576 | \&\fB/usr/lib/X11/app\-defaults/URxvt\fR) and resources set in |
|
|
577 | \&\fB~/.Xdefaults\fR, or \fB~/.Xresources\fR if \fB~/.Xdefaults\fR does not exist. |
|
|
578 | Note that when reading X resources, \fB@@RXVT_NAME@@\fR recognizes two |
569 | Note that when reading X resources, \fB@@RXVT_NAME@@\fR recognizes two class |
579 | class names: \fBXTerm\fR and \fBURxvt\fR. The class name \fBRxvt\fR allows |
570 | names: \fBRxvt\fR and \fBURxvt\fR. The class name \fBRxvt\fR allows resources |
580 | resources common to both \fB@@RXVT_NAME@@\fR and the original \fIrxvt\fR to be |
571 | common to both \fB@@RXVT_NAME@@\fR and the original \fIrxvt\fR to be easily |
581 | easily configured, while the class name \fBURxvt\fR allows resources |
572 | configured, while the class name \fBURxvt\fR allows resources unique to |
582 | unique to \fB@@RXVT_NAME@@\fR, notably colours and key\-handling, to be |
573 | \&\fB@@RXVT_NAME@@\fR, to be shared between different \fB@@RXVT_NAME@@\fR |
583 | shared between different \fB@@RXVT_NAME@@\fR configurations. If no |
574 | configurations. If no resources are specified, suitable defaults will |
584 | resources are specified, suitable defaults will be used. Command-line |
575 | be used. Command-line arguments can be used to override resource |
585 | arguments can be used to override resource settings. The following |
576 | settings. The following resources are supported (you might want to |
586 | resources are allowed: |
577 | check the @@RXVT_NAME@@\fIperl\fR\|(3) manpage for additional settings by perl |
|
|
578 | extensions not documented here): |
587 | .IP "\fBgeometry:\fR \fIgeom\fR" 4 |
579 | .IP "\fBgeometry:\fR \fIgeom\fR" 4 |
588 | .IX Item "geometry: geom" |
580 | .IX Item "geometry: geom" |
589 | Create the window with the specified X window geometry [default 80x24]; |
581 | Create the window with the specified X window geometry [default 80x24]; |
590 | option \fB\-geometry\fR. |
582 | option \fB\-geometry\fR. |
591 | .IP "\fBbackground:\fR \fIcolour\fR" 4 |
583 | .IP "\fBbackground:\fR \fIcolour\fR" 4 |
… | |
… | |
1026 | \&\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, |
1018 | \&\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, |
1027 | \&\f(CW\*(C`\e000\*(C'\fR: octal number) or verbatim control characters (\f(CW\*(C`^?\*(C'\fR: delete, |
1019 | \&\f(CW\*(C`\e000\*(C'\fR: octal number) or verbatim control characters (\f(CW\*(C`^?\*(C'\fR: delete, |
1028 | \&\f(CW\*(C`^@\*(C'\fR: null, \f(CW\*(C`^A\*(C'\fR ...) and may be enclosed with double quotes so that it |
1020 | \&\f(CW\*(C`^@\*(C'\fR: null, \f(CW\*(C`^A\*(C'\fR ...) and may be enclosed with double quotes so that it |
1029 | can start or end with whitespace. |
1021 | can start or end with whitespace. |
1030 | .Sp |
1022 | .Sp |
1031 | Please note that you need to double the \f(CW\*(C`\e\*(C'\fR when using |
1023 | Please note that you need to double the \f(CW\*(C`\e\*(C'\fR in resource files, as |
1032 | \&\f(CW\*(C`\-\-enable\-xgetdefault\*(C'\fR, as X itself does it's own de-escaping (you can |
1024 | Xlib itself does it's own de-escaping (you can use \f(CW\*(C`\e033\*(C'\fR instead of |
1033 | use \f(CW\*(C`\e033\*(C'\fR instead of \f(CW\*(C`\ee\*(C'\fR (and so on), which will work with both Xt and |
1025 | \&\f(CW\*(C`\ee\*(C'\fR (and so on), which will work with both Xt and @@RXVT_NAME@@'s own |
1034 | @@RXVT_NAME@@'s own processing). |
1026 | processing). |
1035 | .Sp |
1027 | .Sp |
1036 | You can define a range of keysyms in one shot by providing a \fIstring\fR |
1028 | You can define a range of keysyms in one shot by providing a \fIstring\fR |
1037 | with pattern \fBlist/PREFIX/MIDDLE/SUFFIX\fR, where the delimeter `/' |
1029 | with pattern \fBlist/PREFIX/MIDDLE/SUFFIX\fR, where the delimeter `/' |
1038 | should be a character not used by the strings. |
1030 | should be a character not used by the strings. |
1039 | .Sp |
1031 | .Sp |