Subject: bug#74808: date.1: Some remarks and and a patch for editorial changes for this man page

From: Bjarni Ingi Gislason <[email-masked]>
Date: Thu, 12 Dec 2024 02:28:31 +0000

Package: coreutils
Version: 9.5-1+b1
Severity: minor
Tags: patch

   * What led up to the situation?

     Checking for defects with a new version

test-[g|n]roff -mandoc -t -K utf8 -rF0 -rHY=0 -ww -z < "man page"

  [Use "groff -e ' $' <file>" to find trailing spaces.]

  ["test-groff" is a script in the repository for "groff"; is not shipped]
(local copy and "troff" slightly changed by me).

  [The fate of "test-nroff" was decided in groff bug #55941.]

   * What was the outcome of this action?

troff:<stdin>:236: warning: font name 'CW' is deprecated

   * What outcome did you expect instead?

     No output (no warnings).

-.-

  General remarks and further material, if a diff-file exist, are in the
attachments.

-- System Information:
Debian Release: trixie/sid
  APT prefers testing
  APT policy: (500, 'testing')
Architecture: amd64 (x86_64)

Kernel: Linux 6.11.10-amd64 (SMP w/2 CPU threads; PREEMPT)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: sysvinit (via /sbin/init)

Versions of packages coreutils depends on:
ii  libacl1      2.3.2-2+b1
ii  libattr1     1:2.5.2-2
ii  libc6        2.40-4
ii  libgmp10     2:6.3.0+dfsg-3
ii  libselinux1  3.7-3+b1
ii  libssl3t64   3.3.2-2

coreutils recommends no packages.

coreutils suggests no packages.

-- no debconf information
--- date.1	2024-12-12 01:42:56.367791309 +0000
+++ date.1.new	2024-12-12 02:16:06.420857339 +0000
@@ -4,10 +4,11 @@
 date \- print or set the system date and time
 .SH SYNOPSIS
 .B date
-[\fI\,OPTION\/\fR]... [\fI\,+FORMAT\/\fR]
+.RI [ OPTION "]...\& [" +FORMAT ]
 .br
 .B date
-[\fI\,-u|--utc|--universal\/\fR] [\fI\,MMDDhhmm\/\fR[[\fI\,CC\/\fR]\fI\,YY\/\fR][\fI\,.ss\/\fR]]
+.RB [ \-u | \-\-utc | \-\-universal ]
+.RI [ MMDDhhmm [[ CC ] YY ][ .ss ]]
 .SH DESCRIPTION
 .\" Add any additional description here
 .PP
@@ -31,7 +32,7 @@ output date/time in ISO 8601 format.
 FMT='date' for date only (the default),
 \&'hours', 'minutes', 'seconds', or 'ns'
 for date and time to the indicated precision.
-Example: 2006\-08\-14T02:34:56\-06:00
+Example: 2006\-08\-14T02:34:56\(en06:00
 .TP
 \fB\-\-resolution\fR
 output the available resolution of timestamps
@@ -233,19 +234,19 @@ O to use the locale's alternate numeric
 .SH EXAMPLES
 Convert seconds since the Epoch (1970\-01\-01 UTC) to a date
 .IP
-\f(CW$ date --date='@2147483647'\fR
+\f(CR$ date \-\-date='@2147483647'\fR
 .PP
 Show the time on the west coast of the US (use \fBtzselect\fP(1) to find TZ)
 .IP
-\f(CW$ TZ='America/Los_Angeles' date\fR
+\f(CR$ TZ='America/Los_Angeles' date\fR
 .PP
 Show the local time for 9AM next Friday on the west coast of the US
 .IP
-\f(CW$ date --date='TZ="America/Los_Angeles" 09:00 next Fri'\fR
+\f(CR$ date \-\-date='TZ="America/Los_Angeles" 09:00 next Fri'\fR
 .SH "DATE STRING"
 .\" NOTE: keep this paragraph in sync with the one in touch.x
-The --date=STRING is a mostly free format human readable date string
-such as "Sun, 29 Feb 2004 16:21:42 -0800" or "2004-02-29 16:21:42" or
+The \-\-date=STRING is a mostly free format human readable date string
+such as "Sun, 29 Feb 2004 16:21:42 \-0800" or "2004-02-29 16:21:42" or
 even "next Thursday".  A date string may contain items indicating
 calendar date, time of day, time zone, day of week, relative time,
 relative date, and numbers.  An empty string indicates the beginning