New: dd(1p) manpage contains empty ASCII to EBDIC tables

https://bugzilla.kernel.org/show_bug.cgi?id=215971

Bug ID: 215971
Summary: dd(1p) manpage contains empty ASCII to EBDIC tables
Product: Documentation
Version: unspecified
Hardware: All
OS: Linux
Status: NEW
Severity: normal
Priority: P1
Component: man-pages
Assignee: [email protected]
Reporter: [email protected]
Regression: No

The POSIX standard includes at the end of the OPERANDS section tables displaying "the octal number character values used for the ascii and ebcdic conversions (first table) and for the ibm conversion (second table)."
https://pubs.opengroup.org/onlinepubs/9699919799/utilities/dd.html#tagtcjh_25

In the above HTML edition of POSIX.1-2018, these tables are images, but are generated from troff source. In the man-pages-posix converted manpage dd(1p), the tables are empty; only the titles are present:

```
...
.ce 1
\fBTable 4-7: ASCII to EBCDIC Conversion\fR
.bp
.sp
.ce 1
\fBTable 4-8: ASCII to IBM EBCDIC Conversion\fR
.SH STDIN
...
```

Perhaps the tables could be preprocessed with tbl and included in the manpages?

You may reply to this email to add a comment.

You are receiving this mail because:
You are watching the assignee of the bug.

https://bugzilla.kernel.org/show_bug.cgi?id=215971

Alejandro Colomar (man-pages) ([email protected]) changed:

What |Removed |Added
----------------------------------------------------------------------------
CC| |[email protected]

--- Comment #1 from Alejandro Colomar (man-pages) ([email protected]) --- Hi Ben,

Ideally, we would distribute the original roff(7) POSIX documents, and not convert back again from HTML to man(7).

If POSIX sends (or publishes) their original roff(7) documents, I'll be happy to work with them (In fact, I'd probably completely skip HTML, and add the minimum to make the roff(7) source work as man(7) pages).

Thanks,

Alex

You may reply to this email to add a comment.

You are receiving this mail because:
You are watching the assignee of the bug.

https://bugzilla.kernel.org/show_bug.cgi?id=215971

--- Comment #2 from Ben Fuller ([email protected]) --- Hi Alex,

I was under the impression that the maintainer of man-pages-posix had access to the roff(7) sources:
https://git.kernel.org/pub/scm/docs/man-pages/man-pages-posix.git/tree/README,
but perhaps I misunderstood this. Apparently the sources can be obtained by contacting The Open Group?

You may reply to this email to add a comment.

You are receiving this mail because:
You are watching the assignee of the bug.

https://bugzilla.kernel.org/show_bug.cgi?id=215971

--- Comment #3 from Alejandro Colomar (man-pages) ([email protected]) --- Hi Ben

I guess maybe Michael Kerrisk has the sources; I don't.
<https://www.kernel.org/doc/man-pages/maintaining.html>

And every time I've tried to set up an accout in the open group website, I've found it a nightmare of redirections, logins, and accounts, so I gave up trying.

Sorry :/

Thanks,

Alex

You may reply to this email to add a comment.

You are receiving this mail because:
You are watching the assignee of the bug.

https://bugzilla.kernel.org/show_bug.cgi?id=215971

--- Comment #4 from Ben Fuller ([email protected]) ---
https://bugzilla.kernel.org/show_bug.cgi?id=215971

According to the Austin group, (see Q6:
https://www.opengroup.org/austin/papers/posix_faq.html)
Michael Kerrisk has some nroff pages, but I don't know if that's referring to the ones generated from HTML. Michael, is there any possibility of obtaining the roff sources of these tables?

Ben

You may reply to this email to add a comment.

You are receiving this mail because:
You are watching the assignee of the bug.