s/argumment/argument/ in documentation.

Add a -D option to touch, which acts like the -d option added to
chmod/chown/chgrp (probably others) in the not too far distant past,
and causes the operation to be a no-op if no actual change would be
made (avoiding updating the file's ctime for no reason).

That is, with touch, -D causes no modifying sys call to be made to
a file if that file's atime and mtime are already set to the values
that would be used. A common case for this is when a "-r ref-file"
is also a target file for the operation.

Unfortunately -d was already taken in touch, so next best available is -D.

Add a -R option, which is identical to -r, except that if the reference file
is a symbolic link, the times to use are taken from those of the symbolic
link itself, instead of from the file it references. If the reference file
is not a symbolic link, -R and -r are identical.

This allows the BUGS entry in the manual page to be removed.

Document the -d posix-datetime arg variation, to allow specifying
fractional seconds. (Alternate ways to achieve that for the other
ways of specifying the date and time may be forthcoming in a future
update).

Also add a warning about the (still far) future likely change of
the interpretation of 2 digit years (the coming POSIX standard
contains a similar warning).

While here, clean up wording, some macro usage, etc etc etc...

Update the description of the -t option to bring it in sync with IEEE 1003.1 -2008.

The .SS field of the datetime argument of -t option can have range from 0 to 60
as per the 1003.1 2008 standard. POSIX has removed all mentions of double leap
seconds, therefore the allowed range of seconds is now [0,60].

Also, add an ENVIRONMENT section, as the interpretation of the datetime
argument in -t option depends on the TZ environment variable.

Add an xref for parsedate(3) in SEE ALSO.

ok wiz@

branches: 1.25.12;
Note that -d, -r, and -t are mutually exclusive and only the last one
is used.

While here, alphabetize the other list of r/d/t flags.

Add --date and --reference to SYNOPSIS.

Note that -d flag also precludes historical usage.

Recognize --date and --reference like gnu.

branches: 1.21.2;
Mention option arguments in DESCRIPTION.

add an option to parse human dates.

- Use more consistent wording;
- create separate section, and use `.Ex' macro, for exit status
information.

From patch by Bug Hunting.

Bump date.

branches: 1.18.4;
Sort sections.

-f no longer has effect. from Snader_LB on irc.

branches: 1.16.52;
Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22365, verified by myself.

.Nm does not need a dummy argument ("") before punctuation or
for correct formatting of the SYNOPSIS any longer.

Generate <>& symbolically. I'm avoiding .../dist/... directories for now.

Fix a typo.

branches: 1.12.2;
WARNSify, fix .Nm usage, getopt returns -1 not EOF

Fix typo; `symbolic link' -> `a symbolic link'.

Document new flag -h.

Changed order of STANDARDS and HISTORY subheads to conform with
specification in mdoc(7).

Sync with 44lite2

Correct description of default century (from Peter Seebach; PR#1423).

Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id convention.

Fix spelling errors.

Fix formatting bug.

Add RCS indentifiers.

new touch

branches: 1.1.1;
Initial revision