iso_8859-1.7: charset pages unification, minor cleanups

PATCH In review Marko Myllynen 2 participants 4 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

Marko Myllynen

author

2014-09-30 10:29 UTC #0 lore raw

PATCH 1/1 iso_8859-1.7: charset pages unification, minor cleanups

- adjust references
- remove stray comments, streamline description (charsets(7) and Wikipedia provide more detailed and up-to-date description)
- cosmetics

---
 man7/iso_8859-1.7 |   37 +++++++++++--------------------------
 1 files changed, 11 insertions(+), 26 deletions(-)

man7/iso_8859-1.7 +11 ~~-26~~

index 0a77a1a..d48819f 100644
@@ -25,25 +25,14 @@
 .\" Slightly rearranged, aeb, 950713
 .\" Updated, dpo, 990531
 .TH ISO_8859-1 7 2014-02-16 "Linux" "Linux Programmer's Manual"
-.nh
 .SH NAME
 iso_8859-1 \- ISO 8859-1 character set encoded in octal, decimal,
 and hexadecimal
 .SH DESCRIPTION
 The ISO 8859 standard includes several 8-bit extensions to the ASCII
 character set (also known as ISO 646-IRV).
-Especially important is
-ISO 8859-1, the "Latin Alphabet No. 1", which has become widely
-implemented and may already be seen as the de-facto standard ASCII
-replacement.
-.P
-ISO 8859-1 supports the following languages: Afrikaans, Basque,
-Catalan, Danish, Dutch, English, Faeroese, Finnish, French, Galician,
-German, Icelandic, Irish, Italian, Norwegian, Portuguese, Scottish,
-Spanish, and Swedish.
-.P
-Note that the ISO 8859-1 characters are also the first 256 characters
-of ISO 10646 (Unicode).
+ISO 8859-1 encodes the
+characters used in many West European languages.
 .SS ISO 8859 alphabets
 The full set of ISO 8859 alphabets includes:
 .TS

@@ -65,14 +54,12 @@ ISO 8859-15	West European languages (Latin-9)
 ISO 8859-16	Romanian (Latin-10)
 .TE
 .SS ISO 8859-1 characters
-The following table displays the characters in ISO 8859-1 (Latin-1),
-which are printable and unlisted in the
+The following table displays the characters in ISO 8859-1, which
+are printable and unlisted in the
 .BR ascii (7)
 manual page.
-.\" The fourth column will only show the proper glyphs
-.\" in an environment configured for ISO 8859-1.
 .TS
-l2 l2 l2 c2 lp-1.
+l l l c lp-1.
 Oct	Dec	Hex	Char	Description
 _
 240	160	A0	 	NO-BREAK SPACE

@@ -88,7 +75,7 @@ _
 252	170	AA	ª	FEMININE ORDINAL INDICATOR
 253	171	AB	«	LEFT-POINTING DOUBLE ANGLE QUOTATION MARK
 254	172	AC	¬	NOT SIGN
-255	173	AD		SOFT HYPHEN (shown as a hyphen at line breaks) [1]
+255	173	AD		SOFT HYPHEN
 256	174	AE	®	REGISTERED SIGN
 257	175	AF	¯	MACRON
 260	176	B0	°	DEGREE SIGN

@@ -172,12 +159,10 @@ _
 376	254	FE	þ	LATIN SMALL LETTER THORN
 377	255	FF	ÿ	LATIN SMALL LETTER Y WITH DIAERESIS
 .TE
-.IP [1] 4
-See
-.BR groff_char (7)
-(soft hyphen) and the standard ISO 8859-1 ("shy",
-paragraph 6.3.3)
-or the equivalent version from your national standardization body.
+.SH NOTES
+ISO 8859-1 is also known as Latin-1.
 .SH SEE ALSO
 .BR ascii (7),
-.BR iso_8859-15 (7)
+.BR charsets (7),
+.BR iso_8859-15 (7),
+.BR utf-8 (7)

Signature · 8 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]

Michael Kerrisk (man-pages)

2014-10-01 08:59 UTC #2 lore raw

Marko,

This patch does not apply.

Could you take a look please.

Cheers,

Michael

Quoted 87 lines · Marko Myllynen

- adjust references
- remove stray comments, streamline description (charsets(7) and Wikipedia provide more detailed and up-to-date description)
- cosmetics

---
 man7/iso_8859-1.7 |   37 +++++++++++--------------------------
 1 files changed, 11 insertions(+), 26 deletions(-)

man7/iso_8859-1.7 +11 ~~-26~~

index 0a77a1a..d48819f 100644
@@ -25,25 +25,14 @@
 .\" Slightly rearranged, aeb, 950713
 .\" Updated, dpo, 990531
 .TH ISO_8859-1 7 2014-02-16 "Linux" "Linux Programmer's Manual"
-.nh
 .SH NAME
 iso_8859-1 \- ISO 8859-1 character set encoded in octal, decimal,
 and hexadecimal
 .SH DESCRIPTION
 The ISO 8859 standard includes several 8-bit extensions to the ASCII
 character set (also known as ISO 646-IRV).
-Especially important is
-ISO 8859-1, the "Latin Alphabet No. 1", which has become widely
-implemented and may already be seen as the de-facto standard ASCII
-replacement.
-.P
-ISO 8859-1 supports the following languages: Afrikaans, Basque,
-Catalan, Danish, Dutch, English, Faeroese, Finnish, French, Galician,
-German, Icelandic, Irish, Italian, Norwegian, Portuguese, Scottish,
-Spanish, and Swedish.
-.P
-Note that the ISO 8859-1 characters are also the first 256 characters
-of ISO 10646 (Unicode).
+ISO 8859-1 encodes the
+characters used in many West European languages.
 .SS ISO 8859 alphabets
 The full set of ISO 8859 alphabets includes:
 .TS

@@ -65,14 +54,12 @@ ISO 8859-15	West European languages (Latin-9)
 ISO 8859-16	Romanian (Latin-10)
 .TE
 .SS ISO 8859-1 characters
-The following table displays the characters in ISO 8859-1 (Latin-1),
-which are printable and unlisted in the
+The following table displays the characters in ISO 8859-1, which
+are printable and unlisted in the
 .BR ascii (7)
 manual page.
-.\" The fourth column will only show the proper glyphs
-.\" in an environment configured for ISO 8859-1.
 .TS
-l2 l2 l2 c2 lp-1.
+l l l c lp-1.
 Oct	Dec	Hex	Char	Description
 _
 240	160	A0	 	NO-BREAK SPACE

@@ -88,7 +75,7 @@ _
 252	170	AA	ª	FEMININE ORDINAL INDICATOR
 253	171	AB	«	LEFT-POINTING DOUBLE ANGLE QUOTATION MARK
 254	172	AC	¬	NOT SIGN
-255	173	AD		SOFT HYPHEN (shown as a hyphen at line breaks) [1]
+255	173	AD		SOFT HYPHEN
 256	174	AE	®	REGISTERED SIGN
 257	175	AF	¯	MACRON
 260	176	B0	°	DEGREE SIGN

@@ -172,12 +159,10 @@ _
 376	254	FE	þ	LATIN SMALL LETTER THORN
 377	255	FF	ÿ	LATIN SMALL LETTER Y WITH DIAERESIS
 .TE
-.IP [1] 4
-See
-.BR groff_char (7)
-(soft hyphen) and the standard ISO 8859-1 ("shy",
-paragraph 6.3.3)
-or the equivalent version from your national standardization body.
+.SH NOTES
+ISO 8859-1 is also known as Latin-1.
 .SH SEE ALSO
 .BR ascii (7),
-.BR iso_8859-15 (7)
+.BR charsets (7),
+.BR iso_8859-15 (7),
+.BR utf-8 (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]

Michael Kerrisk (man-pages)

