groff
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[PATCH v3] open_how.2type: ffix


From: Alejandro Colomar
Subject: [PATCH v3] open_how.2type: ffix
Date: Tue, 26 Jul 2022 22:26:44 +0200

Format structures with tbl(1) to improve alignment in proportional-width font 
text.

Reported-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
---

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




reply via email to

[Prev in Thread] Current Thread [Next in Thread]