Re: [PATCH] docs: improve wording and formatting of man page of hwclock

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

 



On 9 November 2014 19:29, Benno Schulenberg <bensberg@xxxxxxxxxxxxx> wrote:
> Signed-off-by: Benno Schulenberg <bensberg@xxxxxxxxxxxxx>
> ---
>  sys-utils/hwclock.8.in |   74 ++++++++++++++++++++++++------------------------
>  1 files changed, 37 insertions(+), 37 deletions(-)

Hi Benno,

Good clean up. While looking the changes I started to wonder would a
bit more formatting make lists better. See an attachment that should
apply on top of your change. If you like the idea just incorporate my
change into yours with Reviewed-by line.

-- 
Sami Kerola
http://www.iki.fi/kerolasa/
diff --git a/sys-utils/hwclock.8.in b/sys-utils/hwclock.8.in
index 0c654a5..0c90135 100644
--- a/sys-utils/hwclock.8.in
+++ b/sys-utils/hwclock.8.in
@@ -452,14 +452,22 @@ when you set the System Time using the
 .B \-\-hctosys
 option.
 .PP
-The timezone value actually consists of two parts: 1) a field
-tz_minuteswest indicating how many minutes local time (not adjusted
-for DST) lags behind UTC, and 2) a field tz_dsttime indicating
-the type of Daylight Savings Time (DST) convention that is in effect
-in the locality at the present time.
-This second field is not used under Linux and is always zero.
-(See also
+The timezone value actually consists of two parts:
+.PP
+.RS
+.PD 0
+.TP
+1)
+a field tz_minuteswest indicating how many minutes local time (not adjusted
+for DST) lags behind UTC, and
+.TP
+2)
+a field tz_dsttime indicating the type of Daylight Savings Time (DST)
+convention that is in effect in the locality at the present time.  This
+second field is not used under Linux and is always zero.  (See also
 .BR settimeofday (2).)
+.PD
+.RE
 
 .SS User access and setuid
 .PP
@@ -613,12 +621,24 @@ in remembering information from one invocation to the next.
 .PP
 The format of the adjtime file is, in ASCII:
 .PP
-Line 1: Three numbers, separated by blanks: 1) the systematic drift rate
-in seconds per day, floating point decimal; 2) the resulting number of
-seconds since 1969 UTC of most recent adjustment or calibration,
-decimal integer; 3) zero (for compatibility with
+Line 1: Three numbers, separated by blanks:
+.PP
+.RS
+.PD 0
+.TP
+1)
+the systematic drift rate in seconds per day, floating point decimal;
+.TP
+2)
+the resulting number of seconds since 1969 UTC of most recent
+adjustment or calibration, decimal integer;
+.TP
+3)
+zero (for compatibility with
 .BR clock (8))
 as a decimal integer.
+.PD
+.RE
 .PP
 Line 2: One number: the resulting number of seconds since 1969 UTC of most
 recent calibration.  Zero if there has been no calibration yet or it

[Index of Archives]     [Netdev]     [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