2014-10-01 09:00 UTC #4 lore raw

Quoted 5 lines · Michael Kerrisk (man-pages)

Marko,
This patch does not apply.
Could you take a look please.

Actually, don't worry. I found and fixed the breakage.

Cheers,

Michael

Quoted 90 lines · Marko Myllynen

Quoted 87 lines

- adjust references
- remove stray comments, streamline description (charsets(7) and Wikipedia provide more detailed and up-to-date description)
- cosmetics

---
 man7/iso_8859-1.7 |   37 +++++++++++--------------------------
 1 files changed, 11 insertions(+), 26 deletions(-)

man7/iso_8859-1.7 +11 ~~-26~~

index 0a77a1a..d48819f 100644
@@ -25,25 +25,14 @@
 .\" Slightly rearranged, aeb, 950713
 .\" Updated, dpo, 990531
 .TH ISO_8859-1 7 2014-02-16 "Linux" "Linux Programmer's Manual"
-.nh
 .SH NAME
 iso_8859-1 \- ISO 8859-1 character set encoded in octal, decimal,
 and hexadecimal
 .SH DESCRIPTION
 The ISO 8859 standard includes several 8-bit extensions to the ASCII
 character set (also known as ISO 646-IRV).
-Especially important is
-ISO 8859-1, the "Latin Alphabet No. 1", which has become widely
-implemented and may already be seen as the de-facto standard ASCII
-replacement.
-.P
-ISO 8859-1 supports the following languages: Afrikaans, Basque,
-Catalan, Danish, Dutch, English, Faeroese, Finnish, French, Galician,
-German, Icelandic, Irish, Italian, Norwegian, Portuguese, Scottish,
-Spanish, and Swedish.
-.P
-Note that the ISO 8859-1 characters are also the first 256 characters
-of ISO 10646 (Unicode).
+ISO 8859-1 encodes the
+characters used in many West European languages.
 .SS ISO 8859 alphabets
 The full set of ISO 8859 alphabets includes:
 .TS

@@ -65,14 +54,12 @@ ISO 8859-15	West European languages (Latin-9)
 ISO 8859-16	Romanian (Latin-10)
 .TE
 .SS ISO 8859-1 characters
-The following table displays the characters in ISO 8859-1 (Latin-1),
-which are printable and unlisted in the
+The following table displays the characters in ISO 8859-1, which
+are printable and unlisted in the
 .BR ascii (7)
 manual page.
-.\" The fourth column will only show the proper glyphs
-.\" in an environment configured for ISO 8859-1.
 .TS
-l2 l2 l2 c2 lp-1.
+l l l c lp-1.
 Oct	Dec	Hex	Char	Description
 _
 240	160	A0	 	NO-BREAK SPACE

@@ -88,7 +75,7 @@ _
 252	170	AA	ª	FEMININE ORDINAL INDICATOR
 253	171	AB	«	LEFT-POINTING DOUBLE ANGLE QUOTATION MARK
 254	172	AC	¬	NOT SIGN
-255	173	AD		SOFT HYPHEN (shown as a hyphen at line breaks) [1]
+255	173	AD		SOFT HYPHEN
 256	174	AE	®	REGISTERED SIGN
 257	175	AF	¯	MACRON
 260	176	B0	°	DEGREE SIGN

@@ -172,12 +159,10 @@ _
 376	254	FE	þ	LATIN SMALL LETTER THORN
 377	255	FF	ÿ	LATIN SMALL LETTER Y WITH DIAERESIS
 .TE
-.IP [1] 4
-See
-.BR groff_char (7)
-(soft hyphen) and the standard ISO 8859-1 ("shy",
-paragraph 6.3.3)
-or the equivalent version from your national standardization body.
+.SH NOTES
+ISO 8859-1 is also known as Latin-1.
 .SH SEE ALSO
 .BR ascii (7),
