Copy stable/9 to releng/9.3 as part of the 9.3-RELEASE cycle.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation

date(1): Add "-R" flag to use RFC 2822 date and time output format [MFC]

As stated in the man page, this is equivalent to use "%a, %d %b %Y %T %z"
as the output format while LC_TIME is set to the "C" locale.

This is compatible with date(1) from the GNU core utilities.

This is an MFC of r264968 and r264970.

Copy head to stable/9 as part of 9.0-RELEASE release cycle.

Approved by: re (implicit)

Explain that setting an absolute day value can fail and that the month should
usually be set first when using -v.

Adjust an example that sets the day to 30 before setting the month to 3 in
accordance with this approach as the example would always fail in February!

PR: 147354
MFC after: 2 weeks

Remove stale references to utmp(5) and its corresponding filenames.

I removed utmp and its manpage, but not other manpages referring to it.

Correct the referenced securelevel document, it's now securelevel 7.

Pointed out by: ru

-mdoc sweep.

Note which options are not part of the standards.
Xref locale(1) and bump document date.

Reviewed by: keramida
No Objections: -standards

Expand *n't contractions.

Add the new standard EXIT STATUS section where appropriate.
Sort standard sections in the (documented) preferred order.

/*- or .\"- or #- to begin license clauses.

Scheduled mdoc(7) sweep.

Change the behaviour of `-v' so that, e.g., stepping a month back
on March 31 won't take you to March 2 or 3 (now the result will
be the last day of February.)

In general, now stepping by months from the last days of the current
month A will take you to the very last day of the target month B if
B is shorter than A.

The previous version would just step to March 31 and rely on mktime(3)
to correct the date. Despite its simplicity, such way was counter-intuitive
to users and caused pain to shell script writers.

Noticed by: Igor Timkin <ivt at gamma dot ru>
Approved by: brian
MFC after: 2 weeks

Give the most awesome example of how to parse the output of date
back into epoch time. Everytime I'm asked to do this by someone I
have to spend about ten minutes recreating the same command line.
So record it under examples.

Deal with double whitespace.

Mechanically kill hard sentence breaks.

DESCRIPTION was not updated for the new SYNOPSIS.

Give date(1) a much better SYNOPSIS section which is useful as more than
decoration. Further improvements are welcome, but at least this
is a separate of the various modes of operation date has, as well as
sectioning off the two deprecated options for settimeofday(tz) that
don't even apply to actual operation of date as such, anyway.

Remove clause 3 from the UCB licenses.

OK'ed by: imp, core

Note the Linux required format.

mdoc(7) police: markup laundry.

Add an example to help one manually set the date on one machine taking the out
put from another.

Fix some twelve hour clock braindamage. The range for hours is 0-23 not 1-12.

MFC After: 1 week

s/CMOS/hardware as talked about on cvs-committers.

Suggested by: sheldonh
Approved by: bde
MFC after: 1 day

This is a forced commit, the last commit email was never sent. Nit pick
about the date(1) manual page, describe which clock is set.

PR: 35606

Little nit pick in date(1) manual page, tell users which clock date(1)
sets

PR: 35606

mdoc(7) police:

Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text.
Not only this slows down the mdoc(7) processing significantly, but it also
has an undesired (in this case) effect of disabling hyphenation within the
entire enclosed block.

Remove whitespace at EOL.

Simplify, with the power of new mdoc(7).

Make it clear that the -v option doesn't actually set the date.

PR: 24773
Approved by: nik

Document the restrictions on changing times in high securelevels.

PR: 23502
Submitted by: Robert Boyd <rboyd@pokerspot.com>

Prepare for mdoc(7)NG.

Prepare for mdoc(7)NG.

mdoc(7) police: use the new features of the Nm macro.

Try to clean the manpage up according to the mail from Sheldon
in committers (Message-Id: <72836.964344168@axl.ops.uunet.co.za>).

Also cleaned up a .Pq macro which was causing problems previous
to the original update I made.

Reviewed by: sheldonh
Approved by: jkh

Expand the -r option to support hex. Though undocumented, the -r
option already supported octal. Add a comment to the -r option
in the man page so it's a bit more specific.

Discrepancy brought to my attention by: sasdrq@unx.sas.com
Approved by: jkh

Fix one grammar problem which crept in from rev 1.40 to rev 1.42, and
one mdoc problem from rev 1.40 (unnecessarily populated Nm macro).

Re-worded the description of the -r option

PR: 18792
Submitted by: Bob Johnson <bobj@atlantic.net>
Approved by: Alexander Langer <alex@freebsd.org>

Now, the mdoc fixes, such as:
* remove hard sentence breaks
* use of Fl with Ar if argument available
* Dq -> Sq where better
* Ql -> Dq and Ql -> Fa where better
* include sections to Xr macro
* It Ar .ss -> It Ar ss

As per request by sheldonh and others on IRC, seperate language and mdoc
fixes (very important in this case). Version 1.40 should be discarded.

This version includes the language diffs. To receive them, use
cvs diff [-u] -r 1.39 -r 1.41

Fix several language, style and mdoc improvements (such as correct
usage of .Xr and removal of hard sentence breaks).

PR: 18880
Submitted by: Christian Weisgerber <naddy@unix-ag.uni-kl.de>
Obtained from: OpenBSD (in parts)

Grumble. The previous commit still had the wrong date in the
example. Oct 29 0:30 +3 hours is still Oct 29, no matter what the
DST setting is, and not Oct 30..

Typo fix.

PR: docs/19554
Submitted by: Kazuo Horikawa <horikawa@psinet.com>

Mention the timezone where appropriate (for the -v option).
correct one of the -v options.

Correct confusion and differentiate appropriately between GMT and UTC when
date is launched with the "u" argument. It now operates in the documented
manner.

Fix typo in date man page.

Submitted by: David McNett <nugget@slacker.com>

Change -v so that variences in units of days or less are sensitive to
DST. Explain in more detail what date -v does when mixed with DST.

Previous code suggested broken by: wollman

Correct confusing description of the -r option.

PR: 17250
Submitted by: cjclark@home.com (Crist J. Clark)

Fix various mandoc bugs

Allow the year to be specified with an optional century.

PR: 14472
Reported by: j_guojun@lbl.gov (Jin Guojun)

$Id$ -> $FreeBSD$

Remove obsolete BUGS section which describes something which stopped
being relevant when we ripped out the BSD/VAX code.

Submitted by: Guy Harris <gharris@flashcom.net>

the month and three days are up for -hackers and the 24hrs for -committers.

add a -j flag that tells date not to try to set the date. This allows you
to use date as a userland interface to strptime.

example:
TZ=GMT date -j -f "%a, %d %b %Y %T %Z" "Sun, 08 Nov 1998 02:22:20 GMT" +%s

which is the standard format for Last-modified headers in HTTP requests.

only one to respond: eivind

Various spelling/formatting changes.

Submitted by: Philippe Charnier <charnier@xp11.frmug.org>

Support seconds with -v.
PR: 6308
Submitted by: Max Euston <meuston@jmrodgers.com>

Example "19%y" changed to "%Y" to discourage poor usage.

.Sh ENVIRONMENT VARIABLES -> .Sh ENVIRONMENT

PR: 6599
Reviewed by: phk
Submitted by: Josh Gilliam <josh@quick.net>

Correct use of .Nm and other cosmetics. Add rcsid. Remove unused #inc.

Spelling/typo fixes: (preceeded, friday).

Put [+format] at the end of the usage message.
Make `date -?' output (pretty much) the same as
the man page
PR: 5269

Change example from US to international standard date notation.

Back out suppress '\n' mod.

Add the ability to supress the '\n' at the end of the date printed.

spelling corrections.

PR: docs/4450
Submitted by: josh@quick.net

fix misspelling

Submitted-by: Josh Gilliam

Closes PR:4425

Hint at how to use TZ.
Submitted by: grog@lemis.com

Add "-f fmt date" for specification of the
date using strptime(3).
Suggested by: Michael Smith <msmith@atrad.adelaide.edu.au>

Change mm & dd to MM & DD so that they don't
clash with the month.

Change [-DMHW [+|-]val] to [-v [+|-]val[ymwdHM]]
Support Hours & Minutes
Add -Wall to Makefile

Add [-DWMY] flags for date adjustment.
Discussed with: freebsd-hackers

Fix typo in comment; Document in an example that years beyond 1999
are handled; fix typo in same example.

Revert $FreeBSD$ to $Id$

Make the long-awaited change from $Id$ to $FreeBSD$

This will make a number of things easier in the future, as well as (finally!)
avoiding the Id-smashing problem which has plagued developers for so long.

Boy, I'm glad we're not using sup anymore. This update would have been
insane otherwise.

Merge Lite2 mods, fix incorrect default string, cleanup
use of .Nm macros, and -Wall cleaning.

[HISTORY] command appeared in Version 1 AT&T UNIX
Obtained from: A Quarter Century of UNIX, Peter H. Salus, page 41

Fix 'stutter' in manpage.
The man page for date(1) talks about "a a" maximum, not just
"a" maximum.

Submitted by: Simon Burge <simonb@telstra.com.au> via NetBSD GNATS

Correct the default format info to indicate "%+".

date(1) didn't emit a final newline if the format had been specified
with `+'. This breaks tradition and violates Posix 1003.2.

Discoverd by: luigi@labinfo.iet.unipi.it (Luigi Rizzo)

Added $Id$

Reviewed by:
Submitted by:
Oops, overlooked another typo in this man page.

Reviewed by:
Submitted by:
Correct two typos in the format string usages.

This commit was generated by cvs2svn to compensate for changes in r1556,
which included commits to RCS files with non-trunk default branches.

BSD 4.4 Lite bin Sources