Adding upstream version 4.22.0.upstream/4.22.0

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 269 insertions, 0 deletions

diff --git a/upstream/opensuse-tumbleweed/man1/date.1 b/upstream/opensuse-tumbleweed/man1/date.1
new file mode 100644
index 00000000..8081bac0
--- /dev/null
+++ b/upstream/opensuse-tumbleweed/man1/date.1
@@ -0,0 +1,269 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.48.5.
+.TH DATE "1" "January 2024" "GNU coreutils 9.4" "User Commands"
+.SH NAME
+date \- print or set the system date and time
+.SH SYNOPSIS
+.B date
+[\fI\,OPTION\/\fR]... [\fI\,+FORMAT\/\fR]
+.br
+.B date
+[\fI\,-u|--utc|--universal\/\fR] [\fI\,MMDDhhmm\/\fR[[\fI\,CC\/\fR]\fI\,YY\/\fR][\fI\,.ss\/\fR]]
+.SH DESCRIPTION
+.\" Add any additional description here
+.PP
+Display date and time in the given FORMAT.
+With \fB\-s\fR, or with [MMDDhhmm[[CC]YY][.ss]], set the date and time.
+.PP
+Mandatory arguments to long options are mandatory for short options too.
+.TP
+\fB\-d\fR, \fB\-\-date\fR=\fI\,STRING\/\fR
+display time described by STRING, not 'now'
+.TP
+\fB\-\-debug\fR
+annotate the parsed date,
+and warn about questionable usage to stderr
+.TP
+\fB\-f\fR, \fB\-\-file\fR=\fI\,DATEFILE\/\fR
+like \fB\-\-date\fR; once for each line of DATEFILE
+.TP
+\fB\-I[FMT]\fR, \fB\-\-iso\-8601\fR[=\fI\,FMT\/\fR]
+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
+.TP
+\fB\-\-resolution\fR
+output the available resolution of timestamps
+Example: 0.000000001
+.TP
+\fB\-R\fR, \fB\-\-rfc\-email\fR
+output date and time in RFC 5322 format.
+Example: Mon, 14 Aug 2006 02:34:56 \fB\-0600\fR
+.TP
+\fB\-\-rfc\-3339\fR=\fI\,FMT\/\fR
+output date/time in RFC 3339 format.
+FMT='date', 'seconds', or 'ns'
+for date and time to the indicated precision.
+Example: 2006\-08\-14 02:34:56\-06:00
+.TP
+\fB\-r\fR, \fB\-\-reference\fR=\fI\,FILE\/\fR
+display the last modification time of FILE
+.TP
+\fB\-s\fR, \fB\-\-set\fR=\fI\,STRING\/\fR
+set time described by STRING
+.TP
+\fB\-u\fR, \fB\-\-utc\fR, \fB\-\-universal\fR
+print or set Coordinated Universal Time (UTC)
+.TP
+\fB\-\-help\fR
+display this help and exit
+.TP
+\fB\-\-version\fR
+output version information and exit
+.PP
+All options that specify the date to display are mutually exclusive.
+I.e.: \fB\-\-date\fR, \fB\-\-file\fR, \fB\-\-reference\fR, \fB\-\-resolution\fR.
+.PP
+FORMAT controls the output.  Interpreted sequences are:
+.TP
+%%
+a literal %
+.TP
+%a
+locale's abbreviated weekday name (e.g., Sun)
+.TP
+%A
+locale's full weekday name (e.g., Sunday)
+.TP
+%b
+locale's abbreviated month name (e.g., Jan)
+.TP
+%B
+locale's full month name (e.g., January)
+.TP
+%c
+locale's date and time (e.g., Thu Mar  3 23:05:25 2005)
+.TP
+%C
+century; like %Y, except omit last two digits (e.g., 20)
+.TP
+%d
+day of month (e.g., 01)
+.TP
+%D
+date; same as %m/%d/%y
+.TP
+%e
+day of month, space padded; same as %_d
+.TP
+%F
+full date; like %+4Y\-%m\-%d
+.TP
+%g
+last two digits of year of ISO week number (see %G)
+.TP
+%G
+year of ISO week number (see %V); normally useful only with %V
+.TP
+%h
+same as %b
+.TP
+%H
+hour (00..23)
+.TP
+%I
+hour (01..12)
+.TP
+%j
+day of year (001..366)
+.TP
+%k
+hour, space padded ( 0..23); same as %_H
+.TP
+%l
+hour, space padded ( 1..12); same as %_I
+.TP
+%m
+month (01..12)
+.TP
+%M
+minute (00..59)
+.TP
+%n
+a newline
+.TP
+%N
+nanoseconds (000000000..999999999)
+.TP
+%p
+locale's equivalent of either AM or PM; blank if not known
+.TP
+%P
+like %p, but lower case
+.TP
+%q
+quarter of year (1..4)
+.TP
+%r
+locale's 12\-hour clock time (e.g., 11:11:04 PM)
+.TP
+%R
+24\-hour hour and minute; same as %H:%M
+.TP
+%s
+seconds since the Epoch (1970\-01\-01 00:00 UTC)
+.TP
+%S
+second (00..60)
+.TP
+%t
+a tab
+.TP
+%T
+time; same as %H:%M:%S
+.TP
+%u
+day of week (1..7); 1 is Monday
+.TP
+%U
+week number of year, with Sunday as first day of week (00..53)
+.TP
+%V
+ISO week number, with Monday as first day of week (01..53)
+.TP
+%w
+day of week (0..6); 0 is Sunday
+.TP
+%W
+week number of year, with Monday as first day of week (00..53)
+.TP
+%x
+locale's date representation (e.g., 12/31/99)
+.TP
+%X
+locale's time representation (e.g., 23:13:48)
+.TP
+%y
+last two digits of year (00..99)
+.TP
+%Y
+year
+.TP
+%z
++hhmm numeric time zone (e.g., \fB\-0400\fR)
+.TP
+%:z
++hh:mm numeric time zone (e.g., \fB\-04\fR:00)
+.TP
+%::z
++hh:mm:ss numeric time zone (e.g., \fB\-04\fR:00:00)
+.TP
+%:::z
+numeric time zone with : to necessary precision (e.g., \fB\-04\fR, +05:30)
+.TP
+%Z
+alphabetic time zone abbreviation (e.g., EDT)
+.PP
+By default, date pads numeric fields with zeroes.
+The following optional flags may follow '%':
+.TP
+\-
+(hyphen) do not pad the field
+.TP
+_
+(underscore) pad with spaces
+.TP
+0
+(zero) pad with zeros
+.TP
++
+pad with zeros, and put '+' before future years with >4 digits
+.TP
+^
+use upper case if possible
+.TP
+#
+use opposite case if possible
+.PP
+After any flags comes an optional field width, as a decimal number;
+then an optional modifier, which is either
+E to use the locale's alternate representations if available, or
+O to use the locale's alternate numeric symbols if available.
+.SH EXAMPLES
+Convert seconds since the Epoch (1970\-01\-01 UTC) to a date
+.IP
+\f(CW$ 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
+.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
+.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
+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
+of the day.  The date string format is more complex than is easily
+documented here but is fully described in the info documentation.
+.SH AUTHOR
+Written by David MacKenzie.
+.SH "REPORTING BUGS"
+GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
+.br
+Report any translation bugs to <https://translationproject.org/team/>
+.SH COPYRIGHT
+Copyright \(co 2023 Free Software Foundation, Inc.
+License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
+.br
+This is free software: you are free to change and redistribute it.
+There is NO WARRANTY, to the extent permitted by law.
+.SH "SEE ALSO"
+Full documentation <https://www.gnu.org/software/coreutils/date>
+.br
+or available locally via: info \(aq(coreutils) date invocation\(aq