-.BR iso_8859-15 (7)
+.BR charsets (7),
+.BR iso_8859-15 (7),
+.BR utf-8 (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

Michael Kerrisk (man-pages)

2014-10-01 09:22 UTC #5 lore raw

In reply to a message not in the archive

Quoted 5 lines · Marko Myllynen

- adjust references
- remove stray comments, streamline description (charsets(7) and Wikipedia provide more detailed and up-to-date description)
- cosmetics

Thanks, Marko. Patch fixed and applied (for the moment, in a local branch).

Cheers,

Michael

Quoted 82 lines

---
 man7/iso_8859-1.7 |   37 +++++++++++--------------------------
 1 files changed, 11 insertions(+), 26 deletions(-)

man7/iso_8859-1.7 +11 ~~-26~~

index 0a77a1a..d48819f 100644
@@ -25,25 +25,14 @@
 .\" Slightly rearranged, aeb, 950713
 .\" Updated, dpo, 990531
 .TH ISO_8859-1 7 2014-02-16 "Linux" "Linux Programmer's Manual"
-.nh
 .SH NAME
 iso_8859-1 \- ISO 8859-1 character set encoded in octal, decimal,
 and hexadecimal
 .SH DESCRIPTION
 The ISO 8859 standard includes several 8-bit extensions to the ASCII
 character set (also known as ISO 646-IRV).
-Especially important is
-ISO 8859-1, the "Latin Alphabet No. 1", which has become widely
-implemented and may already be seen as the de-facto standard ASCII
-replacement.
-.P
-ISO 8859-1 supports the following languages: Afrikaans, Basque,
-Catalan, Danish, Dutch, English, Faeroese, Finnish, French, Galician,
-German, Icelandic, Irish, Italian, Norwegian, Portuguese, Scottish,
-Spanish, and Swedish.
-.P
-Note that the ISO 8859-1 characters are also the first 256 characters
-of ISO 10646 (Unicode).
+ISO 8859-1 encodes the
+characters used in many West European languages.
 .SS ISO 8859 alphabets
 The full set of ISO 8859 alphabets includes:
 .TS

@@ -65,14 +54,12 @@ ISO 8859-15	West European languages (Latin-9)
 ISO 8859-16	Romanian (Latin-10)
 .TE
 .SS ISO 8859-1 characters
-The following table displays the characters in ISO 8859-1 (Latin-1),
-which are printable and unlisted in the
+The following table displays the characters in ISO 8859-1, which
+are printable and unlisted in the
 .BR ascii (7)
 manual page.
-.\" The fourth column will only show the proper glyphs
-.\" in an environment configured for ISO 8859-1.
 .TS
-l2 l2 l2 c2 lp-1.
+l l l c lp-1.
 Oct	Dec	Hex	Char	Description
 _
 240	160	A0	 	NO-BREAK SPACE

@@ -88,7 +75,7 @@ _
 252	170	AA	ª	FEMININE ORDINAL INDICATOR
 253	171	AB	«	LEFT-POINTING DOUBLE ANGLE QUOTATION MARK
 254	172	AC	¬	NOT SIGN
-255	173	AD		SOFT HYPHEN (shown as a hyphen at line breaks) [1]
+255	173	AD		SOFT HYPHEN
 256	174	AE	®	REGISTERED SIGN
 257	175	AF	¯	MACRON
 260	176	B0	°	DEGREE SIGN

@@ -172,12 +159,10 @@ _
 376	254	FE	þ	LATIN SMALL LETTER THORN
 377	255	FF	ÿ	LATIN SMALL LETTER Y WITH DIAERESIS
 .TE
-.IP [1] 4
-See
-.BR groff_char (7)
-(soft hyphen) and the standard ISO 8859-1 ("shy",
-paragraph 6.3.3)
-or the equivalent version from your national standardization body.
+.SH NOTES
+ISO 8859-1 is also known as Latin-1.
 .SH SEE ALSO
 .BR ascii (7),
-.BR iso_8859-15 (7)
+.BR charsets (7),
+.BR iso_8859-15 (7),
+.BR utf-8 (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