From 15ebd9dc3673862bcac0730b12bbb406722c841e Mon Sep 17 00:00:00 2001
From: Benno Schulenberg <bensberg@telfort.nl>
Date: Mon, 7 Apr 2025 17:14:35 +0200
Subject: [PATCH] blkzone: (man) reduce two overblown tables to legible
 proportions
MIME-Version: 1.0
Content-Type: text/plain; charset=utf8
Content-Transfer-Encoding: 8bit

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 | 44 +++++++++++++++++++---------------------
 1 file changed, 21 insertions(+), 23 deletions(-)

diff --git a/sys-utils/blkzone.8.adoc b/sys-utils/blkzone.8.adoc
index 8456b5e42a..d24a6f5aba 100644
--- a/sys-utils/blkzone.8.adoc
+++ b/sys-utils/blkzone.8.adoc
@@ -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
 
-- 
2.47.3