Skip to contentSkip to conversation

ascii(7) fix

PATCH In review Kir Kolyshkin 2 participants 4 messages Feb 11, 2009 – Feb 12, 2009 3 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) fix

Hi Michael,

I just tried to print ascii(7) and found out the tables on the second page (compact ascii in hex and dec) are screwed because they do not use monospaced font. This is of course can not be seen on the terminal.

Attached patch (against man-pages-3.18) fixes that by adding the proper .fn (code copy-pasted from the first table). I checked the result both in the terminal and on printer.

Regards,
Kir.

man7/ascii.7 +10 -1
diff -urN man-pages-3.18/man7/ascii.7 man-pages-3.18-my/man7/ascii.7
@@ -30,6 +30,7 @@
 .\" Modified 1999-05-31 by Dimitri Papadopoulos ([email protected])
 .\" Modified 1999-08-08 by Michael Haardt ([email protected])
 .\" Modified 2004-04-01 by aeb
+.\" Modified 2009-02-11 by Kir Kolyshkin ([email protected])
 .\"
 .TH ASCII 7 2009-02-04 "Linux" "Linux Programmer's Manual"
 .SH NAME
@@ -113,7 +114,7 @@
 072	58	3A	:	172	122	7A	z
 073	59	3B	;	173	123	7B	{
 074	60	3C	<	174	124	7C	|
-075	61	3D	= 	175	125	7D	}
+075	61	3Di	= 	175	125	7D	}
 076	62	3E	>	176	126	7E	~
 077	63	3F	?	177	127	7F	DEL
 .TE
@@ -125,6 +126,10 @@
 For convenience, let us give more compact tables in hex and decimal.
 .sp
 .nf
