MFC r319836:

stat(1): sort flags in the DESCRIPTION section

-x's description should come after -t's description.

MFC r319834,r319841,r320723,r320724:

r319834:

Write up some basic tests for readlink(1)

The tests exercise -f (f_flag), -n (n_flag), and no arguments (basic).

r319841:

Add initial tests for stat(1)

Testcases for -H, -L, and -f haven't been implemented yet, in part due
to additional complexity needed to validate the features:
* -H and -f will require an external "helper" program to display/modify
the state/permissions for a given path.
* -L is being covered partially via the -n testcase today.

r320723:

Use %e instead of %d with x_output_date(..)

stat -x doesn't 0-fill days so %d is inappropriate. %e is correct.

MFC with: r319841

r320724:

:l_flag:: be more aggressive when normalizing whitespace

Save output from ls -ldT and stat -l, then normalize all repeating whitespace using
sed to single column spaces.

This makes the test flexible with single-digit days, etc, similar to r320723. This
approach is just a bit more of a hammer approach because of how the columns are
ordered/spaced in both ls and stat.

MFC with: r319841

Copy head (r256279) to stable/10 as part of the 10.0-RELEASE cycle.

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

Remove duplicate -l description.

Submitted by: Rainer Hurling <rhurlin@gwdg.de>
MFC after: 1 week

Bring in the change from NetBSD 1.28:

"\\ -> \e"

Obtained from: joerg@NetBSD.org

Bump .Dd because we're now up to date with the latest NetBSD version

Bring in the following changes from NetBSD:

1.21
"Document the flags displayed by the default format, and mention their short
names. From espie@openbsd via jmc@openbsd."

1.24
"Fix three variable names.
From Todd T. Fries via Jason McIntyre."

Obtained from: wiz@NetBSD.org (previous 2)

1.25
"Be consistent: document the birthtime field of struct stat for
the "B" field specifier."

Obtained from: reed@NetBSD.org

1.26
"Drop trailing space."

Obtained from: wiz@NetBSD.org

1.27
"Since we have st_birthtime in struct stat, it is in default display."

Obtained from: enami@NetBSD.org

Purposely skipping the following revisions:
1.22 NetBSD-specific change
1.23 Removal of license clauses 3 and 4, already handled by imp
in our r203971

Bring in the change from NetBSD 1.20:

"Make sentence easier to parse. From jsing@openbsd via jmc@openbsd."

Obtained from: wiz@NetBSD.org

Bring in the changes from NetBSD 1.16 that we did not already have.

"Some fixes from jmc@openbsd."

Obtained from: wiz@NetBSD.org

Bring in the changes from NetBSD 1.13 that we did not already have, with
some differences.

"Sort options. Use more mdoc macros. Some nit fixes. Bump date."

Obtained from: wiz@NetBSD.org

Bring in the change from NetBSD 1.12:

"document default format."

Obtained from: yamt@NetBSD.org

Bring in the update from NetBSD 1.19, the documentation of readlink -f

"PR/34662: martijnb at atlas dot ipv6 dot stack dot nl: readlink doesn't
grok -f, and there's no alternative (+fix)

Patch applied with minor tweak (%y -> %R, as it was already taken) plus
some nits from myself. Thanks!"

Obtained from: elad@NetBSD.org

Add my own documentation for the change in our r216196, aka NetBSD's 1.18
For -L if stat(2) fails, fall back to lstat(2).

.Dd purposely not bumped because more changes are coming.

stat: Allow -f %Sf to display the file flags symbolically.

I have changed the patch slightly to show '-' if there are no flags just
like ls -ldo does.

PR: 124349
Submitted by: Ighighi
MFC after: 1 week

The NetBSD Foundation has granted permission to remove clause 3 and 4
from their software.

Obtained from: NetBSD

The referenced section name is 'Formats', not 'FORMATS'.

Add some more examples. It always takes me a long time to find the S
modifier (-t is ignored without it).

MFC after: 1 week

Markup and wording fixes.

Approved by: re (blanket)

Note when 'stat' appeared in FreeBSD.

Assorted mdoc(7) fixes.

Markup bits.

Approved by: re (blanket)

Bring in NetBSD's version 1.11, which includes documenation for the new
inode birthtime display, and quite a bit of mdoc cleanup, which brings
it much more in line with our mdoc style.

Approved by: re (bmah)
Obtained from: Andrew Brown <atatat@NetBSD.org> (content), Grant Beattie <grant@NetBSD.org> (mdoc)

A much better description of the -q option.

Obtained from: Andrew Brown <atatat@NetBSD.org>

A cooperative effort...

1. Update the code to the latest from NetBSD, which includes:
* A new command line option to suppress stat(2) errors
* Output is now done via stdio
* Fixes for bitwise OR'ing of letters

2. Andrew from NetBSD merged in our own Johan's readlink patches.

3. Andrew also merged in some brucifications.

I made some small contributions to the header cleanup, and tried
to generally improve the overall style(9)'ishness. I also documented
the new -q option and added the *LINKS to the Makefile.

All responsibility for mistakes in merging the contributions
from the above is mine.

Obtained from: Andrew Brown <atatat@NetBSD.org>, bde, johan

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

Virgin import of NetBSD's stat(1)