Unify wording for LC_CTYPE in ENVIRONMENT:
* Consistently use "character encoding locale" as suggested by stsp@.
* Resolve various gratuitious wording variations.
OK jmc@.

it seems we hyphenate it set-group-id;
from daniel bolgheroni

fix HISTORY; from Sevan Janiyan <venture37 at geeklan dot co dot uk>;
checked with http://minnie.tuhs.org/cgi-bin/utree.pl?file=V1/man/man1

simplify previous; ok bentley

Switch (non-curses, non-ksh) programs that use COLUMNS to a single idiom.

Previously behaviors were all over the map. This changes them to
use COLUMNS first, and either terminal width or a hardcoded value
(typically 80) as appropriate.

ok deraadt@; man bits ok jmc@

Mark up COLUMNS as an environment variable.

ok jmc@ schwarze@

Support UTF-8: use wcwidth(3) for column adjustment and replace
non-printable Unicode codepoints and invalid bytes with ASCII
question marks. No change for the SMALL version.

Using ideas developed by tedu@, phessler@, bentley@ and feedback from many.
OK yasuoka@ czarkoff@ sthen@.

improve wording.

ok jmc@

slightly reword -f; ok sobrado schwarze

restore the traditional behavior of -f implying -a; apparently Keith Bostic
forgot to restore it when the -f flag was put back on 2nd of September 1989,
after being removed on 16th of August as a consequence of issues getting it
working over NFS, so deviation from traditional UNIX behavior in all BSDs
looks like an historical accident; as a side effect, this change accommodates
behavior of this option to IEEE Std 1003.1-2008 (``POSIX.1'').

joint work with jmc@ (who found the inaccuracy in our implementation),
schwarze@ (who provided a detailed tracking of historical facts) and millert@

ok millert@, schwarze@

revert previous: i was wrong;
thanks thomas klausner for noticing

a pesky comma rendered the text describing how output is sorted relevant
only to the "if more than one operand is given" scenario; replace it
with a full stop and start a new paragraph;

ok millert

expand STANDARDS somewhat; ok millert

use the same format/text, as far as possible, for date strings;
help/ok guenther millert

fix description of -g; from Pascal Stumpf

tweak; ok okan

add support for the (POSIX) -H flag

feedback and ok millert@, sobrado@, jmc@

add an EXIT STATUS section for /bin;

- more opaque removal
- sort the flags list while here

ok martynas tedu

replace ".Ar file ..." with ".Ar" whenever possible.

ok jmc@

remove a sentence from COLUMNS that says nothing; ok otto

updates to IEEE Std 1003.1-2008;

bump the posix reference in STANDARDS to IEEE Std 1003.1-2008, with a few
updates to follow;

remove some duplicate information from the description of -g: this
information is already provided further down the page;

ok sobrado

replace standardized text concerning the exit values of applications
with the right mdoc macros.

more updates on which args do and do not mix (doc only, this time):

- list -f in the -cStu "exclusive group" (we already document that -f
overrides these options)
- note that our implementation of -f differs from posix
- -k and -u do not override each other: those options are not used together

ok sobrado

- make -ln and -nl combinations behave identically. currently -l overrides -n.
behaviour now similar to netbsd/freebsd/solaris.

- make -gn and -ng combinations behave identically: long listing, numeric
group ID, no user ID. currently -g overrides -n. behaviour now similar to
netbsd/solaris.

- allow -m and -x to override -1Cgln (and each other) if specified last.
currently -m and -x can be overriden even if they are specified last.
behaviour now similar to netbsd/freebsd. fixes PR 5785 from
Jacek Masiulaniec.

- update man page to reflect reality.

ls.c diff based on Jacek Masiulaniec's diff from PR 5785, and extended by
sobrado. this work is really a joint effort from sobrado and myself.
i don't know about igor, but this particular diff has nearly killed me...

ok millert otto

convert to new .Dd format;

note some flags which differ in behaviour from posix;
suggested by millert

- consistent STANDARDS blurb
- note which options are extensions to POSIX

discussed w/ deraadt otto millert

small update, now that -g does something; ok millert

Change the -g flag from a no-op to be POSIX conforming. We allow the
-l flag to override -g regardless of its position on the command line
for backwards compat with 4.3BSD. From NetBSD.
OK jmc@, tom@, sobrado@

minor shuffle; from Igor Sobrado and myself

timezone -> time zone

remove whiteout support

- sort options
- sync usage()
- remove unnecessary quoting

-l outputs total always, not just to terminals (netbsd -r 1.50);
-l output is one per line (like -1);
-x also inhibits one per line output;

Use angle bracket macros instead of literal angle brackets. OK jmc@

move example descriptions before the examples themselves

ok jmc

use POSIX description of -L, since it's much clearer;
ok henning@

escape punctuation;
ok deraadt@

-l and -n options display owner, group and other permissions;
from Jonathan Gray via FreeBSD PR 54294;

-h, human readable sizes. from a jonathon gray mail to tech@
ok ian@ millert@

Remove the advertising clause in the UCB license which Berkeley
rescinded 22 July 1999. Proofed by myself and Theo.

- section reorder
- merge COMPATIBILITY into STANDARDS
- kill unneeded Ns macros
- replace reference to itself with .Nm

more .Li

Initial patch.
When you give command examples in a manual page prefix them with
$ command
or
# command

deraadt@ ok

fix the history refs

Remove completely redundant introductory sentences in ENVIRONMENT sections.

- Some section shuffling: conform to the standard order documented in mdoc(7)
- .Sh AUTHOR -> .Sh AUTHORS

Change all option list specifications to ".Bl -tag -width Ds". Most man
pages just needed their -width parameter tweaked to "Ds", which provides
a nice width of 6 constant characters. For consistency more than anything.

Add some rudimentary EXAMPLES sections and standardize the way we display
existing EXAMPLES sections.

oops, what was i thinking?

un .Xr chflags

Change the second sentence a bit so it doesn't seem like you're reading the
same thing twice; noticed by angelos@, but no beer for him yet. :-)

- For consistency, `super-user' -> `superuser' in all cases.
- Some punctuation fixes.
- Some `id' -> `ID'.

Correct the HISTORY section to note that this command appeared in Version 5
of AT&T UNIX, not Version 6. Verified by strings(1)'ing a .dsk file (PDP-11
executable) containing the v5 sources, obtainable at gatekeeper.dec.com in the
directory /pub/DEC/sim/software. Idea from NetBSD PR/4790.

Remove hard sentence breaks.

Document meaning of `p'-type file (FIFO) in long listing; FreeBSD PR/9117

consistency

start to remove non-escaped trailing whitespace, it can confuse troff; pjanzen@

It's spelled "occurrence". Also a few other minor mods while I'm at it.

improve; kwesterback@home.com, myself

Repair Theo's mayhem, put -o option together again.

remove duplicate description of -1 option

add -x, -p, and -m options, based on netbsd work

always give .Nm macros an argument in SYNOPSIS sections; krw@tcn.net

start killing redundant .Nm macro arguments (mandoc ``remembers'' the first one
it's given)

use .Dq/.Sq macros instead of `` ''s and ` 's (think typesetting and future
processing); kill redundant .Pp macros; other misc fixes

alphabetize SEE ALSO entries and numerically order according to section

First complete sweep of man pages, bin/. Command/function names previously
(incorrectly) capatilized are fixed. Comma splices, hyphenations, SYNOPSIS
cleanups, other miscellaneous typos.

repair

Document BSD4.4 flags support

doc = after socket; deberg@mit.edu

fix .Sh ENVIRONMENT

option 'n' was unused, so let's come up with a feature to use it!!! YEAH!!
add -n (numeric uid/gid), fix some man page errors; tv@pobox.com

update rcsid

s/ENVIRONMENTAL/ENVIRONMENT/

branches: 1.1.1;
Initial revision