From b8b45978b0e48da0de0b93ce4a30ab088a186739 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Thu, 5 Jun 2008 19:01:25 +0000 Subject: [PATCH] /'/\\'/ to produce better UTF rendering --- man3/gets.3 | 4 ++-- man3/isalpha.3 | 10 +++++----- man3/printf.3 | 8 ++++---- man3/puts.3 | 2 +- man5/utmp.5 | 2 +- man7/ascii.7 | 20 ++++++++++---------- man7/man.7 | 2 +- 7 files changed, 24 insertions(+), 24 deletions(-) diff --git a/man3/gets.3 b/man3/gets.3 index 18bb058bb..eb72df15d 100644 --- a/man3/gets.3 +++ b/man3/gets.3 @@ -72,7 +72,7 @@ into the buffer pointed to by until either a terminating newline or .BR EOF , which it replaces with -.BR '\e0' . +.BR \'\e0\' . No check for buffer overrun is performed (see BUGS below). .PP .BR fgets () @@ -87,7 +87,7 @@ Reading stops after an or a newline. If a newline is read, it is stored into the buffer. A -.B '\e0' +.B \'\e0\' is stored after the last character in the buffer. .PP .BR ungetc () diff --git a/man3/isalpha.3 b/man3/isalpha.3 index d5504e2d1..d2cbfd6b3 100644 --- a/man3/isalpha.3 +++ b/man3/isalpha.3 @@ -132,15 +132,15 @@ In the and .B """POSIX""" locales, these are: space, form-feed -.RB ( '\ef' ), +.RB ( \'\ef\' ), newline -.RB ( '\en' ), +.RB ( \'\en\' ), carriage return -.RB ( '\er' ), +.RB ( \'\er\' ), horizontal tab -.RB ( '\et' ), +.RB ( \'\et\' ), and vertical tab -.RB ( '\ev' ). +.RB ( \'\ev\' ). .TP .BR isupper () checks for an uppercase letter. diff --git a/man3/printf.3 b/man3/printf.3 index ec9a2da08..63dded210 100644 --- a/man3/printf.3 +++ b/man3/printf.3 @@ -98,7 +98,7 @@ and .BR vsnprintf () write at most .I size -bytes (including the trailing null byte ('\e0')) to +bytes (including the trailing null byte (\'\e0\')) to .IR str . .PP The functions @@ -133,7 +133,7 @@ the variable-length argument facilities of are converted for output. .SS "Return value" Upon successful return, these functions return the number of characters -printed (not including the trailing '\e0' used to end output to strings). +printed (not including the trailing \'\e0\' used to end output to strings). The functions .BR snprintf () @@ -141,9 +141,9 @@ and .BR vsnprintf () do not write more than .I size -bytes (including the trailing '\e0'). +bytes (including the trailing \'\e0\'). If the output was truncated due to this limit then the return value -is the number of characters (not including the trailing '\e0') +is the number of characters (not including the trailing \'\e0\') which would have been written to the final string if enough space had been available. Thus, a return value of diff --git a/man3/puts.3 b/man3/puts.3 index 7bd0e44e1..1882d31e1 100644 --- a/man3/puts.3 +++ b/man3/puts.3 @@ -53,7 +53,7 @@ writes the string to .IR stream , without its trailing -.BR '\e0' . +.BR \'\e0\' . .PP .BR putc () is equivalent to diff --git a/man5/utmp.5 b/man5/utmp.5 index c06d0d04e..2ed039778 100644 --- a/man5/utmp.5 +++ b/man5/utmp.5 @@ -115,7 +115,7 @@ This structure gives the name of the special file associated with the user's terminal, the user's login name, and the time of login in the form of .BR time (2). -String fields are terminated by \fB'\e0'\fP if they are shorter than the size +String fields are terminated by \fB\'\e0\'\fP if they are shorter than the size of the field. .PP The first entries ever created result from diff --git a/man7/ascii.7 b/man7/ascii.7 index b08713dc7..713a0f9fe 100644 --- a/man7/ascii.7 +++ b/man7/ascii.7 @@ -43,7 +43,7 @@ The international counterpart of ASCII is known as ISO 646. .LP The following table contains the 128 ASCII characters. .LP -C program \f(CW'\eX'\fP escapes are noted. +C program \f(CW\'\eX\'\fP escapes are noted. .if t \{\ .in 1i .ft CW @@ -52,20 +52,20 @@ C program \f(CW'\eX'\fP escapes are noted. l l l l l l l l. Oct Dec Hex Char Oct Dec Hex Char _ -000 0 00 NUL '\e0' 100 64 40 @ +000 0 00 NUL \'\e0\' 100 64 40 @ 001 1 01 SOH (start of heading) 101 65 41 A 002 2 02 STX (start of text) 102 66 42 B 003 3 03 ETX (end of text) 103 67 43 C 004 4 04 EOT (end of transmission) 104 68 44 D 005 5 05 ENQ (enquiry) 105 69 45 E 006 6 06 ACK (acknowledge) 106 70 46 F -007 7 07 BEL '\ea' (bell) 107 71 47 G -010 8 08 BS '\eb' (backspace) 110 72 48 H -011 9 09 HT '\et' (horizontal tab) 111 73 49 I -012 10 0A LF '\en' (new line) 112 74 4A J -013 11 0B VT '\ev' (vertical tab) 113 75 4B K -014 12 0C FF '\ef' (form feed) 114 76 4C L -015 13 0D CR '\er' (carriage ret) 115 77 4D M +007 7 07 BEL \'\ea\' (bell) 107 71 47 G +010 8 08 BS \'\eb\' (backspace) 110 72 48 H +011 9 09 HT \'\et\' (horizontal tab) 111 73 49 I +012 10 0A LF \'\en\' (new line) 112 74 4A J +013 11 0B VT \'\ev\' (vertical tab) 113 75 4B K +014 12 0C FF \'\ef\' (form feed) 114 76 4C L +015 13 0D CR \'\er\' (carriage ret) 115 77 4D M 016 14 0E SO (shift out) 116 78 4E N 017 15 0F SI (shift in) 117 79 4F O 020 16 10 DLE (data link escape) 120 80 50 P @@ -80,7 +80,7 @@ _ 031 25 19 EM (end of medium) 131 89 59 Y 032 26 1A SUB (substitute) 132 90 5A Z 033 27 1B ESC (escape) 133 91 5B [ -034 28 1C FS (file separator) 134 92 5C \e '\e\e' +034 28 1C FS (file separator) 134 92 5C \e \'\e\e\' 035 29 1D GS (group separator) 135 93 5D ] 036 30 1E RS (record separator) 136 94 5E ^ 037 31 1F US (unit separator) 137 95 5F \&_ diff --git a/man7/man.7 b/man7/man.7 index f1e2b6e10..0fd1f16e7 100644 --- a/man7/man.7 +++ b/man7/man.7 @@ -491,7 +491,7 @@ file (such as HTML or Docbook). Anything else suggests simple ASCII text (e.g., a "catman" result). .PP -Many man pages begin with \fB'\e"\fP followed by a +Many man pages begin with \fB\'\e"\fP followed by a space and a list of characters, indicating how the page is to be preprocessed. For portability's sake to non-troff translators we recommend