]> git.ipfire.org Git - thirdparty/util-linux.git/commitdiff
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)
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

index 8456b5e42ac187c957a5ac1a05d871d1d041720a..d24a6f5aba31dc2d58cc9157cc73c9fcb74129ab 100644 (file)
@@ -29,31 +29,29 @@ The command *blkzone report* is used to report device zone information.
 By default, the command will report all zones from the start of the block device. Options may be used to modify this behavior, changing the starting zone or the size of the report, as explained below.
 
 Report output:
-[cols=",",]
-|===
-|start |Zone start sector
-|len |Zone length in number of sectors
-|cap |Zone capacity in number of sectors
-|wptr |Zone write pointer position
-|reset |Reset write pointer recommended
-|non-seq |Non-sequential write resources active
-|cond |Zone condition
-|type |Zone type
-|===
+....
+ start      Zone start sector
+ len        Zone length in number of sectors
+ cap        Zone capacity in number of sectors
+ wptr       Zone write pointer position
+ reset      Reset write pointer recommended
+ non-seq    Non-sequential write resources active
+ cond       Zone condition
+ type       Zone type
+....
 
 Zone conditions:
-[cols=",",]
-|===
-|cl |Closed
-|nw |Not write pointer
-|em |Empty
-|fu |Full
-|oe |Explicitly opened
-|oi |Implicitly opened
-|ol |Offline
-|ro |Read only
-|x? |Reserved conditions (should not be reported)
-|===
+....
+ cl    Closed
+ nw    Not write pointer
+ em    Empty
+ fu    Full
+ oe    Explicitly opened
+ oi    Implicitly opened
+ ol    Offline
+ ro    Read only
+ xN    Reserved conditions (should not be reported)
+....
 
 === capacity