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

« back to all changes in this revision

Viewing changes to xterm.man

• browse files at revision 1.5.3
• compare with another revision
• download diff
• download tarball
• view history from revision 1.5.3

Show diffs side-by-side

added

removed

xterm.man

1

1

'\" t

2

 

.\" $XTermId: xterm.man,v 1.467 2010/10/11 00:36:08 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

1075

1079

used for the pseudo-terminal name from the file descriptor.

1076

1080

Otherwise, exactly two characters are used from the option for

1077

1081

the pseudo-terminal name, the remainder is the file descriptor.

1078

 

Examples:

 

1082

Examples

 

1083

(the first two are equivalent

 

1084

since the descriptor follows the last \*(``/\*(''):

 

1085

.sp

1079

1086

.nf

1080

1087

.RS 15

 

1088

-S/dev/pts/123/45

1081

1089

-S123/45

1082

1090

-Sab34

1083

1091

.RE

3117

3125

Specifies whether or not reverse video should be simulated.

3118

3126

The default is

3119

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

3120

3176

.TP 8

3121

3177

.B "reverseWrap (\fPclass\fB ReverseWrap)"

3122

3178

Specifies whether or not reverse-wraparound should be enabled.

3359

3415

which assume the string is UTF-8.

3360

3416

.IP

3361

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.

3362

3420

Set this resource to \*(``true\*('' to allow UTF-8 encoded title strings.

3363

3421

That cancels the translation to UTF-8,

3364

3422

allowing UTF-8 strings to be displayed as is.

4731

4789

It is also invoked from the \fBclearsavedlines\fP entry in \fIvtMenu\fP.

4732

4790

The effect is identical to a hardware reset (RIS) control sequence.

4733

4791

.TP 8

 

4792

.B "copy-selection(\fIdestname\fP [, ...])"

 

4793

This action puts the currently selected text into all of the selections or

 

4794

cutbuffers specified by \fIdestname\fP.

 

4795

Unlike \fBselect-end\fP, it does not send a mouse position or otherwise

 

4796

modify the internal selection state.

 

4797

.TP 8

4734

4798

.B "create-menu(\fIm/v/f/t\fP)"

4735

4799

This action creates one of the menus used by \fIxterm\fP,

4736

4800

if it has not been previously created.

4772

4836

^X ESC G <line+\*(`` \*(''> <col+\*(`` \*(''>

4773

4837

.in -8

4774

4838

.TP 8

 

4839

.B "fullscreen()"

 

4840

Asks the window manager to change the window to full-screen.

 

4841

.TP 8

4775

4842

.B "iconify()"

4776

4843

Iconifies the window.

4777

4844

.TP 8

4974

5041

.B "select-end(\fIdestname\fP [, ...])"

4975

5042

This action puts the currently selected text into all of the selections or

4976

5043

cutbuffers specified by \fIdestname\fP.

 

5044

It also sends a mouse position and updates the internal selection state

 

5045

to reflect the end of the selection process.

4977

5046

.TP 8

4978

5047

.B "select-extend()"

4979

5048

This action tracks the pointer and extends the selection.

5298

5367

         Shift <KeyPress> Select:select-cursor-start() \\\&

5299

5368

                                 select-cursor-end(SELECT, CUT_BUFFER0) \\n\\\&

5300

5369

         Shift <KeyPress> Insert:insert-selection(SELECT, CUT_BUFFER0) \\n\\\&

 

5370

                 Alt <Key>Return:fullscreen()\n\

5301

5371

        <KeyRelease> Scroll_Lock:scroll-lock() \\n\\\&

5302

5372

    Shift~Ctrl <KeyPress> KP_Add:larger-vt-font() \\n\\\&

5303

5373

    Shift Ctrl <KeyPress> KP_Add:smaller-vt-font() \\n\\\&

• Older »

Loggerhead is a web-based interface for Breezy
Version: 2.0.1