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

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

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)

Remove pseudocode from VOP_* manual pages. It was out of date anyway.

Reviewed by: scottl
Approved by: rwatson (mentor)

Decontextualize the couplet VOP_GETATTR / VOP_SETATTR as the passed thread
was always curthread and totally unuseful.

Tested by: Giovanni Trematerra <giovanni dot trematerra at gmail dot com>

Use 'manual page' instead of 'man page' for consistency.

Approved by: re (hrs)

Mark lists as in the rest of section 9 manpages.

Submitted by: Joel Dahl (mostly)

mdoc(7) police: Deal with self-xrefs.

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.

s/VOP_NULL/VATTR_NULL/

mdoc(7) police: markup nits.

Various updates to VOP_ATTRIB(9): mention locks being shared/exclusive
for VOP_GETATTR() and VOP_SETATTR(), reference VOP_NULL() to suggest
clearing all of *vap with it before setting specific values. Cross
reference VFS(9). Indicate that failure modes are possible from
VOP_GETATTR() and that an errno value is returned.

Submitted by: Hiten Pandya <hiten@uk.FreeBSD.org>

mdoc(7) police: remove whitespace at EOL.

Revert 1.14: VOP_GETATTR() really does require a vnode lock.

Confirmed by: mckusick

Document that VOP_GETATTR(9) does not actually expect to hold an
exclusive lock on entry.

Sponsored by: DARPA, NAI Labs

ispell sweep of share/man/man9/*.

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

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

Be consistent with `struct vattr' naming. Half of this manual used `vpp'
while the other half used `vap', and in one case resulted in code that
made no sense. Replaced all of them with `vap'.

(Typically, `vpp' is a pointer to a pointer to a struct vnode anyway).

More clarification of locking requirements.

Bring more VOP manual pages up to date in regards to locking
requirements.

$Id$ -> $FreeBSD$

.Sh AUTHOR -> .Sh AUTHORS according to mdoc specs.
Use .An/.Aq.

Fixed #include and/or prototype bugs in synopsis.

Some minor mdoc cleanup.

Update this man page to reflect how setattr manipulates time
values after the Lite2 merge.

Formatting tweaks.

This is the current draft of my filesystem manpages. Some files are
incomplete and some are just placeholders but I wanted to try to get
something at least into 2.2 on the grounds that what I have is a lot
better than nothing. I also wanted to commit something which documents
the interfaces in 2.2 before I start updating the documentation for 3.0.

This is a definite 2.2 candidate and is also relavent to 2.1 if people
still care about that branch.