From 9ca13180d5a653d6882ee2e0d02aa122f0675090 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Thu, 6 Aug 2020 22:22:39 +0200 Subject: [PATCH] pldd.1, bpf.2, execve.2, futex.2, ioctl_fat.2, ioctl_tty.2, keyctl.2, signalfd.2, timerfd_create.2, __ppc_get_timebase.3, a64l.3, frexp.3, pthread_setname_np.3, regex.3, rpmatch.3, scanf.3, strfmon.3, strftime.3, termios.3, console_codes.4, vcs.4, veth.4, core.5, dir_colors.5, termcap.5, ascii.7, charsets.7, glob.7, man-pages.7, operator.7, regex.7, user_namespaces.7, zic.8: Use "\(ha" rather than "^" in code This renders better in PDF. Reported-by: Geoff Clare Signed-off-by: Michael Kerrisk --- man1/pldd.1 | 2 +- man2/bpf.2 | 2 +- man2/execve.2 | 2 +- man2/futex.2 | 2 +- man2/ioctl_fat.2 | 2 +- man2/ioctl_tty.2 | 6 +++--- man2/keyctl.2 | 2 +- man2/signalfd.2 | 6 +++--- man2/timerfd_create.2 | 4 ++-- man3/__ppc_get_timebase.3 | 2 +- man3/a64l.3 | 2 +- man3/frexp.3 | 6 +++--- man3/pthread_setname_np.3 | 2 +- man3/regex.3 | 4 ++-- man3/rpmatch.3 | 8 ++++---- man3/scanf.3 | 4 ++-- man3/strfmon.3 | 4 ++-- man3/strftime.3 | 2 +- man3/termios.3 | 4 ++-- man4/console_codes.4 | 36 ++++++++++++++++++------------------ man4/vcs.4 | 2 +- man4/veth.4 | 2 +- man5/core.5 | 2 +- man5/dir_colors.5 | 4 ++-- man5/termcap.5 | 12 ++++++------ man7/ascii.7 | 6 +++--- man7/charsets.7 | 4 ++-- man7/glob.7 | 4 ++-- man7/man-pages.7 | 2 +- man7/operator.7 | 4 ++-- man7/regex.7 | 20 ++++++++++---------- man7/user_namespaces.7 | 4 ++-- man8/zic.8 | 2 +- 33 files changed, 85 insertions(+), 85 deletions(-) diff --git a/man1/pldd.1 b/man1/pldd.1 index ea65b24b6..a01059e8b 100644 --- a/man1/pldd.1 +++ b/man1/pldd.1 @@ -93,7 +93,7 @@ using a command such as the following .in +4n .EX $ \fBgdb \-ex "set confirm off" \-ex "set height 0" \-ex "info shared" \e\fP - \fB\-ex "quit" \-p $pid | grep '^0x.*0x'\fP + \fB\-ex "quit" \-p $pid | grep '\(ha0x.*0x'\fP .EE .in .SH BUGS diff --git a/man2/bpf.2 b/man2/bpf.2 index a3d59e6ac..b45acde76 100644 --- a/man2/bpf.2 +++ b/man2/bpf.2 @@ -121,7 +121,7 @@ eBPF programs can access the same map: .EX tracing tracing tracing packet packet packet event A event B event C on eth0 on eth1 on eth2 - | | | | | ^ + | | | | | \(ha | | | | v | --> tracing <-- tracing socket tc ingress tc egress prog_1 prog_2 prog_3 classifier action diff --git a/man2/execve.2 b/man2/execve.2 index 7a8a13414..f7794c7e5 100644 --- a/man2/execve.2 +++ b/man2/execve.2 @@ -858,7 +858,7 @@ program: .EX .RB "$" " cat > script" .B #!./myecho script\-arg -.B ^D +.B \(haD .RB "$" " chmod +x script" .EE .in diff --git a/man2/futex.2 b/man2/futex.2 index d4646a853..05696f617 100644 --- a/man2/futex.2 +++ b/man2/futex.2 @@ -663,7 +663,7 @@ FUTEX_OP_SET 0 /* uaddr2 = oparg; */ FUTEX_OP_ADD 1 /* uaddr2 += oparg; */ FUTEX_OP_OR 2 /* uaddr2 |= oparg; */ FUTEX_OP_ANDN 3 /* uaddr2 &= \(tioparg; */ -FUTEX_OP_XOR 4 /* uaddr2 ^= oparg; */ +FUTEX_OP_XOR 4 /* uaddr2 \(ha= oparg; */ .EE .in .IP diff --git a/man2/ioctl_fat.2 b/man2/ioctl_fat.2 index ba4a8ff6a..c6b0d49e2 100644 --- a/man2/ioctl_fat.2 +++ b/man2/ioctl_fat.2 @@ -325,7 +325,7 @@ main(int argc, char *argv[]) * Invert archive attribute. */ printf("Toggling archive flag\en"); - attr ^= ATTR_ARCH; + attr \(ha= ATTR_ARCH; /* * Write the changed FAT file attributes. diff --git a/man2/ioctl_tty.2 b/man2/ioctl_tty.2 index 64bce3d82..a845bba3b 100644 --- a/man2/ioctl_tty.2 +++ b/man2/ioctl_tty.2 @@ -340,8 +340,8 @@ TIOCPKT_FLUSHREAD The read queue for the terminal is flushed. TIOCPKT_FLUSHWRITE The write queue for the terminal is flushed. TIOCPKT_STOP Output to the terminal is stopped. TIOCPKT_START Output to the terminal is restarted. -TIOCPKT_DOSTOP The start and stop characters are \fB^S\fP/\fB^Q\fP. -TIOCPKT_NOSTOP The start and stop characters are not \fB^S\fP/\fB^Q\fP. +TIOCPKT_DOSTOP The start and stop characters are \fB\(haS\fP/\fB\(haQ\fP. +TIOCPKT_NOSTOP The start and stop characters are not \fB\(haS\fP/\fB\(haQ\fP. .fi .IP While packet mode is in use, the presence @@ -359,7 +359,7 @@ This mode is used by and .BR rlogind (8) to implement a remote-echoed, -locally \fB^S\fP/\fB^Q\fP flow-controlled remote login. +locally \fB\(haS\fP/\fB\(haQ\fP flow-controlled remote login. .TP .BI "TIOCGPKT const int *" argp (since Linux 3.8) diff --git a/man2/keyctl.2 b/man2/keyctl.2 index ea954d7fa..e5d23afbe 100644 --- a/man2/keyctl.2 +++ b/man2/keyctl.2 @@ -1445,7 +1445,7 @@ permission. The payloads of these keys are used to calculate the Diffie-Hellman result as: .IP - base ^ private mod prime + base \(ha private mod prime .IP If the base is the shared generator, the result is the local public key. If the base is the remote public key, the result is the shared secret. diff --git a/man2/signalfd.2 b/man2/signalfd.2 index 024134093..96d502a50 100644 --- a/man2/signalfd.2 +++ b/man2/signalfd.2 @@ -458,11 +458,11 @@ The following shell session demonstrates the use of the program: .in +4n .EX .RB "$" " ./signalfd_demo" -.BR "^C" " # Control\-C generates SIGINT" +.BR "\(haC" " # Control\-C generates SIGINT" Got SIGINT -.B ^C +.B \(haC Got SIGINT -\fB^\e\fP # Control\-\e generates SIGQUIT +\fB\(ha\e\fP # Control\-\e generates SIGQUIT Got SIGQUIT $ .EE diff --git a/man2/timerfd_create.2 b/man2/timerfd_create.2 index cf8f3f5b3..ecac3da51 100644 --- a/man2/timerfd_create.2 +++ b/man2/timerfd_create.2 @@ -570,14 +570,14 @@ The following shell session demonstrates the use of the program: 0.000: timer started 3.000: read: 1; total=1 4.000: read: 1; total=2 -.BR "^Z " " # type control-Z to suspend the program" +.BR "\(haZ " " # type control-Z to suspend the program" [1]+ Stopped ./timerfd3_demo 3 1 100 .RB "$ " "fg" " # Resume execution after a few seconds" a.out 3 1 100 9.660: read: 5; total=7 10.000: read: 1; total=8 11.000: read: 1; total=9 -.BR "^C " " # type control-C to suspend the program" +.BR "\(haC " " # type control-C to suspend the program" .EE .in .SS Program source diff --git a/man3/__ppc_get_timebase.3 b/man3/__ppc_get_timebase.3 index 44f852a12..c229117b8 100644 --- a/man3/__ppc_get_timebase.3 +++ b/man3/__ppc_get_timebase.3 @@ -76,7 +76,7 @@ between two calls to #include #include -/* Maximum value of the Time Base Register: 2^60 \- 1. +/* Maximum value of the Time Base Register: 2\(ha60 \- 1. Source: POWER ISA. */ #define MAX_TB 0xFFFFFFFFFFFFFFF diff --git a/man3/a64l.3 b/man3/a64l.3 index 7e937a033..f1898a591 100644 --- a/man3/a64l.3 +++ b/man3/a64l.3 @@ -61,7 +61,7 @@ a-z represent 38-63 .fi .RE .PP -So 123 = 59*64^0 + 1*64^1 = "v/". +So 123 = 59*64\(ha0 + 1*64\(ha1 = "v/". .SH ATTRIBUTES For an explanation of the terms used in this section, see .BR attributes (7). diff --git a/man3/frexp.3 b/man3/frexp.3 index 918ea1478..2bd23e950 100644 --- a/man3/frexp.3 +++ b/man3/frexp.3 @@ -124,9 +124,9 @@ The program below produces results such as the following: .in +4n .EX .RB "$" " ./a.out 2560" -frexp(2560, &e) = 0.625: 0.625 * 2^12 = 2560 +frexp(2560, &e) = 0.625: 0.625 * 2\(ha12 = 2560 .RB "$" " ./a.out \-4" -frexp(\-4, &e) = \-0.5: \-0.5 * 2^3 = \-4 +frexp(\-4, &e) = \-0.5: \-0.5 * 2\(ha3 = \-4 .EE .in .SS Program source @@ -146,7 +146,7 @@ main(int argc, char *argv[]) x = strtod(argv[1], NULL); r = frexp(x, &exp); - printf("frexp(%g, &e) = %g: %g * %d^%d = %g\en", + printf("frexp(%g, &e) = %g: %g * %d\(ha%d = %g\en", x, r, r, FLT_RADIX, exp, x); exit(EXIT_SUCCESS); } diff --git a/man3/pthread_setname_np.3 b/man3/pthread_setname_np.3 index 8dc090a7b..b206f66c0 100644 --- a/man3/pthread_setname_np.3 +++ b/man3/pthread_setname_np.3 @@ -139,7 +139,7 @@ The following shell session shows a sample run of the program: .RB "$" " ./a.out" Created a thread. Default name is: a.out The thread name after setting it is THREADFOO. -\fB^Z\fP # Suspend the program +\fB\(haZ\fP # Suspend the program [1]+ Stopped ./a.out .RB "$ " "ps H \-C a.out \-o 'pid tid cmd comm'" PID TID CMD COMMAND diff --git a/man3/regex.3 b/man3/regex.3 index 54bb5ce60..f8d0e64b6 100644 --- a/man3/regex.3 +++ b/man3/regex.3 @@ -104,11 +104,11 @@ are ignored if the pattern buffer supplied was compiled with this flag set. Match-any-character operators don't match a newline. .IP A nonmatching list -.RB ( [^...] ) +.RB ( [\(ha...] ) not containing a newline does not match a newline. .IP Match-beginning-of-line operator -.RB ( ^ ) +.RB ( \(ha ) matches the empty string immediately after a newline, regardless of whether .IR eflags , diff --git a/man3/rpmatch.3 b/man3/rpmatch.3 index 338450432..deaaaa3c4 100644 --- a/man3/rpmatch.3 +++ b/man3/rpmatch.3 @@ -69,9 +69,9 @@ if the program has called to effect their changes. .PP Regardless of the locale, responses matching -.B ^[Yy] +.B \(ha[Yy] are always accepted as affirmative, and those matching -.B ^[Nn] +.B \(ha[Nn] are always accepted as negative. .SH RETURN VALUE After examining @@ -129,9 +129,9 @@ It would be preferable to accept input strings much more strictly, for example (using the extended regular expression notation described in .BR regex (7)): -.B ^([yY]|yes|YES)$ +.B \(ha([yY]|yes|YES)$ and -.BR ^([nN]|no|NO)$ . +.BR \(ha([nN]|no|NO)$ . .SH EXAMPLES The following program displays the results when .BR rpmatch () diff --git a/man3/scanf.3 b/man3/scanf.3 index 02f5a74ba..479c881e3 100644 --- a/man3/scanf.3 +++ b/man3/scanf.3 @@ -496,7 +496,7 @@ The set .I excludes those characters if the first character after the open bracket is a circumflex -.RB ( ^ ). +.RB ( \(ha ). To include a close bracket in the set, make it the first character after the open bracket or the circumflex; any other position will end the set. The hyphen character @@ -506,7 +506,7 @@ intervening characters to the set. To include a hyphen, make it the last character before the final close bracket. For instance, -.B [^]0\-9\-] +.B [\(ha]0\-9\-] means the set "everything except close bracket, zero through nine, and hyphen". The string ends with the appearance of a character not in the (or, with a diff --git a/man3/strfmon.3 b/man3/strfmon.3 index ae566831c..6af4d0db0 100644 --- a/man3/strfmon.3 +++ b/man3/strfmon.3 @@ -79,7 +79,7 @@ is used as the numeric fill character (to be used with a left precision, see below). When not specified, the space character is used. .TP -.B ^ +.B \(ha Do not use any grouping characters that might be defined for the current locale. By default, grouping is enabled. @@ -179,7 +179,7 @@ The call .PP .in +4n .EX -strfmon(buf, sizeof(buf), "[%^=*#6n] [%=*#6i]", +strfmon(buf, sizeof(buf), "[%\(ha=*#6n] [%=*#6i]", 1234.567, 1234.567); .EE .in diff --git a/man3/strftime.3 b/man3/strftime.3 index 6ffda9486..d5592e2a5 100644 --- a/man3/strftime.3 +++ b/man3/strftime.3 @@ -618,7 +618,7 @@ Do not pad a numeric result string. Pad a numeric result string with zeros even if the conversion specifier character uses space-padding by default. .TP -.B ^ +.B \(ha Convert alphabetic characters in result string to uppercase. .TP .B # diff --git a/man3/termios.3 b/man3/termios.3 index 9dc2d2c00..f89a30083 100644 --- a/man3/termios.3 +++ b/man3/termios.3 @@ -417,11 +417,11 @@ If \fBICANON\fP is also set, echo the NL character even if ECHO is not set. .B ECHOCTL (not in POSIX) If \fBECHO\fP is also set, terminal special characters other than -TAB, NL, START, and STOP are echoed as \fB^X\fP, +TAB, NL, START, and STOP are echoed as \fB\(haX\fP, where X is the character with ASCII code 0x40 greater than the special character. For example, character -0x08 (BS) is echoed as \fB^H\fP. +0x08 (BS) is echoed as \fB\(haH\fP. [requires .B _BSD_SOURCE or diff --git a/man4/console_codes.4 b/man4/console_codes.4 index 97d1a430e..2e3e07844 100644 --- a/man4/console_codes.4 +++ b/man4/console_codes.4 @@ -92,27 +92,27 @@ The recognized control characters are BEL, BS, HT, LF, VT, FF, CR, SO, SI, CAN, SUB, ESC, DEL, CSI. They do what one would expect: .HP -BEL (0x07, \fB^G\fP) beeps; +BEL (0x07, \fB\(haG\fP) beeps; .HP -BS (0x08, \fB^H\fP) backspaces one column +BS (0x08, \fB\(haH\fP) backspaces one column (but not past the beginning of the line); .HP -HT (0x09, \fB^I\fP) goes to the next tab stop or to the end of the line +HT (0x09, \fB\(haI\fP) goes to the next tab stop or to the end of the line if there is no earlier tab stop; .HP -LF (0x0A, \fB^J\fP), VT (0x0B, \fB^K\fP) and -FF (0x0C, \fB^L\fP) all give a linefeed, +LF (0x0A, \fB\(haJ\fP), VT (0x0B, \fB\(haK\fP) and +FF (0x0C, \fB\(haL\fP) all give a linefeed, and if LF/NL (new-line mode) is set also a carriage return; .HP -CR (0x0D, \fB^M\fP) gives a carriage return; +CR (0x0D, \fB\(haM\fP) gives a carriage return; .HP -SO (0x0E, \fB^N\fP) activates the G1 character set; +SO (0x0E, \fB\(haN\fP) activates the G1 character set; .HP -SI (0x0F, \fB^O\fP) activates the G0 character set; +SI (0x0F, \fB\(haO\fP) activates the G0 character set; .HP -CAN (0x18, \fB^X\fP) and SUB (0x1A, \fB^Z\fP) abort escape sequences; +CAN (0x18, \fB\(haX\fP) and SUB (0x1A, \fB\(haZ\fP) abort escape sequences; .HP -ESC (0x1B, \fB^[\fP) starts an escape sequence; +ESC (0x1B, \fB\(ha[\fP) starts an escape sequence; .HP DEL (0x7F) is ignored; .HP @@ -415,8 +415,8 @@ b) VT100 graphics \-> PC, c) PC \-> PC, d) user-defined. There are two character sets, called G0 and G1, and one of them is the current character set. (Initially G0.) -Typing \fB^N\fP causes G1 to become current, -\fB^O\fP causes G0 to become current. +Typing \fB\(haN\fP causes G1 to become current, +\fB\(haO\fP causes G0 to become current. .PP These variables G0 and G1 point at a translation table, and can be changed by the user. @@ -428,11 +428,11 @@ point at translation table a), b), c) and d), respectively. .PP The sequence ESC c causes a terminal reset, which is what you want if the screen is all garbled. -The oft-advised "echo ^V^O" will make only G0 current, +The oft-advised "echo \(haV\(haO" will make only G0 current, but there is no guarantee that G0 points at table a). In some distributions there is a program .BR reset (1) -that just does "echo ^[c". +that just does "echo \(ha[c". If your terminfo entry for the console is correct (and has an entry rs1=\eEc), then "tput reset" will also work. .PP @@ -502,9 +502,9 @@ NUL (0x00) was ignored; .HP ENQ (0x05) triggered an answerback message; .HP -DC1 (0x11, \fB^Q\fP, XON) resumed transmission; +DC1 (0x11, \fB\(haQ\fP, XON) resumed transmission; .HP -DC3 (0x13, \fB^S\fP, XOFF) caused VT100 to ignore (and stop transmitting) +DC3 (0x13, \fB\(haS\fP, XOFF) caused VT100 to ignore (and stop transmitting) all codes except XOFF and XON. .PP VT100-like DC1/DC3 processing may be enabled by the terminal driver. @@ -526,7 +526,7 @@ ESC O SS3 Single shift 3. (Select G3 character set for the next character only.) ESC P DCS Device control string (ended by ESC \e) ESC X SOS Start of string. -ESC ^ PM Privacy message (ended by ESC \e) +ESC \(ha PM Privacy message (ended by ESC \e) ESC \e ST String terminator ESC * ... Designate G2 character set ESC + ... Designate G3 character set @@ -538,7 +538,7 @@ The program ESC D, ESC E, ESC H, ESC M, ESC N, ESC O, ESC P ... ESC \e, ESC Z (it answers ESC [ ? 1 ; 2 c, "I am a VT100 with advanced video option") -and ESC ^ ... ESC \e with the same meanings as indicated above. +and ESC \(ha ... ESC \e with the same meanings as indicated above. 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. diff --git a/man4/vcs.4 b/man4/vcs.4 index f8a43d68f..6a67eb413 100644 --- a/man4/vcs.4 +++ b/man4/vcs.4 @@ -178,7 +178,7 @@ main(void) ch |= 0x100; attrib = ((s & \(timask) >> 8); printf("ch=0x%03x attrib=0x%02x\en", ch, attrib); - s ^= 0x1000; + s \(ha= 0x1000; (void) lseek(fd, \-2, SEEK_CUR); (void) write(fd, &s, 2); exit(EXIT_SUCCESS); diff --git a/man4/veth.4 b/man4/veth.4 index a726c8672..0f77de53a 100644 --- a/man4/veth.4 +++ b/man4/veth.4 @@ -94,7 +94,7 @@ network interface, using commands something like: # \fBethtool \-S ve_A\fP # Discover interface index of peer NIC statistics: peer_ifindex: 16 -# \fBip link | grep '^16:'\fP # Look up interface +# \fBip link | grep '\(ha16:'\fP # Look up interface 16: ve_B@ve_A: mtu 1500 qdisc ... .EE .in diff --git a/man5/core.5 b/man5/core.5 index 7824a3340..fb0dc2219 100644 --- a/man5/core.5 +++ b/man5/core.5 @@ -624,7 +624,7 @@ UID=%u GID=%g sig=%s\(dq > \e" .B " /proc/sys/kernel/core_pattern" .RB "#" " exit" .RB "$" " sleep 100" -.BR "^\e" " # type control-backslash" +.BR "\(ha\e" " # type control-backslash" Quit (core dumped) .RB "$" " cat core.info" argc=5 diff --git a/man5/dir_colors.5 b/man5/dir_colors.5 index 5dc566dfc..11e77b92b 100644 --- a/man5/dir_colors.5 +++ b/man5/dir_colors.5 @@ -347,7 +347,7 @@ can, however, be specified, which would have the same effect. To specify control- or blank characters in the color sequences or filename extensions, either C-style \e-escaped notation or .BR stty \-style -^-notation can be used. +\(ha-notation can be used. The C-style notation includes the following characters: .RS @@ -366,7 +366,7 @@ lb l. \ex\fInnn Any character (hexadecimal notation) \e_ Space \e\e Backslash (\e) -\e^ Caret (^) +\e\(ha Caret (\(ha) \e# Hash mark (#) .TE .RE diff --git a/man5/termcap.5 b/man5/termcap.5 index 9ec1fe982..f3de98382 100644 --- a/man5/termcap.5 +++ b/man5/termcap.5 @@ -117,7 +117,7 @@ NR ti does not reverse te nx No padding, must use XON/XOFF os Terminal can overstrike ul Terminal underlines although it can not overstrike -xb Beehive glitch, f1 sends ESCAPE, f2 sends \fB^C\fP +xb Beehive glitch, f1 sends ESCAPE, f2 sends \fB\(haC\fP xn Newline/wraparound glitch xo Terminal uses xon/xoff protocol xs Text typed over standout text will be displayed in standout @@ -209,7 +209,7 @@ AL Insert %1 lines ac Pairs of block graphic characters to map alternate character set ae End alternative character set as Start alternative character set for block graphic characters -bc Backspace, if not \fB^H\fP +bc Backspace, if not \fB\(haH\fP bl Audio bell bt Move to previous tab stop cb Clear from beginning of line to cursor @@ -375,15 +375,15 @@ ve Normal cursor visible vi Cursor invisible vs Standout cursor wi Set window from line %1 to %2 and column %3 to %4 -XF XOFF character if not \fB^S\fP +XF XOFF character if not \fB\(haS\fP .fi .PP There are several ways of defining the control codes for string capabilities: .PP Every normal character represents itself, -except \(aq^\(aq, \(aq\e\(aq, and \(aq%\(aq. +except \(aq\(ha\(aq, \(aq\e\(aq, and \(aq%\(aq. .PP -A \fB^x\fP means Control-x. +A \fB\(hax\fP means Control-x. Control-A equals 1 decimal. .PP \ex means a special code. @@ -443,7 +443,7 @@ The following names are available: \&. down arrow (v) 0 full square (#) I lantern (#) -- upper arrow (^) +- upper arrow (\(ha) \&' rhombus (+) a chess board (:) f degree (') diff --git a/man7/ascii.7 b/man7/ascii.7 index ff3cd3270..f1c0c8d74 100644 --- a/man7/ascii.7 +++ b/man7/ascii.7 @@ -81,7 +81,7 @@ _ 033 27 1B ESC (escape) 133 91 5B [ 034 28 1C FS (file separator) 134 92 5C \e \(aq\e\e\(aq 035 29 1D GS (group separator) 135 93 5D ] -036 30 1E RS (record separator) 136 94 5E ^ +036 30 1E RS (record separator) 136 94 5E \(ha 037 31 1F US (unit separator) 137 95 5F \&_ 040 32 20 SPACE 140 96 60 \` 041 33 21 ! 141 97 61 a @@ -134,7 +134,7 @@ For convenience, below are more compact tables in hex and decimal. 1: ! 1 A Q a q 1: ) 3 = G Q [ e o y 2: " 2 B R b r 2: * 4 > H R \e f p z 3: # 3 C S c s 3: ! + 5 ? I S ] g q { -4: $ 4 D T d t 4: " , 6 @ J T ^ h r | +4: $ 4 D T d t 4: " , 6 @ J T \(ha h r | 5: % 5 E U e u 5: # \- 7 A K U _ i s } 6: & 6 F V f v 6: $ . 8 B L V \` j t \(ti 7: \(aq 7 G W g w 7: % / 9 C M W a k u DEL @@ -144,7 +144,7 @@ A: * : J Z j z B: + ; K [ k { C: , < L \e l | D: \- = M ] m } -E: . > N ^ n \(ti +E: . > N \(ha n \(ti F: / ? O _ o DEL .if t \{\ .in diff --git a/man7/charsets.7 b/man7/charsets.7 index 6e19357bf..ceb5154ef 100644 --- a/man7/charsets.7 +++ b/man7/charsets.7 @@ -216,7 +216,7 @@ It uses codes either G0 always has size 94 and uses codes 041\(en0176. .PP Switching between character sets is done using the shift functions -\fB^N\fP (SO or LS1), \fB^O\fP (SI or LS0), ESC n (LS2), ESC o (LS3), +\fB\(haN\fP (SO or LS1), \fB\(haO\fP (SI or LS0), ESC n (LS2), ESC o (LS3), ESC N (SS2), ESC O (SS3), ESC \(ti (LS1R), ESC } (LS2R), ESC | (LS3R). The function LS\fIn\fP makes character set G\fIn\fP the current one for codes with high bit zero. @@ -253,7 +253,7 @@ recent version selected by ESC & @ ESC $ B. ISO 4873 stipulates a narrower use of character sets, where G0 is fixed (always ASCII), so that G1, G2 and G3 can be invoked only for codes with the high order bit set. -In particular, \fB^N\fP and \fB^O\fP are not used anymore, ESC ( xx +In particular, \fB\(haN\fP and \fB\(haO\fP are not used anymore, ESC ( xx can be used only with xx=B, and ESC ) xx, ESC * xx, ESC + xx are equivalent to ESC \- xx, ESC . xx, ESC / xx, respectively. .SS TIS-620 diff --git a/man7/glob.7 b/man7/glob.7 index b04ce821c..4bafda49e 100644 --- a/man7/glob.7 +++ b/man7/glob.7 @@ -149,8 +149,8 @@ are not the same: for example, in a regular expression \(aq*\(aq means zero or more copies of the preceding thing. .PP Now that regular expressions have bracket expressions where -the negation is indicated by a \(aq^\(aq, POSIX has declared the -effect of a wildcard pattern "\fI[^...]\fP" to be undefined. +the negation is indicated by a \(aq\(ha\(aq, POSIX has declared the +effect of a wildcard pattern "\fI[\(ha...]\fP" to be undefined. .SS Character classes and internationalization Of course ranges were originally meant to be ASCII ranges, so that "\fI[\ \-%]\fP" stands for "\fI[\ !"#$%]\fP" and "\fI[a\-z]\fP" stands diff --git a/man7/man-pages.7 b/man7/man-pages.7 index eecba8996..d0eabebe6 100644 --- a/man7/man-pages.7 +++ b/man7/man-pages.7 @@ -633,7 +633,7 @@ create properly hyperlinked pages.) .PP Control characters should be written in bold face, with no quotes; for example, -.BR ^X . +.BR \(haX . .SS Spelling Starting with release 2.59, .I man-pages diff --git a/man7/operator.7 b/man7/operator.7 index 73d08b634..cad406013 100644 --- a/man7/operator.7 +++ b/man7/operator.7 @@ -55,12 +55,12 @@ Operator Associativity Notes < <= > >= left to right == != left to right & left to right -^ left to right +\(ha left to right | left to right && left to right || left to right ?: right to left -= += \-= *= /= %= <<= >>= &= ^= |= right to left += += \-= *= /= %= <<= >>= &= \(ha= |= right to left , left to right .TE .PP diff --git a/man7/regex.7 b/man7/regex.7 index 451b1fd04..5cfd0b7d9 100644 --- a/man7/regex.7 +++ b/man7/regex.7 @@ -91,10 +91,10 @@ An atom is a regular expression enclosed in "\fI()\fP" (matching a match for the regular expression), an empty set of "\fI()\fP" (matching the null string)\*(dg, a \fIbracket expression\fR (see below), \(aq.\(aq -(matching any single character), \(aq^\(aq (matching the null string at the +(matching any single character), \(aq\(ha\(aq (matching the null string at the beginning of a line), \(aq$\(aq (matching the null string at the end of a line), a \(aq\e\(aq followed by one of the characters -"\fI^.[$()|*+?{\e\fP" +"\fI\(ha.[$()|*+?{\e\fP" (matching that character taken as an ordinary character), a \(aq\e\(aq followed by any other character\*(dg (matching that character taken as an ordinary character, @@ -106,7 +106,7 @@ It is illegal to end an RE with \(aq\e\(aq. .PP A \fIbracket expression\fR is a list of characters enclosed in "\fI[]\fP". It normally matches any single character from the list (but see below). -If the list begins with \(aq^\(aq, +If the list begins with \(aq\(ha\(aq, it matches any single character (but see below) \fInot\fR from the rest of the list. If two characters in the list are separated by \(aq\-\(aq, this is shorthand @@ -119,7 +119,7 @@ Ranges are very collating-sequence-dependent, and portable programs should avoid relying on them. .PP To include a literal \(aq]\(aq in the list, make it the first character -(following a possible \(aq^\(aq). +(following a possible \(aq\(ha\(aq). To include a literal \(aq\-\(aq, make it the first or last character, or the second endpoint of a range. To use a literal \(aq\-\(aq as the first endpoint of a range, @@ -147,9 +147,9 @@ of all collating elements equivalent to that one, including itself. (If there are no other equivalent collating elements, the treatment is as if the enclosing delimiters were "\fI[.\fP" and "\fI.]\fP".) -For example, if o and \o'o^' are the members of an equivalence class, -then "\fI[[=o=]]\fP", "\fI[[=\o'o^'=]]\fP", -and "\fI[o\o'o^']\fP" are all synonymous. +For example, if o and \o'o\(ha' are the members of an equivalence class, +then "\fI[[=o=]]\fP", "\fI[[=\o'o\(ha'=]]\fP", +and "\fI[o\o'o\(ha']\fP" are all synonymous. An equivalence class may not\*(dg be an endpoint of a range. .PP @@ -226,7 +226,7 @@ transformed into a bracket expression containing both cases, for example, \(aqx\(aq becomes "\fI[xX]\fP". When it appears inside a bracket expression, all case counterparts of it are added to the bracket expression, so that, for example, "\fI[x]\fP" -becomes "\fI[xX]\fP" and "\fI[^x]\fP" becomes "\fI[^xX]\fP". +becomes "\fI[xX]\fP" and "\fI[\(hax]\fP" becomes "\fI[\(haxX]\fP". .PP No particular limit is imposed on the length of REs\*(dg. Programs intended to be portable should not employ REs longer @@ -242,13 +242,13 @@ The delimiters for bounds are "\fI\e{\fP" and "\fI\e}\fP", with \(aq{\(aq and \(aq}\(aq by themselves ordinary characters. The parentheses for nested subexpressions are "\fI\e(\fP" and "\fI\e)\fP", with \(aq(\(aq and \(aq)\(aq by themselves ordinary characters. -\(aq^\(aq is an ordinary character except at the beginning of the +\(aq\(ha\(aq is an ordinary character except at the beginning of the RE or\*(dg the beginning of a parenthesized subexpression, \(aq$\(aq is an ordinary character except at the end of the RE or\*(dg the end of a parenthesized subexpression, and \(aq*\(aq is an ordinary character if it appears at the beginning of the RE or the beginning of a parenthesized subexpression -(after a possible leading \(aq^\(aq). +(after a possible leading \(aq\(ha\(aq). .PP Finally, there is one new type of atom, a \fIback reference\fR: \(aq\e\(aq followed by a nonzero decimal digit \fId\fR diff --git a/man7/user_namespaces.7 b/man7/user_namespaces.7 index 73909a537..954a50887 100644 --- a/man7/user_namespaces.7 +++ b/man7/user_namespaces.7 @@ -1053,10 +1053,10 @@ and a full set of permitted and effective capabilities: .PP .in +4n .EX -bash$ \fBcat /proc/$$/status | egrep '^[UG]id'\fP +bash$ \fBcat /proc/$$/status | egrep '\(ha[UG]id'\fP Uid: 0 0 0 0 Gid: 0 0 0 0 -bash$ \fBcat /proc/$$/status | egrep '^Cap(Prm|Inh|Eff)'\fP +bash$ \fBcat /proc/$$/status | egrep '\(haCap(Prm|Inh|Eff)'\fP CapInh: 0000000000000000 CapPrm: 0000001fffffffff CapEff: 0000001fffffffff diff --git a/man8/zic.8 b/man8/zic.8 index aeca0e726..7562e7c86 100644 --- a/man8/zic.8 +++ b/man8/zic.8 @@ -293,7 +293,7 @@ nor .q + . To allow for future extensions, an unquoted name should not contain characters from the set -.q !$%&'()*,/:;<=>?@[\e]^\`{|}\(ti . +.q !$%&'()*,/:;<=>?@[\e]\(ha\`{|}\(ti . .TP .B FROM Gives the first year in which the rule applies.