ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvt.1.man.in
(Generate patch)

Comparing rxvt-unicode/doc/rxvt.1.man.in (file contents):
Revision 1.42 by root, Wed Jan 11 02:13:55 2006 UTC vs.
Revision 1.43 by root, Wed Jan 11 23:08:54 2006 UTC

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"
134rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system) 134rxvt\-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)"
553Note: `@@RXVT_NAME@@ \-\-help' gives a list of all resources (long 553Note: `@@RXVT_NAME@@ \-\-help' gives a list of all resources (long
554options) compiled into your version. 554options) compiled into your version.
555.PP 555.PP
556There are two different methods that @@RXVT_NAME@@ can use to get the 556You can set and change the resources using X11 tools like \fBxrdb\fR. Many
557Xresource data: using the X libraries (Xrm*\-functions) or internal 557distribution do also load settings from the \fB~/.Xresources\fR file when X
558Xresources reader (\fB~/.Xdefaults\fR). For the first method (ie. 558starts. @@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 559with later settings overwriting earlier ones:
560resources using X11 tools like \fBxrdb\fR. Many distribution do also load
561settings from the \fB~/.Xresources\fR file when X starts. @@RXVT_NAME@@
562will consult the following files/resources in order, with later settings
563overwriting 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
573If compiled with internal Xresources support (i.e. \fB@@RXVT_NAME@@ \-h\fR
574lists \fB.Xdefaults\fR) then \fB@@RXVT_NAME@@\fR accepts application defaults
575set 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.
578Note that when reading X resources, \fB@@RXVT_NAME@@\fR recognizes two 569Note that when reading X resources, \fB@@RXVT_NAME@@\fR recognizes two class
579class names: \fBXTerm\fR and \fBURxvt\fR. The class name \fBRxvt\fR allows 570names: \fBRxvt\fR and \fBURxvt\fR. The class name \fBRxvt\fR allows resources
580resources common to both \fB@@RXVT_NAME@@\fR and the original \fIrxvt\fR to be 571common to both \fB@@RXVT_NAME@@\fR and the original \fIrxvt\fR to be easily
581easily configured, while the class name \fBURxvt\fR allows resources 572configured, while the class name \fBURxvt\fR allows resources unique to
582unique 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
583shared between different \fB@@RXVT_NAME@@\fR configurations. If no 574configurations. If no resources are specified, suitable defaults will
584resources are specified, suitable defaults will be used. Command-line 575be used. Command-line arguments can be used to override resource
585arguments can be used to override resource settings. The following 576settings. The following resources are supported (you might want to
586resources are allowed: 577check the @@RXVT_NAME@@\fIperl\fR\|(3) manpage for additional settings by perl
578extensions 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"
589Create the window with the specified X window geometry [default 80x24]; 581Create the window with the specified X window geometry [default 80x24];
590option \fB\-geometry\fR. 582option \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
1029can start or end with whitespace. 1021can start or end with whitespace.
1030.Sp 1022.Sp
1031Please note that you need to double the \f(CW\*(C`\e\*(C'\fR when using 1023Please 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 1024Xlib itself does it's own de-escaping (you can use \f(CW\*(C`\e033\*(C'\fR instead of
1033use \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). 1026processing).
1035.Sp 1027.Sp
1036You can define a range of keysyms in one shot by providing a \fIstring\fR 1028You can define a range of keysyms in one shot by providing a \fIstring\fR
1037with pattern \fBlist/PREFIX/MIDDLE/SUFFIX\fR, where the delimeter `/' 1029with pattern \fBlist/PREFIX/MIDDLE/SUFFIX\fR, where the delimeter `/'
1038should be a character not used by the strings. 1030should be a character not used by the strings.
1039.Sp 1031.Sp

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines