Note: This is a beta release of Red Hat Bugzilla 5.0. The data contained within is a snapshot of the live data so any changes you make will not be reflected in the production Bugzilla. Also email is disabled so feel free to test any aspect of the site that you want. File any problems you find or give feedback here.
Bug 1688744 - sha512sum(1) man page is badly formatted
Summary: sha512sum(1) man page is badly formatted
Alias: None
Product: Red Hat Enterprise Linux 8
Classification: Red Hat
Component: coreutils
Version: 8.0
Hardware: Unspecified
OS: Unspecified
Target Milestone: rc
: 8.0
Assignee: Kamil Dudka
QA Contact: Radka Skvarilova
Depends On: 1681018 1688740
TreeView+ depends on / blocked
Reported: 2019-03-14 10:58 UTC by Jonathan Wakely
Modified: 2019-03-15 17:11 UTC (History)
12 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of: 1688740
Last Closed:
Type: Bug
Target Upstream Version:

Attachments (Terms of Use)
Patch to patch the patch (deleted)
2019-03-14 10:58 UTC, Jonathan Wakely
no flags Details | Diff

Description Jonathan Wakely 2019-03-14 10:58:54 UTC
Created attachment 1543998 [details]
Patch to patch the patch

+++ This bug was initially created as a clone of Bug #1688740 +++

The coreutils-6.10-manpages.patch screws up the formatting of the man page (and the note it adds to the --help output is not proper English anyway).

The rendered man page looks like:

       -t, --text
              read in text mode (default)

              Note: There is no difference between binary and text mode option
              on GNU system.  -z, --zero           end each output  line  with
              NUL, not newline,

              and disable file name escaping

Note that the -z option is not a new item, but continues on from the note, and there's a spurious line break after "not newline,". In the troff source the problem is a missing .TP macro and a missing newline, but the man page appears to be generated by help2man so it's not as simple as fixing the troff.

Please either drop the patch completely (it seems unnecessary to me) or fix the formatting and the grammar.

I've attached a patch for the patch, which moves the "Note:" to the end, so it doesn't mess up the formatting of the --text and --zero options. I also fixed the grammar.

Note You need to log in before you can comment on or make changes to this bug.