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 r235693:

Typo and mdoc(7) style fixes.

PR: 168117

MFC r235319:

Remove duplicate words in mdoc(7) pages.

PR: 167810

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

Approved by: re (implicit)

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)

Mark lists as in the rest of section 9 manpages.

Submitted by: Joel Dahl (mostly)

Mdoc Janitor:

* Fix hard sentence breaks in VFS_*(9) and VOP_*(9) manual pages.

mdoc(7): Fix common mistakes made in the SEE ALSO section.

Document VOP_LISTEXTATTR(9).

Obtained from: TrustedBSD Project
Sponsored by: DARPA, Network Associates Laboratories

ENOATTR is now used for error returns indicating an undefined
extended attribute.

EINVAL can also reflect an invalid namespace for either a get
or set operation on EAs.

Obtained from: TrustedBSD Project
Sponsored by: DARPA, Network Associates Laboratories

Document the BUG (feature) that you can pass in an empty name to
VOP_GETEXTATTR() to retrieve the attribute name list on some file
systems, and note that this will be replaced with its own VOP
in due course.

Pointed out by: Dominic Giampaolo <dbg@apple.com>

Some mdoc(7) fixes:

Nuke incorrect usage of .Ar; replace it with .Vt, .Va or .Fa appropriately.
The .Ar mdoc(7) specifier should only be used when displaying command line
arguments.

Approved by: des (mentor)

Uniformly refer to a file system as "file system".

Approved by: re

Convert descriptions in the ERRORS section to full sentences if they
were not full sentences, elaborating as necessary.

Style and markup changes only.

Capitalize the first letter of the descriptions for the entries in the ERRORS
section if they are complete sentences and end the sentences with periods.

More file system > filesystem

Document the new size parameter.

- Fix a number of man pages broken by the KSE merger.

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: normalize .Nd.

o Rename "namespace" argument to "attrnamespace" as namespace is a C++
reserved word

Submitted by: jkh
Obtained from: TrustedBSD Project

o The mdoc(7) police strike with avengance:

- These pages abused Ar macro (they should have used Fa).
- NULL constant should be marked with Dv.
- VOP_* in the ERRORS section for the EOPNOTSUPP entry should be marked
with Fn.

Submitted by: ru

o Update some of the kernel man pages associated with extended attributes
to reflect EA API change to explicit namespacing.

Obtained from: TrustedBSD Project

Fixed bitrot in synopsis (some const poisoning had not reached here).

o Bring VOP_GETACL(9) and VOP_GETEXTATTR(9) man page "LOCKS" sections in
sync with the implementation. Vnode locks *are* required for these
operations, as some underlying implementations will require them.

Obtained from: TrustedBSD Project

Man pages for the VFS extended attribute and access control list vnops.

Reviewed by: eivind