Re: [PATCH 2/5] tm.3type: align ranges

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

 



Hi наб,

On 7/19/22 03:56, наб wrote:
This, to me, makes these much more readable

Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@xxxxxxxxxxxxxxxxxx>

I like the concept of the commit, but I wonder if we can do it in a better way. I was wondering specifically about moving the ranges to before the short description, so that they would be aligned naturally, without needing so much whitespace.

What would you prefer?

Rendered:

[
SYNOPSIS
       #include <time.h>

       struct tm {
           int  tm_sec;    /* [0, 60] Seconds */
           int  tm_min;    /* [0, 59] Minutes */
           int  tm_hour;   /* [0, 23] Hour */
           int  tm_mday;   /* [1, 31] Day of the month */
           int  tm_mon;    /* [0, 11] Month (January = 0) */
           int  tm_year;   /* Years since 1900 */
           int  tm_wday;   /* [0, 6] Day of the week (Sunday = 0) */
           int  tm_yday;   /* [0, 365] Day of the year (Jan/01 = 0) */
           int  tm_isdst;  /* Daylight savings flag */
       };
]

Cheers,

Alex

---
  man3/tm.3type | 12 ++++++------
  1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/man3/tm.3type b/man3/tm.3type
index 8ae3a531c..daf75e2c1 100644
--- a/man3/tm.3type
+++ b/man3/tm.3type
@@ -14,16 +14,16 @@ Standard C library
  .B #include <time.h>
  .PP
  .B struct tm {
-.BR "    int  tm_sec;" "    /* Seconds [" 0 ", " 60 "] */"
-.BR "    int  tm_min;" "    /* Minutes [" 0 ", " 59 "] */"
-.BR "    int  tm_hour;" "   /* Hour [" 0 ", " 23 "] */"
+.BR "    int  tm_sec;" "    /* Seconds          [" 0 ", " 60 "] */"
+.BR "    int  tm_min;" "    /* Minutes          [" 0 ", " 59 "] */"
+.BR "    int  tm_hour;" "   /* Hour             [" 0 ", " 23 "] */"
  .BR "    int  tm_mday;" "   /* Day of the month [" 1 ", " 31 "] */"
-.BR "    int  tm_mon;" "    /* Month [" 0 ", " 11 "] (January = " 0 ") */"
+.BR "    int  tm_mon;" "    /* Month            [" 0 ", " 11 "] (January = " 0 ") */"
  .BR "    int  tm_year;" "   /* Years since 1900 */"
  .BR "    int  tm_wday;" \
-"   /* Day of the week [" 0 ", " 6 "] (Sunday = " 0 ") */"
+"   /* Day of the week  [" 0 ", " 6 "]   (Sunday = " 0 ") */"
  .BR "    int  tm_yday;" \
-"   /* Day of the year [" 0 ", " 365 "] (Jan/01 = " 0 ") */"
+"   /* Day of the year  [" 0 ", " 365 "] (Jan/01 = " 0 ") */"
  .BR "    int  tm_isdst;" "  /* Daylight savings flag */"
  .B };
  .fi

--
Alejandro Colomar
<http://www.alejandro-colomar.es/>

Attachment: OpenPGP_signature
Description: OpenPGP digital signature


[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux