Man page displays incorrectly in zstd-1.5.7

[debohman]

Describe the bug
This version of the man page does not display the synopsis, and outputs the following diagnostics:

/usr/bin/tbl:<standard input>:9: unrecognised format `\'
/usr/bin/tbl:<standard input>:9: giving up on this table

To Reproduce
Steps to reproduce the behavior:

man zstd

Expected behavior
Expected the man page to work without error.

The issue appears to begin on line 5 of the man page source. If you delete lines 5, 6 and 8, the page displays properly without error, although there is still a formatting problem on the original line 7 (now 5). I changed line 5 to:

\fBzstd\fR [\fIOPTIONS\fR] [\-|\fIINPUT\-FILE\fR] [\-o \fIOUTPUT\-FILE\fR]

Also, the man page still displays on the final line:

zstd 1.5.6                                      October 2024                                         ZSTD(1)

Desktop (please complete the following information):

• OS: macOS
• Version 10.12.6

[Cyan4973]

Thanks for reporting the issue @debohman !

man pages have been updated in #4302.

They'll fix the version issue, but I'm surprised to learn there also was a formatting issue, and wonder if the new versions behave better on your system, as I don't experience any issue locally.

[debohman]

I cherry-picked 6af3842, and the man page displays fine now. I am using the stock man, which uses the stock tbl and groff to generate the viewed manual page. Perhaps there has been a change to the tbl formatting?

[Cyan4973]

No idea, unfortunately.

The zstd man page is itself automatically generated from a markdown source zstd.1.md,
so there is room here for some slight interpretation difference between the generator and the reader.

Glad 6af3842 fixed the issue,
unfortunately we can't change the commit hash of the tag now.

[debohman]

No worries. I grabbed your commit on top of v1.5.7.