- Copy stable/10 (r259064) to releng/10.0 as part of the
10.0-RELEASE cycle.
- Update __FreeBSD_version [1]
- Set branch name to -RC1

[1] 10.0-CURRENT __FreeBSD_version value ended at '55', so
start releng/10.0 at '100' so the branch is started with
a value ending in zero.

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

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

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

Fix typo in example getopt(1) script: $i vs $1 [1]
While here apply style hammer.

PR: docs/154289 [1]
Submitted by: Jamie Landeg Jones <jamie@bishopston.net>
MFC after: 1 week

mdoc: drop redundant .Pp and .LP calls

They have no effect when coming in pairs, or before .Bl/.Bd

Fix an error in the EXAMPLES section of getopt(1), which is based on
the same fix present in NetBSD.

Note: the getopt man page contains more antique information like this.
An overhaul of the man page and/or sync with NetBSD would be the right
thing to do. But since this is out of the scope of the PR, I'll leave
it as it is for now.

PR: docs/133118
Submitted by: Oleg A. Mamontov (oleg at mamontov dot net)
Discussed with: jilles@
MFC after: 2 weeks

Revert most part of 200420 as requested, as more review and polish is
needed.

Remove unneeded header includes from usr.bin/ except contributed code.

Tested with: make universe

getopt.c is public domain. Add a comment to that effect.

Remove confusing README.

PR: bin/98911
Submitted by: Jason McIntyre <jmc at kerhand dot co dot uk>
Obtained from: OpenBSD
MFC after: 3 days

Expand *n't contractions.

Sort sections.

Added the EXIT STATUS section where appropriate.

Eliminate macro calls inside literal displays.

Fixed bad example.
Added reference to the getopts(1) shell builtin.

Deal with double whitespace.

Mechanically kill hard sentence breaks.

english(4) police.

ANSIify function definitions.
Add some constness to avoid some warnings.
Remove use register keyword.
Deal with missing/unneeded extern/prototypes.
Some minor type changes/casts to avoid warnings.

Reviewed by: md5

Consistently use FBSDID

Minor nit; return(foo) from main rather than exit(foo).

Use `The .Nm utility'

Remove leaf node WARNS?=2 (that mainly I added). This should
help the GCC3 transition and CURRENT in general.

Warns cleanup (just make main return an int).

mdoc(7) police: join split punctuation to macro calls.

Remove whitespace at EOL.

Include missing header files which define functions for which gcc has
builtins (e.g., exit, strcmp).

MAN[1-9] -> MAN.

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

mdoc(7) police: use certified section headers wherever possible.

getopt and friends are declared in <unistd.h>
getopt returns -1 not EOF.

Remove single-space hard sentence breaks. These degrade the quality
of the typeset output, tend to make diffs harder to read and provide
bad examples for new-comers to mdoc.

mdoc(7) style fixes

PR: docs/13409
Reviewed by: mpp

Add $FreeBSD$ lines to man pages that are missing them to make it
easier for translation teams.

PR: docs/13418
Submitted by: Alexey Zelkin <phantom@cris.net>

$Header$ -> $FreeBSD$

Further backouts and changes to the example.

getopt in bourne shell is in fact hard. Maybe perl isn't *that* bad
after all...

Back out part of previous commit.

Arguments with whitespaces are easy to fix, but in combination with
shell metachars that should not be evaluated it is very hard, probably
impossible to fix without going to a line-oriented solution.

Next time I will believe Henry Spencer when he says "this looks easy
to fix but isn't".

1) Fix the case where a shellscript using getopt is called with a
parameter that has space in it, both in getopt.c and in the manpage
example.

2) Fix the example in the manpage. The set(1) command is required to
return 0 (POSIX 1003.2, section 3.14.11), so you can't test for
getopt's exit status like the example did:

#! /bin/sh
set -- `getopt abo: $*`
if test $? != 0 # wrong, tests for set's exit status, which is
# always zero, no for getopt(1)'s.

Fixes PR bin/5845, which thought it was getopt's fault, but in fact
the manpage was wrong.

I also updated the example to be more useful and updated the BUGS
section.

PR: bin/5845

compare return value from getopt against -1 rather than EOF, per the final
posix standard on the topic.

Cleanup. Boldfaced dashes didn't print at all, also corrected a few
other mdoc(5) usage errors.

Pointed out by: kuku@physik.rwth-aachen.de (Chris Kukulies)

Fix a bunch of spelling errors in a bunch of man pages.

Added README which explains the copyright status of getopt(1)

There was additional cruft at the bottom on the man page.

Added getopt(1) from NetBSD