~ubuntu-branches/ubuntu/precise/xterm/precise-updates

« back to all changes in this revision

Viewing changes to xterm.man

  • Committer: Bazaar Package Importer
  • Author(s): Lorenzo De Liso
  • Date: 2011-02-12 15:58:09 UTC
  • mfrom: (1.5.3 upstream)
  • mto: This revision was merged to the branch mainline in revision 33.
  • Revision ID: james.westby@ubuntu.com-20110212155809-vxve6aexyvm7aoh3
Tags: upstream-268
ImportĀ upstreamĀ versionĀ 268

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
'\" t
2
 
.\" $XTermId: xterm.man,v 1.469 2010/11/11 11:57:07 tom Exp $
 
2
.\" $XTermId: xterm.man,v 1.476 2011/02/08 21:46:33 tom Exp $
3
3
.\"
4
 
.\" Copyright 1996-2009,2010 by Thomas E. Dickey
 
4
.\" Copyright 1996-2010,2011 by Thomas E. Dickey
5
5
.\"
6
6
.\"                         All Rights Reserved
7
7
.\"
55
55
.\" from The Open Group.
56
56
.\"
57
57
.\" updated by Thomas E. Dickey for XFree86, July 1996 - February 2006.
58
 
.
 
58
.\"
 
59
.\" Bulleted paragraph
 
60
.de bP
 
61
.IP \(bu 4
 
62
..
59
63
.\" these would be fallbacks for DS/DE,
60
64
.\" but groff changed the meaning of the macros.
61
65
.de NS
3121
3125
Specifies whether or not reverse video should be simulated.
3122
3126
The default is
3123
3127
\*(``false.\*(''
 
3128
.IP
 
3129
There are several aspects to reverse video in \fIxterm\fP:
 
3130
.RS
 
3131
.bP
 
3132
The command-line \fB\-rv\fP option tells the X libraries to reverse
 
3133
the foreground and background colors.
 
3134
\fIXterm\fP's command-line options set resource values.
 
3135
In particular, the X Toolkit sets the \fBreverseVideo\fP resource
 
3136
when the \fB\-rv\fP option is used.
 
3137
.bP
 
3138
If the user has also used command-line options \fB\-fg\fP or \fB\-bg\fP 
 
3139
to set the foreground and background colors,
 
3140
\fIxterm\fP does not see these options directly.
 
3141
Instead,
 
3142
it examines the resource values to reconstruct the command-line options,
 
3143
and determine which of the colors is the user's intended foreground, etc.
 
3144
Their actual values are irrelevant to the reverse video function;
 
3145
some users prefer the X defaults (black text on a white background),
 
3146
others prefer white text on a black background.
 
3147
.bP
 
3148
After startup,
 
3149
the user can toggle the "Enable Reverse Video" menu entry.
 
3150
This exchanges the current foreground and background colors
 
3151
of the VT100 widget,
 
3152
and repaints the screen.
 
3153
Because of the X resource hierarchy,
 
3154
the \fBreverseVideo\fP resource applies to more than the VT100 widget.
 
3155
.RE
 
3156
.IP
 
3157
Programs running in an \fIxterm\fP can also use control sequences
 
3158
to enable the VT100 reverse video mode.
 
3159
These are independent of the \fIreverseVideo\fP resource and the menu entry.
 
3160
\fIXterm\fP exchanges the current foreground and background colors
 
3161
when drawing text affected by these control sequences.
 
3162
.IP
 
3163
Other control sequences can alter the foreground and background colors
 
3164
which are used:
 
3165
.RS
 
3166
.bP
 
3167
Programs can also use the ANSI color control sequences to set the
 
3168
foreground and background colors.
 
3169
.bP
 
3170
Extensions to the ANSI color controls (such as 16-, 88- or 256-colors)
 
3171
are treated similarly to the ANSI control.
 
3172
.bP
 
3173
Using other control sequences (the "\fIdynamic colors\fR" feature),
 
3174
a program can change the foreground and background colors.
 
3175
.RE
3124
3176
.TP 8
3125
3177
.B "reverseWrap (\fPclass\fB ReverseWrap)"
3126
3178
Specifies whether or not reverse-wraparound should be enabled.
3363
3415
which assume the string is UTF-8.
3364
3416
.IP
3365
3417
However, some users may wish to write a title string encoded in UTF-8.
 
3418
The window manager is responsible for drawing window titles.
 
3419
Some window managers (not all) support UTF-8 encoding of window titles.
3366
3420
Set this resource to \*(``true\*('' to allow UTF-8 encoded title strings.
3367
3421
That cancels the translation to UTF-8,
3368
3422
allowing UTF-8 strings to be displayed as is.
4782
4836
^X ESC G <line+\*(`` \*(''> <col+\*(`` \*(''>
4783
4837
.in -8
4784
4838
.TP 8
 
4839
.B "fullscreen()"
 
4840
Asks the window manager to change the window to full-screen.
 
4841
.TP 8
4785
4842
.B "iconify()"
4786
4843
Iconifies the window.
4787
4844
.TP 8
5310
5367
         Shift <KeyPress> Select:select-cursor-start() \\\&
5311
5368
                                 select-cursor-end(SELECT, CUT_BUFFER0) \\n\\\&
5312
5369
         Shift <KeyPress> Insert:insert-selection(SELECT, CUT_BUFFER0) \\n\\\&
 
5370
                 Alt <Key>Return:fullscreen()\n\
5313
5371
        <KeyRelease> Scroll_Lock:scroll-lock() \\n\\\&
5314
5372
    Shift~Ctrl <KeyPress> KP_Add:larger-vt-font() \\n\\\&
5315
5373
    Shift Ctrl <KeyPress> KP_Add:smaller-vt-font() \\n\\\&