From nobody Wed Nov 05 12:37:49 2025 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4d1lGQ2HLCz6GDbK; Wed, 05 Nov 2025 12:37:50 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4d1lGQ0XsPz40wb; Wed, 05 Nov 2025 12:37:50 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1762346270; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=LuagQu/XH/CNLTbK+vpH7NFmgx7MRGn0uVo1PIVDnsU=; b=anvWlEFGIsOWJg8bEb+Q08fyRJuiBYOPgLSc9K8AmRGFbl98DC7A1Hfr4/128FS7jVzu8j Dlf5JEyXmQCi4++TvAEvgEC1QiHNeZtd6HyB1yp9RHW810xb4yhd6pFmzdUHbOcGy2YBgZ 4ka9WMkGDqTG9zhiZPMtVQ7u/beJIcMkzbZsY+8wY3R8Tp306fa81yxESYwqQbayIijKMV xUzLXvY9V4eGwF1EXr5Z98iqMtHn2dbQMquC1oP+mS1+JIVyuJ24iqh/yd5so9gqUqJFPN PaMwDi9Ep/a8yRQaXgiRCaglVb0sKZ2+XfHbQN55YFoiOsLzHB2W33oHycp9qA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1762346270; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=LuagQu/XH/CNLTbK+vpH7NFmgx7MRGn0uVo1PIVDnsU=; b=ogzwq/CVfSo+up2zWY7HyhpwKH8IevEZciNXIYykiild+H6yj6V7KlL7szy7pJseJBL9hv kLAKIbI1UGbjFdroy5kH1DiW1B7UVqikMzGbnD0yahd4G6hkR1cVPUtZC41J6dmxX9KZ2v KoopV/o/vLv/fDw/CDLpjAlPCc+AVZHHG+G2gOez48RozRtE6bFqlWQYY37+OQM13rZepm cfZJAkRkOx49MtHY8M6FDoYckuXooB/cJlZvTw+aPlSj3xN3cTfK0Az7rrCwMbesaXMbOA g+syKOijWfjIclIV/Wn8GsN0KrVReCaOchpT0JUQSYpNN1ulDoKXfJx9KJ2f4g== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1762346270; a=rsa-sha256; cv=none; b=X1VHeZCwZCkd0gPFwVtPsHCGxQBw8+SffndM4WYc5lHgVmRJVFaWBREChfw6ys433acHdL El1oa1IR8aXeVduaucDx5gh6zIMqIzTVQLzQ9XtOKighAuCf8kW73xCy849Ehxg4A8owC7 nuJ4Pl67H7y58IqeDI3oFqs5JZscYj4El6KYMrMDKc+8DFcGl9Wph/XDoDNWf43IrCgrZd OOrkvdE96hVSYuOf3yER07gjqYEPSqHp68a1wGGOZEP3WCTSq39A6uo5qtdk6iRjl5SAL9 /5PW0X2Uj57O1Kyj3NmPPsyQtbDQhmtbidC6zQyYitgJQQcNAsH8JH5qS223oA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4d1lGP72vzzkjF; Wed, 05 Nov 2025 12:37:49 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 5A5CbnCZ092756; Wed, 5 Nov 2025 12:37:49 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 5A5Cbn8e092753; Wed, 5 Nov 2025 12:37:49 GMT (envelope-from git) Date: Wed, 5 Nov 2025 12:37:49 GMT Message-Id: <202511051237.5A5Cbn8e092753@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: e878ba8eea72 - main - date.1: Lint with mandoc List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: e878ba8eea7206b3a435338c6eed0e4264e0ce14 Auto-Submitted: auto-generated The branch main has been updated by 0mp: URL: https://cgit.FreeBSD.org/src/commit/?id=e878ba8eea7206b3a435338c6eed0e4264e0ce14 commit e878ba8eea7206b3a435338c6eed0e4264e0ce14 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2025-11-05 12:34:31 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2025-11-05 12:36:35 +0000 date.1: Lint with mandoc Specifically, remove Tn macors, replace Li with Ql, and escape %N to address date.1's rendering issues on man.freebsd.org. PR: 290801 Reported by: jinwookjeongg@gmail.com MFC after: 1 week Sponsored by: Klara, Inc. --- bin/date/date.1 | 35 ++++++++++++++++++----------------- 1 file changed, 18 insertions(+), 17 deletions(-) diff --git a/bin/date/date.1 b/bin/date/date.1 index b86a660a924d..f68892bd408d 100644 --- a/bin/date/date.1 +++ b/bin/date/date.1 @@ -29,7 +29,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd September 1, 2025 +.Dd November 5, 2025 .Dt DATE 1 .Os .Sh NAME @@ -143,7 +143,8 @@ values are .Cm minutes , .Cm seconds , and -.Cm ns No Pq for nanoseconds . +.Cm ns +.Pq for nanoseconds . The date and time is formatted to the specified precision. When .Ar FMT @@ -172,7 +173,7 @@ Obsolete flag, accepted and ignored for compatibility. .It Fl R Use RFC 2822 date and time output format. This is equivalent to using -.Dq Li %a, %d %b %Y \&%T %z +.Ql %a, %d %b %Y \&%T %z as .Ar output_fmt while @@ -194,9 +195,7 @@ and can be specified in decimal, octal, or hex. Print the date and time of the last modification of .Ar filename . .It Fl u -Display or set the date in -.Tn UTC -(Coordinated Universal) time. +Display or set the date in UTC (Coordinated Universal) time. By default .Nm displays the time in the time zone described by @@ -328,7 +327,7 @@ The format string may contain any of the conversion specifications described in the .Xr strftime 3 manual page and -.Ql %N +.Ql \&%N for nanoseconds, as well as any arbitrary text. A newline .Pq Ql \en @@ -468,7 +467,7 @@ will display: .Dl "Sun Jan 4 04:15:24 GMT 1998" .Pp where it is currently -.Li "Mon Aug 4 04:15:24 BST 1997" . +.Ql "Mon Aug 4 04:15:24 BST 1997" . .Pp The command: .Pp @@ -493,29 +492,31 @@ will display the last Friday of the month: .Dl "Fri Aug 29 04:31:11 BST 1997" .Pp where it is currently -.Li "Mon Aug 4 04:31:11 BST 1997" . +.Ql "Mon Aug 4 04:31:11 BST 1997" . .Pp The command: .Pp .Dl "date 8506131627" .Pp sets the date to -.Dq Li "June 13, 1985, 4:27 PM" . +.Ql "June 13, 1985, 4:27 PM" . .Pp .Dl "date ""+%Y%m%d%H%M.%S""" .Pp may be used on one machine to print out the date suitable for setting on another. -.Qq ( Li "+%m%d%H%M%Y.%S" -for use on -.Tn Linux . ) +.Po Use +.Ql "+%m%d%H%M%Y.%S" +with GNU date on +Linux . +.Pc .Pp The command: .Pp .Dl "date 1432" .Pp sets the time to -.Li "2:32 PM" , +.Ql "2:32 PM" , without modifying the date. .Pp The command @@ -591,10 +592,10 @@ flag is compatible with .St -iso8601 . .Pp The -.Ql %N +.Ql \&%N conversion specification for nanoseconds is a non-standard extension. It is compatible with GNU date's -.Ql %N . +.Ql \&%N . .Sh HISTORY A .Nm @@ -615,6 +616,6 @@ flag was added in .Fx 12.0 . .Pp The -.Ql %N +.Ql \&%N conversion specification was added in .Fx 14.1 .