From 8f319460b3024c1c73f4853831f55ebddba4d39a Mon Sep 17 00:00:00 2001 From: schwarze Date: Sun, 11 Oct 2015 21:30:02 +0000 Subject: [PATCH] Do not insert whitespace into syntax displays, it's just confusing, except at the one place where it is indeed helpful. Add some missing .Cm macros. Remove some useless escaping, one needless .Xo, and an empty .No. Triggered by a much smaller patch from guenther@. OK jmc@ guenther@ --- lib/libc/time/tzset.3 | 72 ++++++++++++++----------------------------- 1 file changed, 23 insertions(+), 49 deletions(-) diff --git a/lib/libc/time/tzset.3 b/lib/libc/time/tzset.3 index af18bf43650..e5a7cfdb873 100644 --- a/lib/libc/time/tzset.3 +++ b/lib/libc/time/tzset.3 @@ -1,5 +1,5 @@ -.\" $OpenBSD: tzset.3,v 1.20 2013/06/05 03:39:23 tedu Exp $ -.Dd $Mdocdate: June 5 2013 $ +.\" $OpenBSD: tzset.3,v 1.21 2015/10/11 21:30:02 schwarze Exp $ +.Dd $Mdocdate: October 11 2015 $ .Dt TZSET 3 .Os .Sh NAME @@ -58,12 +58,17 @@ The file must be in the format specified in When .Ev TZ is used directly as a specification of the time conversion information, -it must have the following syntax (spaces inserted for clarity): +it must have the following syntax (without whitespace between +.Ar std +and +.Ar offset ) : .Bd -ragged -offset indent .Ar std +.Sm off .Ar offset .Op Ar dst Op Ar offset .Op , Ar rule +.Sm on .Ed .Pp Where: @@ -96,12 +101,9 @@ are allowed. Indicates the value one must add to the local time to arrive at Coordinated Universal Time. .Ar offset -has the form -.Pq spaces inserted for clarity : -.Bd -ragged -offset indent -.Ar hh -.Op : Ar mm Op : Ar ss -.Ed +has the form: +.Pp +.D1 Ar hh Ns Op : Ns Ar mm Ns Op : Ns Ar ss .Pp The minutes .Pq Ar mm @@ -133,15 +135,9 @@ west (which may be indicated by an optional preceding .It Ar rule Indicates when to change to and back from summer time. .Ar rule -has the form (spaces added for clarity): -.Bd -ragged -offset indent -.Ar date -/ -.Ar time , -.Ar date -/ -.Ar time -.Ed +has the form: +.Pp +.D1 Ar date Ns / Ns Ar time , Ns Ar date Ns / Ns Ar time .Pp where the first .Ar date @@ -156,51 +152,29 @@ time is made. .Pp The format of .Ar date -is one of the following (spaces added for clarity): -.Bl -tag -width "M m . n . d" -.It J Ar n +is one of the following: +.Bl -tag -width Ds +.It Cm J Ns Ar n The Julian day .Ar n -.Po -1 \&<\&= -.Ar n -\&<\&= 365 -.Pc . +.Pq 1 <= Ar n No <= 365 . Leap days are not counted; that is, in all years -- including leap years -- February 28 is day 59 and March 1 is day 60. It is impossible to explicitly refer to the occasional February 29. .It Ar n The zero-based Julian day -.Po -0 \&<\&= -.Ar n -\&<\&= 365 -.Pc . +.Pq 0 <= Ar n No <= 365 . Leap days are counted, and it is possible to refer to February 29. -.It Xo M Ar m No . Ar n -.No . Ar d -.Xc +.It Cm M Ns Ar m . Ns Ar n . Ns Ar d Day .Ar d -.Po -1 \&<\&= -.Ar d -\&<\&= 6 -.Pc +.Pq 1 <= Ar d No <= 6 of week .Ar n -.Po -1 \&<\&= -.Ar n -\&<\&= 5 -.Pc +.Pq 1 <= Ar n No <= 5 of month .Ar m -.Po -1 \&<\&= -.Ar m -\&<\&= 12 -.Pc , +.Pq 1 <= Ar m No <= 12 , where week 5 means .Do the last -- 2.20.1