date.1: Fix some style issues and examples

- Use Cm instead of Ar or Sq for command modifiers of the -v flag.
- Remove unnecessary "Ar ..." from the synopsis. It's not clear what it
  was referring to.
- Add missing arguments to the -f and -v flags.
- Stylize the dot before "ss" with Cm in the default format in the -f
  flag description.
- Set LC_ALL=C in the last example so that the output format of
  date(1) always matches the specified format of the -f flag not matter
  the locale.
- List the -f flag as optional in all usage lines in the synopsis.

MFC after:	3 days
This commit is contained in:
Mateusz Piotrowski 2021-11-03 11:26:46 +01:00
parent 7acd322ebe
commit 00133d5c5e

View File

@ -32,7 +32,7 @@
.\" @(#)date.1 8.3 (Berkeley) 4/28/95
.\" $FreeBSD$
.\"
.Dd June 16, 2021
.Dd November 3, 2021
.Dt DATE 1
.Os
.Sh NAME
@ -46,10 +46,9 @@
.Fl v
.Sm off
.Op Cm + | -
.Ar val Op Ar ymwdHMS
.Ar val Op Cm y | m | w | d | H | M | S
.Sm on
.Oc
.Ar ...
.Op Cm + Ns Ar output_fmt
.Nm
.Op Fl ju
@ -90,7 +89,7 @@ the time may not be changed by more than 1 second.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl f
.It Fl f Ar input_fmt
Use
.Ar input_fmt
as the format string to parse the
@ -103,7 +102,7 @@ provided rather than using the default
.Ar mm Oc
.Ar dd Oc
.Ar HH
.Oc Ar MM Op Ar .ss
.Oc Ar MM Op Cm \&. Ar ss
.Sm on
format.
Parsing is done using
@ -114,24 +113,24 @@ Use
output format.
.Ar FMT
may be omitted, in which case the default is
.Sq date .
.Cm date .
Valid
.Ar FMT
values are
.Sq date ,
.Sq hours ,
.Sq minutes ,
.Cm date ,
.Cm hours ,
.Cm minutes ,
and
.Sq seconds .
.Cm seconds .
The date and time is formatted to the specified precision.
When
.Ar FMT
is
.Sq hours
.Cm hours
(or the more precise
.Sq minutes
.Cm minutes
or
.Sq seconds ) ,
.Cm seconds ) ,
the
.St -iso8601
format includes the timezone.
@ -175,7 +174,13 @@ Print the date and time of the last modification of
Display or set the date in
.Tn UTC
(Coordinated Universal) time.
.It Fl v
.It Xo
.Fl v
.Sm off
.Op Cm + | -
.Ar val Op Cm y | m | w | d | H | M | S
.Sm on
.Xc
Adjust (i.e., take the current date and display the result of the
adjustment; not actually set the date) the second, minute, hour, month
day, week day, month or year according to
@ -199,14 +204,14 @@ and years are in the range 80-38 or 1980-2038.
If
.Ar val
is numeric, one of either
.Ar y ,
.Ar m ,
.Ar w ,
.Ar d ,
.Ar H ,
.Ar M
.Cm y ,
.Cm m ,
.Cm w ,
.Cm d ,
.Cm H ,
.Cm M
or
.Ar S
.Cm S
must be used to specify which part of the date is to be adjusted.
.Pp
The week day or month may be specified using a name rather than a
@ -420,7 +425,7 @@ will display
.Pp
Finally the command:
.Pp
.Dl "date -j -f ""%a %b %d %T %Z %Y"" ""`date`"" ""+%s"""
.Dl "date -j -f ""%a %b %d %T %Z %Y"" ""`LC_ALL=C date`"" ""+%s"""
.Pp
can be used to parse the output from
.Nm