]> git.ipfire.org Git - thirdparty/util-linux.git/commit
blkzone: (man) reduce two overblown tables to legible proportions
authorBenno Schulenberg <bensberg@telfort.nl>
Mon, 7 Apr 2025 15:14:35 +0000 (17:14 +0200)
committerKarel Zak <kzak@redhat.com>
Tue, 8 Apr 2025 10:43:36 +0000 (12:43 +0200)
commit15ebd9dc3673862bcac0730b12bbb406722c841e
treeceb983e196d39538b77ce14ced4968a5b7562b3a
parentbae2260168174941454f6b25772848beed0d3207
blkzone: (man) reduce two overblown tables to legible proportions

Before version 2.37, before asciidoctor was used, the first three lines
of the first table looked like this:

       start     Zone start sector
       len       Zone length in number of sectors
       wptr      Zone write pointer position

After the move to asciidoctor, the first three lines of the first table
in the generated man page looked like this:

       ┌────────┬────────────────────────────┐
       │        │                            │
       │start   │ Zone start sector          │
       ├────────┼────────────────────────────┤
       │        │                            │
       │len     │ Zone length in number of   │
       │        │ sectors                    │
       ├────────┼────────────────────────────┤
       │        │                            │
       │wptr    │ Zone write pointer         │
       │        │ position                   │
       ├────────┼────────────────────────────┤

Three to four screen lines for just one line of information!

Reduce the tables to sane proportions again by simply using blocks
of preformatted text.

(The substition of xN for x? is needed because somehow the ? in the
indented text is a special character in groff.)

Signed-off-by: Benno Schulenberg <bensberg@telfort.nl>
sys-utils/blkzone.8.adoc