manual page: rewrite in mdoc(7) semantic markup

Rewrite in semantic markup, which provides greatly enhanced search features and is supported on all manual toolchains.

While here, add the examples everyone really wants.

Thanks!