[Bug 215971] New: dd(1p) manpage contains empty ASCII to EBDIC tables

[Bug 215971] New: dd(1p) manpage contains empty ASCII to EBDIC tables

[bugzilla-daemon]

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: documentation_man-pages@kernel-bugs.osdl.org
          Reporter: ben@bvnf.space
        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.

[Bug 215971] dd(1p) manpage contains empty ASCII to EBDIC tables

[bugzilla-daemon]

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

Alejandro Colomar (man-pages) (alx.manpages@gmail.com) changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |alx.manpages@gmail.com

--- Comment #1 from Alejandro Colomar (man-pages) (alx.manpages@gmail.com) ---
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.

[Bug 215971] dd(1p) manpage contains empty ASCII to EBDIC tables

[bugzilla-daemon]

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

--- Comment #2 from Ben Fuller (ben@bvnf.space) ---
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.

[Bug 215971] dd(1p) manpage contains empty ASCII to EBDIC tables

[bugzilla-daemon]

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

--- Comment #3 from Alejandro Colomar (man-pages) (alx.manpages@gmail.com) ---
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

-- 
You may reply to this email to add a comment.

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

[Bug 215971] dd(1p) manpage contains empty ASCII to EBDIC tables

[bugzilla-daemon]

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

--- Comment #4 from Ben Fuller (ben@bvnf.space) ---
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

-- 
You may reply to this email to add a comment.

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

Re: [Bug 215971] dd(1p) manpage contains empty ASCII to EBDIC tables

[Alejandro Colomar]

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


-- 
Alejandro Colomar
Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/
http://www.alejandro-colomar.es/