is undefined.  Add a warning to that effect.  OK deraadt@ jmc@

explaining of "what a C string is", and make it more clear that these
functiosn BEHAVE EXACTLY LIKE snprintf with "%s"!  (anyone who wants
to write a 'strlcpy considered harmful' paper should probably write a
'strlcpy and snprintf considered harmful' paper instead).
note to those from other projects reading this commit message: It would
be very good if this new manual was picked up in your project.
ok jmc millert krw

smaller improvements; jmc@ and nicm@ both ask me to get this in because
further tweaking will be easier in-tree

- avoid first person.
ok jmc

where applicable.

people to bundle this code.

o) remove extra space in the end of line;
o) remove extra blank lines in the end of file;
o) remove .Pp before .Ss;
o) CAVEAT -> CAVEATS;
o) fix usage of .Fa;
o) <blank-line> -> .Pp;
o) wrap long lines;
millert@ ok

will not NUL terminate either.

From ianm@kashmir.cit.nepean.uws.edu.au.

breaks and getting rid of short lines, making these files easier to work with.

Clarify point about always NUL-terminating.

.Li ... -> \&...

- Sort xrefs by section, and then alphabetically.
- Add missing commas between xref items.
- Remove commas from the last xref entry.
- Remove duplicate entries.