Skip to contentSkip to conversation

ascii.7: charset pages unification, minor cleanups

PATCH In review Marko Myllynen 2 participants 3 messages Sep 30, 2014 – Oct 1, 2014 2 messages not in the archive Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 ascii.7: charset pages unification, minor cleanups

Hi,

this and the follow-up patches will provide unification of charset pages, minor cleanups, and some unifying cosmetic changes. References are adjusted so that all pages include a reference to charsets(7) which contains description of these sets, stray comments are removed, some obsolete statements (like ISO 8859-1 being the de-facto ASCII replacement..) are removed, and some minor reformatting to minimize diff's between the pages are done.

The actual substance, the character tables, remain unchanged.

This series changes the following pages (under man7): ascii, armscii, cp1251, koi8-r, koi8-u, and all of iso_8859-*. Also adds a new page for cp1252.

CC'ing Lefteris who contributed many of these pages.

-----
- adjust references
- add null char description
- cosmetics

---
 man7/ascii.7 |   14 ++++++++------
 1 files changed, 8 insertions(+), 6 deletions(-)
man7/ascii.7 +8 -6
index f17c256..12375d9 100644
@@ -1,6 +1,5 @@
 '\" t
 .\" Copyright (c) 1993 Michael Haardt ([email protected])
-.\" Created Fri Apr  2 11:32:09 MET DST 1993
 .\"
 .\" %%%LICENSE_START(GPLv2+_DOC_FULL)
 .\" This is free documentation; you can redistribute it and/or
@@ -23,6 +22,7 @@
 .\" <http://www.gnu.org/licenses/>.
 .\" %%%LICENSE_END
 .\"
+.\" Created  1993-04-02 by Michael Haardt ([email protected])
 .\" Modified 1993-07-24 by Rik Faith ([email protected])
 .\" Modified 1994-05-15 by Daniel Quinlan ([email protected])
 .\" Modified 1994-11-22 by Daniel Quinlan ([email protected])
@@ -34,12 +34,13 @@
 .\"
 .TH ASCII 7 2014-02-26 "Linux" "Linux Programmer's Manual"
 .SH NAME
-ascii \- ASCII character set encoded in octal, decimal, and hexadecimal
+ascii \- ASCII character set encoded in octal, decimal,
+and hexadecimal
 .SH DESCRIPTION
 ASCII is the American Standard Code for Information Interchange.
 It is a 7-bit code.
 Many 8-bit codes (e.g., ISO 8859-1) contain ASCII as their lower half.
-The international counterpart of ASCII is known as ISO 646.
+The international counterpart of ASCII is known as ISO 646-IRV.
 .LP
 The following table contains the 128 ASCII characters.
 .LP
