bind.2: add references to specific protocol families

Referring the reader to "the manual entries in section 4" was too
unspecific to be useful, as that section contains device drivers as
well.

Document EINVAL for out of range socket address lengths.

This is what happens, but wasn't documented. Applies to bind(2),
connect(2), and send(2).

Remove workaround for ancient HTML generation code.

Sort errors. Bump date for previous.

Note that bind(2) can fail with EAFNOSUPPORT. The description of why is
taken from the connect(2) manpage.

Consistently use `.Brq Dv XXX' across syscalls man pages, for NAME_MAX
and PATH_MAX.

Remove unnecessary parentheses. Add comma in enumeration.

Document that binding local sockets now honors the user's umask, why this
was done and that this behavior is not supposed to be portable. Filling
under the security considerations section because code not following the
guidelines given here can be "less secure".

\- is a minus, not -.

Move UCB-licensed code from 4-clause to 3-clause licence.

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

Use
.In header.h
instead of
.Fd #include \*[Lt]header.h\*[Gt]
Much easier to read and write, and supported by groff for ages.
Okayed by ross.

Mention namelen in DESCRIPTION. From Todd C. Miller/OpenBSD.

Merge the nathanw_sa branch.

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

Remove inclusion of <sys/types.h> from synopsis; it is no longer needed.

Sort sections, sort SEE ALSO, punctuation and miscellanous fixes.

Boring whitespace fixes.

branches: 1.15.6;
EINVAL may be returned when address family mismatches. (from openbsd)

Add a LIBRARY section to system call manual pages. While it's clear that the
libraries contain stubs only (with minor exceptions a la pipe(2)), the purpose
of this section is to provide linkage information.

branches: 1.13.6;
document new bind() restrictions

Last of the .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Wheee!

Reflect the addition of socklen_t.

first pass at fixing up capitalization of function names and
arguments; ensure that each is correct with respect to the
implementation, rather than being correct as per english.

Change occurrences of "UNIX" to .Ux or .At as appropriate.

Manpage fixes from Jochen Pohl. Aligns the prototypes in the SYNOPSIS
section with the actual function declarations. See PR #1589 for details.

merge with lite, keeping most local changes. clean up Ids

Remove description of EINVAL, "The pathname contains a character with the
high-order bit set", as this error is obsolete.

Eventually we may want to add code to some of the "optional" filesystems
(msdosfs, etc.) that checks for illegal characters. At that time it would
be appropriate to reintroduce this error with appropriate text. Perhaps
"The pathname contains a character that is not valid for filesystem type".

Use symbolic names {NAME_MAX} & {PATH_MAX} instead of 255 and 1023 in
description of ENAMETOOLONG error.

Use "Er" for argument to -width in the lists in the ERROR sections --- so
the formatting is consistant.

Clean up manpages:
Use .Fn rather than .Nm macro in HISTORY and STANDARDS sections.
Use .At and .St macros instead of spelling out "Version 6 UNIX",
"IEEE 1003.1-1988 (POSIX)", etc.

Add RCS indentifiers.

branches: 1.1.1;
Initial revision