Format structures with tbl(1) to improve alignment in proportional-width font text.
Reported-by: "G. Branden Robinson" <g.branden.robinson@xxxxxxxxx>
Signed-off-by: Alejandro Colomar <alx.manpages@xxxxxxxxx>
---
Hi Branden,
I feel this v3 is good enough to propose it as an actual patch to the list.
v3:
- Use .nf/.fi for comments, but not for types and member names.
- Specify 2 spaces as the distance between types and member names,
and between member names and the comments.
- Disallow hyphenating some identifier, to avoid confusion.
Cheers,
Alex
man2type/open_how.2type | 27 ++++++++++++++++++++++++---
1 file changed, 24 insertions(+), 3 deletions(-)
diff --git a/man2type/open_how.2type b/man2type/open_how.2type
index e058c08dc..01446a56b 100644
--- a/man2type/open_how.2type
+++ b/man2type/open_how.2type
@@ -13,9 +13,30 @@ Linux kernel headers
.B #include <linux/openat2.h>
.PP
.B struct open_how {
-.BR " u64 flags;" " /* " O_ "* flags */"
-.BR " u64 mode;" " /* Mode for " O_ { CREAT , TMPFILE "} */"
-.BR " u64 resolve;" " /* " RESOLVE_ "* flags */"
+.PD 0
+.TS
+l lB2 lB2 l1 lX.
+\& u64 flags; /* T{
+.fi
+.BR O_ *
+flags */
+.nf
+T}
+\& u64 mode; /* T{
+.fi
+Mode for
+.BR \%O_ { CREAT , TMPFILE }
+*/
+.nf
+T}
+\& u64 resolve; /* T{
+.fi
+.BR RESOLVE_ *
+flags */
+.nf
+T}
+.TE
+.PD
/* ... */
.B };
.fi
--
2.36.1