@@ -51,7 +52,7 @@ C program \f(CW\(aq\eX\(aq\fP escapes are noted.
 l l l l l l l l.
 Oct	Dec	Hex	Char	Oct	Dec	Hex	Char
 _
-000	0	00	NUL \(aq\e0\(aq	100	64	40	@
+000	0	00	NUL \(aq\e0\(aq (null character)	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
@@ -121,7 +122,7 @@ _
 .ft P
 \}
 .SS Tables
-For convenience, let us give more compact tables in hex and decimal.
+For convenience, below are more compact tables in hex and decimal.
 .sp
 .nf
 .if t \{\
@@ -182,9 +183,10 @@ Standards Institute (USASI) in 1968.
 .\" U.S. member body of ISO; private and nonprofit.
 .\"
 .SH SEE ALSO
-.ad l
+.BR charsets (7),
 .BR iso_8859-1 (7),
 .BR iso_8859-10 (7),
+.BR iso_8859-11 (7),
 .BR iso_8859-13 (7),
 .BR iso_8859-14 (7),
 .BR iso_8859-15 (7),
Signature · 9 lines
1.7.1


-- 
Marko Myllynen
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

A message that is not in the archive (sent off-list or not yet received): [email protected]

#2 lore raw
Quoted 10 lines · Marko Myllynen

Hi,

this and the follow-up patches will provide unification of charset pages, minor cleanups, and some unifying cosmetic changes. References are adjusted so that all pages include a reference to charsets(7) which contains description of these sets, stray comments are removed, some obsolete statements (like ISO 8859-1 being the de-facto ASCII replacement..) are removed, and some minor reformatting to minimize diff's between the pages are done.

Quoted 7 lines

The actual substance, the character tables, remain unchanged.

This series changes the following pages (under man7): ascii, armscii, cp1251, koi8-r, koi8-u, and all of iso_8859-*. Also adds a new page for cp1252.

CC'ing Lefteris who contributed many of these pages.

Thanks, Marko. Applied (for the moment, in a local branch).

Cheers,

Michael

Quoted 74 lines

-----
- adjust references
- add null char description
- cosmetics

---
 man7/ascii.7 |   14 ++++++++------
 1 files changed, 8 insertions(+), 6 deletions(-)
man7/ascii.7 +8 -6
index f17c256..12375d9 100644
@@ -1,6 +1,5 @@
 '\" t
 .\" Copyright (c) 1993 Michael Haardt ([email protected])
-.\" Created Fri Apr  2 11:32:09 MET DST 1993
 .\"
 .\" %%%LICENSE_START(GPLv2+_DOC_FULL)
 .\" This is free documentation; you can redistribute it and/or
@@ -23,6 +22,7 @@
 .\" <http://www.gnu.org/licenses/>.
 .\" %%%LICENSE_END
 .\"
+.\" Created  1993-04-02 by Michael Haardt ([email protected])
 .\" Modified 1993-07-24 by Rik Faith ([email protected])
 .\" Modified 1994-05-15 by Daniel Quinlan ([email protected])
 .\" Modified 1994-11-22 by Daniel Quinlan ([email protected])
@@ -34,12 +34,13 @@
 .\"
 .TH ASCII 7 2014-02-26 "Linux" "Linux Programmer's Manual"
 .SH NAME
-ascii \- ASCII character set encoded in octal, decimal, and hexadecimal
+ascii \- ASCII character set encoded in octal, decimal,
+and hexadecimal
 .SH DESCRIPTION
 ASCII is the American Standard Code for Information Interchange.
 It is a 7-bit code.
 Many 8-bit codes (e.g., ISO 8859-1) contain ASCII as their lower half.
-The international counterpart of ASCII is known as ISO 646.
+The international counterpart of ASCII is known as ISO 646-IRV.
 .LP
 The following table contains the 128 ASCII characters.
 .LP
@@ -51,7 +52,7 @@ C program \f(CW\(aq\eX\(aq\fP escapes are noted.
 l l l l l l l l.
 Oct	Dec	Hex	Char	Oct	Dec	Hex	Char
 _
-000	0	00	NUL \(aq\e0\(aq	100	64	40	@
+000	0	00	NUL \(aq\e0\(aq (null character)	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
@@ -121,7 +122,7 @@ _
 .ft P
 \}
 .SS Tables
-For convenience, let us give more compact tables in hex and decimal.
+For convenience, below are more compact tables in hex and decimal.
 .sp
 .nf
 .if t \{\
@@ -182,9 +183,10 @@ Standards Institute (USASI) in 1968.
 .\" U.S. member body of ISO; private and nonprofit.
 .\"
 .SH SEE ALSO
-.ad l
+.BR charsets (7),
 .BR iso_8859-1 (7),
 .BR iso_8859-10 (7),
+.BR iso_8859-11 (7),
 .BR iso_8859-13 (7),
 .BR iso_8859-14 (7),
 .BR iso_8859-15 (7),
Signature · 7 lines
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

A message that is not in the archive (sent off-list or not yet received): [email protected]

#4 lore raw
Quoted 13 lines · Michael Kerrisk (man-pages)
Quoted 12 lines · Marko Myllynen

Hi,

this and the follow-up patches will provide unification of charset pages, minor cleanups, and some unifying cosmetic changes. References are adjusted so that all pages include a reference to charsets(7) which contains description of these sets, stray comments are removed, some obsolete statements (like ISO 8859-1 being the de-facto ASCII replacement..) are removed, and some minor reformatting to minimize diff's between the pages are done.

The actual substance, the character tables, remain unchanged.

Quoted 7 lines
Quoted 5 lines

This series changes the following pages (under man7): ascii, armscii, cp1251, koi8-r, koi8-u, and all of iso_8859-*. Also adds a new page for cp1252.

CC'ing Lefteris who contributed many of these pages.

Thanks, Marko. Applied (for the moment, in a local branch).

Hi Marko,

I've now merged the local branch into main and pushed to kernel.org. Thanks very much for your effort on this!

Cheers,

Michael

Quoted 76 lines
Quoted 74 lines

-----
- adjust references
- add null char description
- cosmetics

---
 man7/ascii.7 |   14 ++++++++------
 1 files changed, 8 insertions(+), 6 deletions(-)
man7/ascii.7 +8 -6
index f17c256..12375d9 100644
@@ -1,6 +1,5 @@
 '\" t
 .\" Copyright (c) 1993 Michael Haardt ([email protected])
-.\" Created Fri Apr  2 11:32:09 MET DST 1993
 .\"
 .\" %%%LICENSE_START(GPLv2+_DOC_FULL)
 .\" This is free documentation; you can redistribute it and/or
@@ -23,6 +22,7 @@
 .\" <http://www.gnu.org/licenses/>.
 .\" %%%LICENSE_END
 .\"
+.\" Created  1993-04-02 by Michael Haardt ([email protected])
 .\" Modified 1993-07-24 by Rik Faith ([email protected])
 .\" Modified 1994-05-15 by Daniel Quinlan ([email protected])
 .\" Modified 1994-11-22 by Daniel Quinlan ([email protected])
@@ -34,12 +34,13 @@
 .\"
 .TH ASCII 7 2014-02-26 "Linux" "Linux Programmer's Manual"
 .SH NAME
-ascii \- ASCII character set encoded in octal, decimal, and hexadecimal
+ascii \- ASCII character set encoded in octal, decimal,
+and hexadecimal
 .SH DESCRIPTION
 ASCII is the American Standard Code for Information Interchange.
 It is a 7-bit code.
 Many 8-bit codes (e.g., ISO 8859-1) contain ASCII as their lower half.
-The international counterpart of ASCII is known as ISO 646.
+The international counterpart of ASCII is known as ISO 646-IRV.
 .LP
 The following table contains the 128 ASCII characters.
 .LP
@@ -51,7 +52,7 @@ C program \f(CW\(aq\eX\(aq\fP escapes are noted.
 l l l l l l l l.
 Oct	Dec	Hex	Char	Oct	Dec	Hex	Char
 _
-000	0	00	NUL \(aq\e0\(aq	100	64	40	@
+000	0	00	NUL \(aq\e0\(aq (null character)	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
@@ -121,7 +122,7 @@ _
 .ft P
 \}
 .SS Tables
-For convenience, let us give more compact tables in hex and decimal.
+For convenience, below are more compact tables in hex and decimal.
 .sp
 .nf
 .if t \{\
@@ -182,9 +183,10 @@ Standards Institute (USASI) in 1968.
 .\" U.S. member body of ISO; private and nonprofit.
 .\"
 .SH SEE ALSO
-.ad l
+.BR charsets (7),
 .BR iso_8859-1 (7),
 .BR iso_8859-10 (7),
+.BR iso_8859-11 (7),
 .BR iso_8859-13 (7),
 .BR iso_8859-14 (7),
 .BR iso_8859-15 (7),
Signature · 7 lines
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html