diff --git a/man4/console_codes.4 b/man4/console_codes.4 index 925dd7a78..8f95543a5 100644 --- a/man4/console_codes.4 +++ b/man4/console_codes.4 @@ -38,7 +38,7 @@ If the console is in UTF-8 mode, then the incoming bytes are first assembled into 16-bit Unicode codes. Otherwise each byte is transformed according to the current mapping table (which translates it to a Unicode value). -See the \fBCHARACTER SETS\fP section below for discussion. +See the \fBCharacter Sets\fP section below for discussion. .LP In the normal case, the Unicode value is converted to a font index, and this is stored in video memory, so that the corresponding glyph @@ -51,7 +51,7 @@ currently processing an escape sequence, the value will treated specially. Instead of being turned into a font index and rendered as a glyph, it may trigger cursor movement or other control functions. -See the \fBLINUX CONSOLE CONTROLS\fP section below for discussion. +See the \fBLinux Console Controls\fP section below for discussion. .LP It is generally not good practice to hard-wire terminal controls into programs. @@ -407,7 +407,8 @@ The bitmap that corresponds to s is found in the character ROM, and can be changed using .BR setfont (8). .SS "Mouse Tracking" -The mouse tracking facility is intended to return xterm-compatible +The mouse tracking facility is intended to return +.BR (1)xterm (1)-compatible mouse status reports. Because the console driver has no way to know the device or type of the mouse, these reports are returned in the @@ -419,7 +420,7 @@ user-mode application such as the daemon. .PP The mouse tracking escape sequences generated by -\fIxterm\fP encode numeric parameters in a single character as +\fBxterm\fP(1) encode numeric parameters in a single character as \fIvalue\fP+040. For example, \(aq!\(aq is 1. The screen coordinate system is 1-based. @@ -427,7 +428,7 @@ The screen coordinate system is 1-based. The X10 compatibility mode sends an escape sequence on button press encoding the location and the mouse button pressed. It is enabled by sending ESC [ ? 9 h and disabled with ESC [ ? 9 l. -On button press, \fIxterm\fP sends +On button press, \fBxterm\fP(1) sends ESC [ M \fIbxy\fP (6 characters). Here \fIb\fP is button\-1, and \fIx\fP and \fIy\fP are the x and y coordinates of the mouse @@ -439,7 +440,7 @@ sequence on both button press and release. Modifier information is also sent. It is enabled by sending ESC [ ? 1000 h and disabled with ESC [ 1000 l. -On button press or release, \fIxterm\fP sends ESC [ M +On button press or release, \fBxterm\fP(1) sends ESC [ M \fIbxy\fP. The low two bits of \fIb\fP encode button information: 0=MB1 pressed, 1=MB2 pressed, 2=MB3 pressed, 3=release. @@ -472,7 +473,7 @@ all codes except XOFF and XON. VT100-like DC1/DC3 processing may be enabled by the tty driver. .LP The -.I xterm +.BR xterm (1) program (in VT100 mode) recognizes the control characters BEL, BS, HT, LF, VT, FF, CR, SO, SI, ESC. .\" @@ -495,7 +496,7 @@ ESC + ... Designate G3 character set .TE .PP The program -.I xterm +.BR xterm (1) (in VT100 mode) recognizes ESC c, ESC # 8, ESC >, ESC =, ESC D, ESC E, ESC H, ESC M, ESC N, ESC O, ESC P ... ESC \, ESC Z (it answers ESC [ ? 1 ; 2 c, "I am a VT100 with @@ -505,14 +506,14 @@ It accepts ESC (, ESC ), ESC *, ESC + followed by 0, A, B for the DEC special character and line drawing set, UK, and US-ASCII, respectively. .PP -The user can configure \fIxterm\fP to respond to VT220-specific +The user can configure \fBxterm\fP(1) to respond to VT220-specific control sequences, and it will identify itself as a VT52, VT100, and up depending on the way it is configured and initialized. .PP It accepts ESC ] (OSC) for the setting of certain resources. In addition to the ECMA-48 string terminator (ST), -\fIxterm\fP accepts a BEL to terminate an OSC string. -These are a few of the OSC control sequences recognized by \fIxterm\fP: +\fBxterm\fP(1) accepts a BEL to terminate an OSC string. +These are a few of the OSC control sequences recognized by \fBxterm\fP(1): .TS l l. ESC ] 0 ; \fItxt\fP ST Set icon name and window title to \fItxt\fP. @@ -537,7 +538,7 @@ It also recognizes .TS l l l. ESC F Cursor to lower left corner of screen (if enabled by - \fIxterm\fP's \fBhpLowerleftBugCompat\fP resource) + \fBxterm\fP(1)'s \fBhpLowerleftBugCompat\fP resource) ESC l Memory lock (per HP terminals). Locks memory above the cursor. ESC m Memory unlock (per HP terminals). @@ -554,7 +555,7 @@ implementation than Linux console. .PP .B CSI Sequences .sp -Old versions of \fIxterm\fP, for example, from X11R5, +Old versions of \fBxterm\fP(1), for example, from X11R5, interpret the blink SGR as a bold SGR. Later versions which implemented ANSI colors, for example, XFree86 3.1.2A in 1995, improved this by allowing @@ -565,13 +566,13 @@ Stock X11R6 versions did not recognize the color-setting SGRs until the X11R6.8 release, which incorporated XFree86 xterm. All ECMA-48 CSI sequences recognized by Linux are also recognized by .IR xterm , -however \fIxterm\fP implements several ECMA-48 and DEC control sequences +however \fBxterm\fP(1) implements several ECMA-48 and DEC control sequences not recognized by Linux. .PP -The \fIxterm\fP +The \fBxterm\fP(1) program recognizes all of the DEC Private Mode sequences listed above, but none of the Linux private-mode sequences. -For discussion of \fIxterm\fP's +For discussion of \fBxterm\fP(1)'s own private-mode sequences, refer to the \fIXterm Control Sequences\fP document by @@ -595,7 +596,7 @@ http://invisible-island.net/vttest/ .in .PP demonstrates many of these control sequences. -The \fIxterm\fP source distribution also contains sample +The \fBxterm\fP(1) source distribution also contains sample scripts which exercise other features. .SH NOTES ESC 8 (DECRC) is not able to restore the character set changed with @@ -618,15 +619,15 @@ for private mode control sequences. In particular, those ending with ] do not use a standard terminating character. The OSC (set palette) sequence is a greater problem, -since \fIxterm\fP may interpret this as a control sequence +since \fBxterm\fP(1) may interpret this as a control sequence which requires a string terminator (ST). -Unlike the \fIsetterm\fP sequences which will be ignored (since +Unlike the \fBsetterm\fP(1) sequences which will be ignored (since they are invalid control sequences), the palette sequence will make -\fIxterm\fP appear to hang (though pressing the return-key +\fBxterm\fP(1) appear to hang (though pressing the return-key will fix that). To accommodate applications which have been hardcoded to use Linux control sequences, -set the \fIxterm\fP resource \fBbrokenLinuxOSC\fP to true. +set the \fBxterm\fP(1) resource \fBbrokenLinuxOSC\fP to true. .PP An older version of this document implied that Linux recognizes the ECMA-48 control sequence for invisible text.