+.if t \{\
+.in 1i
+.ft CW
+\}
    2 3 4 5 6 7       30 40 50 60 70 80 90 100 110 120
  -------------      ---------------------------------
 0:   0 @ P \` p     0:    (  2  <  F  P  Z  d   n   x
@@ -143,6 +148,10 @@
 D: \- = M ] m }
 E: . > N ^ n ~
 F: / ? O _ o DEL
+.if t \{\
+.in
+.ft P
+\}
 .fi
 .SH NOTES
 .SS History

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

#2 lore raw

Hi Kir,

Quoted 9 lines · Kir Kolyshkin

Hi Michael,

I just tried to print ascii(7) and found out the tables on the second page (compact ascii in hex and dec) are screwed because they do not use monospaced font. This is of course can not be seen on the terminal.

Attached patch (against man-pages-3.18) fixes that by adding the proper .fn (code copy-pasted from the first table). I checked the result both in the terminal and on printer.

Thanks for the patch. A couple of questions/comments below.

man7/ascii.7 2009-02-11 12:34:35.000000000 +0300 line 33

Quoted 8 lines

diff -urN man-pages-3.18/man7/ascii.7 man-pages-3.18-my/man7/ascii.7

man7/ascii.7 2009-02-11 12:34:35.000000000 +0300 renamed from man7/ascii.7 2009-02-09 05:14:24.000000000 +0300 +1 -0
@@ -30,6 +30,7 @@
 .\" Modified 1999-05-31 by Dimitri Papadopoulos (dpo-fBIn7JHAfCbUKx/[email protected])
 .\" Modified 1999-08-08 by Michael Haardt ([email protected])
 .\" Modified 2004-04-01 by aeb
+.\" Modified 2009-02-11 by Kir Kolyshkin ([email protected])

Nowadays, the in page change log usually only gets updated if there's some major change to content. Otherwise, it's all recorded in the git changelog. So I removed this line.

man7/ascii.7 2009-02-11 12:34:35.000000000 +0300 line 117

Quoted 9 lines
man7/ascii.7 2009-02-11 12:34:35.000000000 +0300 renamed from man7/ascii.7 2009-02-09 05:14:24.000000000 +0300 +1 -1
 .\"
 .TH ASCII 7 2009-02-04 "Linux" "Linux Programmer's Manual"
 .SH NAME
@@ -113,7 +114,7 @@
 072    58      3A      :       172     122     7A      z
 073    59      3B      ;       173     123     7B      {
 074    60      3C      <       174     124     7C      |
-075    61      3D      =       175     125     7D      }
+075    61      3Di     =       175     125     7D      }

This piece looks to be a typo on your part? I removed that piece of the change.

Quoted 15 lines
man7/ascii.7 2009-02-11 12:34:35.000000000 +0300 renamed from man7/ascii.7 2009-02-09 05:14:24.000000000 +0300 +4 -0
 076    62      3E      >       176     126     7E      ~
 077    63      3F      ?       177     127     7F      DEL
 .TE
@@ -125,6 +126,10 @@
 For convenience, let us give more compact tables in hex and decimal.
 .sp
 .nf
+.if t \{\
+.in 1i
+.ft CW
+\}
   2 3 4 5 6 7       30 40 50 60 70 80 90 100 110 120
 -------------      ---------------------------------
 0:   0 @ P \` p     0:    (  2  <  F  P  Z  d   n   x

man7/ascii.7 2009-02-11 12:34:35.000000000 +0300 line 157

Quoted 10 lines
man7/ascii.7 2009-02-11 12:34:35.000000000 +0300 renamed from man7/ascii.7 2009-02-09 05:14:24.000000000 +0300 +4 -0
@@ -143,6 +148,10 @@
 D: \- = M ] m }
 E: . > N ^ n ~
 F: / ? O _ o DEL
+.if t \{\
+.in
+.ft P
+\}
 .fi
 .SH NOTES
 .SS History

Other than the points noted above, I have applied the patch for man-pages-3.19.

Cheers,

Michael

Signature · 9 lines
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
git://git.kernel.org/pub/scm/docs/man-pages/man-pages.git
man-pages online: http://www.kernel.org/doc/man-pages/online_pages.html
Found a bug? http://www.kernel.org/doc/man-pages/reporting_bugs.html
--
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): cfd18e0f0902111120x29210768i2ec6eff12076e9f8-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org

#4 lore raw
Quoted 18 lines · Michael Kerrisk

Hi Kir,

Quoted 10 lines · Kir Kolyshkin

Hi Michael,

I just tried to print ascii(7) and found out the tables on the second page (compact ascii in hex and dec) are screwed because they do not use monospaced font. This is of course can not be seen on the terminal.

Attached patch (against man-pages-3.18) fixes that by adding the proper .fn (code copy-pasted from the first table). I checked the result both in the terminal and on printer.

Thanks for the patch. A couple of questions/comments below.

Quoted 14 lines

man7/ascii.7 2009-02-11 12:34:35.000000000 +0300 line 34

Quoted 9 lines

diff -urN man-pages-3.18/man7/ascii.7 man-pages-3.18-my/man7/ascii.7

man7/ascii.7 2009-02-11 12:34:35.000000000 +0300 renamed from man7/ascii.7 2009-02-09 05:14:24.000000000 +0300 +1 -0
@@ -30,6 +30,7 @@
 .\" Modified 1999-05-31 by Dimitri Papadopoulos (dpo-fBIn7JHAfCbUKx/[email protected])
 .\" Modified 1999-08-08 by Michael Haardt ([email protected])
 .\" Modified 2004-04-01 by aeb
+.\" Modified 2009-02-11 by Kir Kolyshkin ([email protected])
 

Nowadays, the in page change log usually only gets updated if there's some major change to content. Otherwise, it's all recorded in the git changelog. So I removed this line.

Sure.

BTW I have overlooked that there's a git repo available for man-pages; I though if it exists it should be noted at http://www.kernel.org/doc/man-pages/patches.html page so I looked no further. I suggest you to add a note about git repo to it.

Quoted 14 lines

man7/ascii.7 2009-02-11 12:34:35.000000000 +0300 line 118

Quoted 11 lines
man7/ascii.7 2009-02-11 12:34:35.000000000 +0300 renamed from man7/ascii.7 2009-02-09 05:14:24.000000000 +0300 +0 -0
 .\"
 .TH ASCII 7 2009-02-04 "Linux" "Linux Programmer's Manual"

.SH NAME

man7/ascii.7 2009-02-11 12:34:35.000000000 +0300 renamed from man7/ascii.7 2009-02-09 05:14:24.000000000 +0300 +1 -1
@@ -113,7 +114,7 @@
 072    58      3A      :       172     122     7A      z
 073    59      3B      ;       173     123     7B      {
 074    60      3C      <       174     124     7C      |
-075    61      3D      =       175     125     7D      }
+075    61      3Di     =       175     125     7D      }
 

This piece looks to be a typo on your part? I removed that piece of the change.

Oops, looks like I have attached the wrong version of the patch :( Yes it's a typo.

On that line there's a space after the '=', then tab, while on the other lines there is only a tab. I though it's a bug and removed the space, but found out it have a special effect while used inside a table: a line of === appears. So I added the space back but apparently added some junk, too...

Quoted 21 lines
Quoted 21 lines
man7/ascii.7 2009-02-11 12:34:35.000000000 +0300 renamed from man7/ascii.7 2009-02-09 05:14:24.000000000 +0300 +0 -0
 076    62      3E      >       176     126     7E      ~
 077    63      3F      ?       177     127     7F      DEL

.TE

man7/ascii.7 2009-02-11 12:34:35.000000000 +0300 renamed from man7/ascii.7 2009-02-09 05:14:24.000000000 +0300 +6 -0
@@ -125,6 +126,10 @@
 For convenience, let us give more compact tables in hex and decimal.
 .sp
 .nf
+.if t \{\
+.in 1i
+.ft CW
+\}
   2 3 4 5 6 7       30 40 50 60 70 80 90 100 110 120
 -------------      ---------------------------------
 0:   0 @ P \` p     0:    (  2  <  F  P  Z  d   n   x
@@ -143,6 +148,10 @@
 D: \- = M ] m }
 E: . > N ^ n ~
 F: / ? O _ o DEL
+.if t \{\
+.in
Quoted 9 lines

man7/ascii.7 2009-02-11 12:34:35.000000000 +0300 line 157

Quoted 6 lines
man7/ascii.7 2009-02-11 12:34:35.000000000 +0300 renamed from man7/ascii.7 2009-02-09 05:14:24.000000000 +0300 +2 -0
+.ft P
+\}
 .fi
 .SH NOTES
 .SS History

Other than the points noted above, I have applied the patch for man-pages-3.19.

Thanks!
--
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]

#6 lore raw

Hi Kir,

Quoted 4 lines

BTW I have overlooked that there's a git repo available for man-pages; I though if it exists it should be noted at
http://www.kernel.org/doc/man-pages/patches.html page so I looked no further. I suggest you to add a note about git repo to it.

Good point. I had updated the downloads page to mention the git repo, but not the patches page. Fixed now.

Cheers,

Michael

Signature · 9 lines
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
git://git.kernel.org/pub/scm/docs/man-pages/man-pages.git
man-pages online: http://www.kernel.org/doc/man-pages/online_pages.html
Found a bug? http://www.kernel.org/doc/man-pages/reporting_bugs.html
--
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