Copy stable/9 to releng/9.3 as part of the 9.3-RELEASE cycle.

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

MFC r233648:
Remove trailing whitespace per mdoc lint warning

Approved by: cperciva (implicit)

Copy head to stable/9 as part of 9.0-RELEASE release cycle.

Approved by: re (implicit)

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

Obtained from: NetBSD

Retire the MALLOC and FREE macros. They are an abomination unto style(9).

MFC after: 3 months

s/M_TRYWAIT/M_WAIT/

Xref memguard(9)

Sort sections.

Spelling fixes.

Cross-reference contigmalloc(9).

Back out previous commit due to objections.

Document the change in M_WAITOK semantics.

mdoc(7): Use the new feature of the .In macro.

Rename the section 'locking considerations' into 'context'.
Change the wording in this section to get rid of references to mutexes
and talk about sleeping instead.

Discussed with: jhb@, ru@

Assorted mdoc(7), grammar, spelling, and punctuation fixes.

Approved by: re (blanket)

malloc(9) types can be used to identify multiple allocations.

PR: docs/38618
Approved by: des (mentor)

Forced commit to fill in the fields below for the last commit. Also
bump the date of the man page.

PR: docs/24797
Reviewed by: bde, jake, jhb

Explicitely document the locking requirements for the malloc interface.
While beeing here also correct the following:

- list missing macros in the header
- document MALLOC_DEFINE and MALLOC_DECLARE in the SYNOPSIS section
- document additional include requirements for MALLOC_DEFINE
- M_NOWAIT is not 0 anymore
- remove rotted diagnostic messages

Return bits which were removed in revision 1.28.

Requested by: imp

The .Fn function

Catch up to WAIT/NOWAIT cleanup.

Add required commas that were ommitted in the previous delta; the
SEE ALSO section's list of manual pages must be comma-separated.

Document lock order reversals possible when calling allocation functions
with vnode interlocks held.

Emphasize that users need to be careful with malloc flags versus mbuf
flags.

Remove stale portion in vnode.9 about v_tag. We don't have it anylonger.

Submitted by: Hiten Pandya <hiten@unixdaemons.com>

Caution programmers not to confuse M_DONTWAIT with M_NOWAIT. They
are not the same.

Suggested by: Hiten Pandya <hiten@unixdaemons.com>

Spelling: s/then/than/ where appropriate.

mdoc(7) police: fixed some wording, kill whitespace at EOL.

Add realloc() and reallocf(), and make free(NULL, ...) acceptable.

Reviewed by: alfred

mdoc(7) police: Use the new .In macro for #include statements.

Spelling fix: depreciated -> deprecated.

Remove refernces to M_ASLEEP/asleep/await.

Removed whitespace at end-of-line; no content changes. I simply did
cd src/share; find man[1-9] -type f|xargs perl -pi -e 's/[ \t]+$//'

BTW, what editors are the culprits? I'm using vim and it shows
me whitespace at EOL in troff files with a thick blue block...

Reviewed by: Silence from cvs diff -b
MFC after: 7 days

mdoc(7) police: removed HISTORY info from the .Os call.

mdoc(7) police: Removed extraneous .No call. The .Nm macro in
mdocNG has been fixed to properly handle its arguments so this
was causing the extraneous (undesirable) space.

Prepare for mdoc(7)NG.

Introduce the M_ZERO flag to malloc(9)

Instead of:

foo = malloc(sizeof(foo), M_WAIT);
bzero(foo, sizeof(foo));

You can now (and please do) use:

foo = malloc(sizeof(foo), M_WAIT | M_ZERO);

In the future this will enable us to do idle-time pre-zeroing of
malloc-space.

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.

Bring kernel malloc documentation up to date, including the example.

PR: docs/10059

$Id$ -> $FreeBSD$

Add $Id$, to make it simpler for members of the translation teams to
track.

The $Id$ line is normally at the bottom of the main comment block in the
man page, separated from the rest of the manpage by an empty comment,
like so;

.\" $Id$
.\"

If the immediately preceding comment is a @(#) format ID marker than the
the $Id$ will line up underneath it with no intervening blank lines.
Otherwise, an additional blank line is inserted.

Approved by: bde

Fix some typos and do some minor mdoc cleanup.

Removed occurrences of consecutive repeated words (such as "the the").

M_AWAIT changed to M_ASLEEP

Documentation update for new M_AWAIT flag to kernel malloc, plus revamp
the descriptions of the flags and return value.

Fix argument reversal in example.
PR: 7138
Reviewed by: phk
Submitted by: Robert Watson <robert+freebsd@cyrus.watson.org>

Fix a few typos.

Fixed a missing #include in the synopsis.

Update malloc.9 to reflect new reality.

Add malloc(9) to document the kernel malloc() and free() routines.

Obtained from: NetBSD w/changes to reflect current FreeBSD headers
and diagnostic messages.