From nobody Wed Nov 12 09:43:53 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 4d5z4T2YKpz6Gjr5; Wed, 12 Nov 2025 09:43:53 +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 4d5z4T20qBz3MVl; Wed, 12 Nov 2025 09:43:53 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1762940633; 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=WDkVbBHT9Ut+XOrNS5aTa5Qctpd9WgG2gFF6c6m9YRU=; b=XFzxPo7XtE8wjqM0akpg/Eu+wcA52B3uivEEoxYIPYthKEkgopeLrFoQsaSgF+mafn3Qfx IZQ2jgH3xy9HQfhD8D1YZM+u9NhLS7i+NJeBcv8xJczBlwTDOcCL0joF+vuW3/F3hxYZep l1aSPUNW0GrjD5HxIW2a6CwTZE9kASU+rKKqOcmcMS+IIY7/Kf9pbUtYTR4G3EZawCLKQN aMQcsvgqeWbLu6GjmQ1TBqrhLdE1YPt5DFZIqT2b2m+AV9hbJf+rH3YmuQqESZYQbIEDky 990UMy2wqi7eFJ4gh8lH3pb7UPA3yWZp4rnSRNN06azkBt6vGWB0wcl7joV/lg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1762940633; 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=WDkVbBHT9Ut+XOrNS5aTa5Qctpd9WgG2gFF6c6m9YRU=; b=o+2X19+kYndnVV67MkeF2BN2NFplAMElCD7E2BQw6yBDLQFq5Gw/QnaGM0antQUREkMWIn SX8xO4ap8pQCYwTbst1/PfLE1WntjM2D1vdUk1xWlC0rf/syerzz8SCICgqqcx0DG0wbB5 f2L3fO/OFtjoYCL5NEyOLnK+zca3Glk7OJsnPSSUexRWjdiZR/0/3iqVmUzGzFC4Z4re+H qE1AMpDLUq0M8CC0R7QgUjhLJyDrNQxDq196c2t0A9Q0CWWSyKJ83VrygqJLpArvZwlmSV MWeGjXM2Bw07yuTCYEm2zLrUMN0gsNx9cX082Ku7/1JqEFxmB/OCp0vkzGFXzA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1762940633; a=rsa-sha256; cv=none; b=Y6lKglHM3Znpv5q6ElyXYAmSyLKBXoo1CxngDb0+8EGTSFgBRxkthezpjOhWjRkGNGFfxl 9zwEFO1SRV66a8Y7ZRiF9pTrIV8L7w+8W3+v7sUPbUlvRAXJWCK7KUEISBgrbP5OF5ZN0n CvVRisE6jLKlv63R8097nuxOKCEiz+B4mAiq38yxfgsISvqomVw4+L1Jd7aCrSqliSw/0V mS4gagjcu7eLLupdyaM8fhQeTz1HUPMZpNSCt6y5Yj+QvsO9D3n6YF3VPh1zIcrGqmaw8O EiC5RyAzvvm6EcxYk2k/IGxiCjcCofKp1Rsa3KpiFHZ9lc4ikYgdUG1MPFYJBA== 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 4d5z4T1YY0zCmY; Wed, 12 Nov 2025 09:43:53 +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 5AC9hrxE077602; Wed, 12 Nov 2025 09:43:53 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 5AC9hrnc077599; Wed, 12 Nov 2025 09:43:53 GMT (envelope-from git) Date: Wed, 12 Nov 2025 09:43:53 GMT Message-Id: <202511120943.5AC9hrnc077599@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: 6c185061a63b - stable/14 - 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/14 X-Git-Reftype: branch X-Git-Commit: 6c185061a63b6db6676c6a24e6bf0802774a07fa Auto-Submitted: auto-generated The branch stable/14 has been updated by 0mp: URL: https://cgit.FreeBSD.org/src/commit/?id=6c185061a63b6db6676c6a24e6bf0802774a07fa commit 6c185061a63b6db6676c6a24e6bf0802774a07fa 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:49 +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 .