Copy head@r302406 to stable/11 as part of the 11.0-RELEASE cycle.
Prune svn:mergeinfo from the new branch, as nothing has been merged
here.

Additional commits post-branch will follow.

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

use .Mt to mark up email addresses consistently (part6)

PR: 191174
Submitted by: Franco Fichtner <franco at lastsummer.de>

Tiny markup fixes.

Sort SEE ALSO references (in dictionary order, ignoring case).

These hyphens don't need to be escaped.

Pointed out by: pjd@

Update several GEOM related manual pages:

*) Fix spelling errors.
*) Better english.
*) Re-phrasing.

Not Reviewed by: pjd (one week timeout)
Approved by: grog (mentor)

The topology lock is not needed for g_error_provider() function.

Discussed with: phk

Functions:

- g_new_geomf(),
- g_new_providerf(),
- g_new_consumer()

cannot failed (by returning NULL), so don't scare programmers.

Add reference to the g_access(9) manual page.

Added first part of GEOM kernel API manuals pages.
Documented function and macros are:
- DECLARE_GEOM_CLASS(),
- g_attach(),
- g_detach(),
- g_new_bio(),
- g_clone_bio(),
- g_destroy_bio(),
- g_new_consumer(),
- g_destroy_consumer(),
- g_read_data(),
- g_write_data(),
- g_post_event(),
- g_waitfor_event(),
- g_cancel_event(),
- g_new_geomf(),
- g_destroy_geom(),
- g_new_providerf(),
- g_destroy_provider(),
- g_error_provider(),
- g_provider_by_name(),
- g_wither_geom().
and more to come.

I want to thanks following people for help with those documents:
Slawek Zak <zaks@prioris.mini.pw.edu.pl>
Simon L. Nielsen <simon@FreeBSD.org>
Pieter de Boer <g.p.de.boer@st.hanze.nl>
and of course
Poul-Henning Kamp <phk@FreeBSD.org>

Reviewed by: phk, scottl
Approved by: phk, scottl (mentor)