From nobody Wed Nov 12 09:43:38 2025 X-Original-To: dev-commits-src-branches@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 4d5z4B2m2kz6Gk3B; Wed, 12 Nov 2025 09:43:38 +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 4d5z4B2CNxz3Lw4; Wed, 12 Nov 2025 09:43:38 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1762940618; 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=PKUhKgnb4S4PFCv1M/CxAljPHnD3dpyDjQjq74caxsU=; b=fVyYkkhAGMIt9MYu8hvMf9O+XXj3CnyDFMT/otW1/WZGZ5yCekQGhN//Q1V4nWJFrTVU3m jZMSRerjs9EIwVVRio5KPpMPhQ7g1fCvL++H4wqwCEGY/wVy/1WLzg4tSCbIfsMLXjE2ei qO5cZpt0yhdeYIse3u10V+vmp+q2v1iJPQve+9QiCu2vIVqGa7B4+eOHmf0mLjX2LO5WtU /CZ2l9z/JN2LIMQxQhQrDz9cLc9jboKc2Ur7Ai3DzFqdsAw6yedt8ntEYe+Bxo/eBE4Opd Se6GEjZwafhwmvlwZC0if/I1+remRU+DuEpN1WE+dVr3jwCsNs540ImTiJ7bmA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1762940618; 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=PKUhKgnb4S4PFCv1M/CxAljPHnD3dpyDjQjq74caxsU=; b=QsrfrT7ZiDAJwn4CbG/8mOmbX5LD501JjoVAoi6gUVgVwWJzqjhIJdZSXFEx9/gOSymYty YNkUqAXGT0oJ07S5+nFJASaaFFDjixLbIWq8oYS8lPzxKrKH8eUZ2/HLI7I4V+ZnhPPp3h 8l4gTv8XLGHllq1dMA+8giZNUjcWfmwspIdifHhimiZbJVxmnU0m/hGYV538YTNcf5cYVO I9rwU+TLx39dKuBEsdK75VHr68f78GQG5s2d7GWZqEtcy9iHtnJ3aPLlAtKnjT0QSuniR3 oJRH8lRkZtiyF4ORc2QNmN3xTa+aYk3B93IQJnENvaiiw2U8JX83/AGMeUJbgg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1762940618; a=rsa-sha256; cv=none; b=uYcw+u+KNLRuNn8yUs+plom4/tgDsRmuXXjL0xDkQUtkO4IyPv5iihj38cgXlgCkSPm+/F yEd/8rn5ruiTJwlTiNJCLk7pdoH4CBa6Gc9vEeRwdIwuVtgKQcYoDTunDQbPqnnSTPDRaJ /cgtxIKtVMyweNdZY7w0Uc0hc+sHIHKCB6vordpXsR7WBqFj+Iawf2Zv37DiBQGpZzcQPQ zsfBkzvVjSsEWyv8PCmyIZcxCjtOZGtJ/UzThQkJwtubiaXrvjfZYyKlbyCAw9t5hTN2++ VoROnHXYnghtKFG4Pnd7AuT9fGARjxCY48uJGyJmDrFfCVL8jCnUKv5XUxU3rQ== 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 4d5z4B1lqvzDVn; Wed, 12 Nov 2025 09:43:38 +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 5AC9hcen077383; Wed, 12 Nov 2025 09:43:38 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 5AC9hcJH077380; Wed, 12 Nov 2025 09:43:38 GMT (envelope-from git) Date: Wed, 12 Nov 2025 09:43:38 GMT Message-Id: <202511120943.5AC9hcJH077380@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 6ef503c80ff3 - stable/15 - date.1: Lint with mandoc List-Id: Commits to the stable branches of the FreeBSD src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-branches List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-branches@freebsd.org Sender: owner-dev-commits-src-branches@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/stable/15 X-Git-Reftype: branch X-Git-Commit: 6ef503c80ff3d5d219b30e63124f704721148a4b Auto-Submitted: auto-generated The branch stable/15 has been updated by 0mp: URL: https://cgit.FreeBSD.org/src/commit/?id=6ef503c80ff3d5d219b30e63124f704721148a4b commit 6ef503c80ff3d5d219b30e63124f704721148a4b Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2025-11-05 12:34:31 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2025-11-12 09:43:34 +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. (cherry picked from commit e878ba8eea7206b3a435338c6eed0e4264e0ce14) --- 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 .