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 r235357,r235358,r235371,r235373,r235376:

Fix various mdoc(7) style nits.

MFC r232350:

Since r199137 namei() returns EINVAL for DELETE and RENAME operations if
the last component of the pathname is ".".

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

Approved by: re (implicit)

mdoc: move remaining sections into consistent order

This pertains mostly to FILES, HISTORY, EXIT STATUS and AUTHORS sections.

Found by: mdocml lint run
Reviewed by: ru

mdoc: order prologue macros consistently by Dd/Dt/Os

Although groff_mdoc(7) gives another impression, this is the ordering
most widely used and also required by mdocml/mandoc.

Reviewed by: ru
Approved by: philip, ed (mentors)

Fix spelling of EACCES.

PR: docs/144112
Submitted by: Alexander Best
MFC after: 3 days

- Update required headers for namei() to add <sys/fcntl.h> and remove
<sys/proc.h>.
- Add RETURN VALUES and ERROR sections for namei()'s error return values.
- Add a missing link to NDHASGIANT.9.

PR: docs/142815, docs/142816
Submitted by: Lachlan Kang (1, 2)
MFC after: 3 days

[mdoc] add missing space before a punctuation type argument.

-mdoc sweep.

Add discussion of Giant, the MPSAFE flag, and NDHASGIANT() to namei(9).

Add a VFS_LOCK_GIANT(9)/VFS_UNLOCK_GIANT(9) man page.

Discussed with: jeff
MFC after: 3 days

Correct a macro name.

PR: 78171
Submitted by: "Wojciech A. Koszek" <dunstan@freebsd.czest.pl>
MFC after: 3 days

Assorted mdoc(7) fixes.

Mass cleanup of the namei(9) manual page.

- Nuke markup indicators for editors.
- Bump the date
- Use mdoc(7) specifiers for marking up defines, etc.
- Update the prototypes
- Flash out the description
- Cleanup english, spelling and grammar
- Update .Xr's
- Add following SEE ALSOs: uio(9), uma(9), vput(9), vref(9)
- Reorder sections to be in agreement with mdoc(7)
- Add FILES section
- Update Copyright and AUTHORS section.

Approved by: des (mentor)

The .Fn function

Mention SAVENAME and SAVESTART in the namei(9) operation flag description
since apparently people were missing that you aren't supposed to access
the name buffer following namei() unless you specify one of these flags.

Pointed out by: green
Obtained from: TrustedBSD Project
Sponsored by: DARPA, NAI Labs

Update function definitions and required include files to reflect
the current state of the system.

Approved by: alfred

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

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: sort SEE ALSO xrefs (sort -b -f +2 -3 +1 -2).

mdoc(7) police: use the Fn macro where appropriate.

Remove duplicate words.

mdoc(7) police: normalize .Nd.

Fixed bitrot in the prototypes for NDINIT and NDFREE.

Prepare for mdoc(7)NG.

Prepare for mdoc(7)NG.

mdoc(7) police: use canonical form of .Dd macro.

Use FreeBSD.org, not freebsd.org, as has been the precedent.

The LOCKPARENT flag is singular. It doesn't work causing complications
is also a singular fact.

Correct the documentation of LOCKPARENT - it does not reliably result in the
parent being locked, but rather plays some hide and seek (does not lock if
dvp == vp).

Also add a BUGS section noting that this is undesired behaviour.

Document NDFREE w/flags, and fix up the description of NOFOLLOW.

mdoc(7)'fy

$Id$ -> $FreeBSD$

Various man page cleanup:

- Sort xrefs
- FreeBSD.ORG -> FreeBSD.org
- Be consistent with section names as outlined in mdoc(7).
- Other misc mdoc cleanup.

PR: doc/13144
Submitted by: Alexey M. Zelkin <phantom@cris.net>

Description of LOCKLEAF said "inode" when it should have said "vnode".

PR: docs/11596
Submitted by: Robert Watson <robert@fledge.watson.org>

Fixed missing headers in synopsis.

Add a manpage for namei().

Markup changes and review by: dfr