Copy stable/10@r272459 to releng/10.1 as part of
the 10.1-RELEASE process.

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

Copy head (r256279) to stable/10 as part of the 10.0-RELEASE cycle.

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

Reject spaces and double quotation marks in device names. devctl(4)
and devd(8) can't handle names with such characters properly.

PR: bin/144736, kern/161912
Discussed with: imp, kib, pjd

Remove superfluous paragraph macro.

Formatting fixes:
o Fix date
o Break sentences
o Remove trailing whitespaces
o Sort xrefs by section number

Requested by: ru
MFC after: 2 weeks

Document make_dev_alias_p().

MFC after: 2 weeks

Fix typos.

Use .Dv with NULL.

Document make_dev_p(9).

Reviewed by: brueffer, kib

Check the device name validity on device registration.

A new function prep_devname() sanitizes a device name by removing
leading and redundant sequential slashes. The function returns an error
for names which already exist or are considered invalid.

A new flag MAKEDEV_CHECKNAME for make_dev_p(9) and make_dev_credf(9)
indicates that the caller is prepared to handle an error related to the
device name. An invalid name triggers a panic if the flag is not
specified.

Document the MAKEDEV_CHECKNAME flag in the make_dev(9) manual page.

Idea from: kib
Reviewed by: kib

Document MAKEDEV_ETERNAL.

MFC after: 3 days

Correct function name.

MFC after: 3 days

mdoc cleanup

Garbage collect unused sections, macros and arguments. Fix prologue and
remove empty lines.

Found by: mdocml

Document MAKEDEV_NOWAIT flag for make_dev_credf(9).

Reviewed by: jh
MFC after: 2 weeks

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)

Several documentation fixups related to device minor/major numbers:

- Document the minor(3), major(3) and makedev(3) macro's. They also
apply to umajor() and uminor() in the kernel, but hopefully we'll sort
that out one day.

- Briefly dev2unit() inside the make_dev(9) manual page, since this is
now the preferred macro to obtain character device unit numbers inside
the kernel.

- Remove the device_ids(9) manual page. It contains highly inaccurate
information, such as a description of the nonexistent major().

Rename the `minor' argument of make_dev(9) to `unit'.

To prevent any further confusion about device minor and unit numbers,
we'd better just refer to device unit numbers. Many people still think
the numbers we show inside devfs have any relation to the numbers passed
to make_dev(9), which is not the case.

Discussed with: kib

Document make_dev_credf(9), destroy_dev_sched(9) and destroy_dev_drain(9)
functions.

Reviewed by: brueffer

Bump date for previous commit, also new sentence -> new line.

Document the additional fields, si_drv1 and si_drv2 that are available
for the user to use...

MFC after: 1 week

Make it clear that the device name may contain '/' characters to place
a device in a subdirectory. Also explicitly state that the name is
constructed using fmt like printf would print it.

MFC After: 3 days

match w/ prototype...

MFC after: 3 days

Bump date to Sept 20, the date of the last content change

Sprinkle a few stars where they belong.

Bump .Dd for the previous commit.

The make_dev(9) functions no longer handle dev_ts, but struct cdevs.

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

Mdoc Janitor:

* Fix hard sentence breaks.

* NOTE: devstat(9) requires more mdoc(7) work.

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

Various mdoc(7) fixes:

Add devfs(5) reference - make_dev.9
Change .Xr from VFS_VGET(9) to vget(9) - vnode.9
Spelling fix, 'useage' to 'usage' - zone.9

Approved by: des (mentor)

The routine is dev_depends(); consistently spell it that way.

PR: 34047
Submitted by: Maxime Henrion <mux@sneakerz.org>
Pointy hat to: dd

ispell sweep of share/man/man9/*.

Fixed wrong include in synopsis.

Fixed bitrot in synopsis. Const'ification of make_dev() and
make_dev_alias() had not reached here.

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: cosmetics.

Document depends_dev.

Reviewed by: phk

mdoc(7) police: normalize .Nd.

mdoc(7) police:
removed hard sentence breaks, use Ft for function return type.

Document the make_dev_alias function.

"Fixed" assorted bitrot. remove_dev() was renamed to destroy_dev().
VOP_ABORTOP() went away. at_shutdown() was replaced by undocumented
event handling. Rename remove_dev() here too, and remove the dead
and dead wrong man pages.

Document the make_dev(9) and remove_dev(9) facilities.
remove_dev(9) is created as a link to the existing make_dev(9) page.

Reviewed by: phk