Bug 215971

Summary:	dd(1p) manpage contains empty ASCII to EBDIC tables
Product:	Documentation	Reporter:	Ben Fuller (ben)
Component:	man-pages	Assignee:	documentation_man-pages (documentation_man-pages)
Status:	NEW ---
Severity:	normal	CC:	alx
Priority:	P1
Hardware:	All
OS:	Linux
Kernel Version:		Subsystem:
Regression:	No	Bisected commit-id:

Description Ben Fuller 2022-05-12 18:15:19 UTC

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?

Comment 1 Alejandro Colomar 2022-05-14 14:52:05 UTC

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

Comment 2 Ben Fuller 2022-05-14 15:04:30 UTC

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?

Comment 3 Alejandro Colomar 2022-05-14 15:12:48 UTC

Hi Ben

On 5/14/22 17:04, bugzilla-daemon@kernel.org wrote:
> 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?
> 

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

Comment 4 Ben Fuller 2022-05-14 18:07:17 UTC

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

On Sat, May 14, 2022 at 15:12:48 +0000, bugzilla-daemon@kernel.org wrote:
> --- Comment #3 from Alejandro Colomar (man-pages) (alx.manpages@gmail.com)
> ---
> I guess maybe Michael Kerrisk has the sources; I don't.
> <https://www.kernel.org/doc/man-pages/maintaining.html>

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