-.\" $Id: man.7,v 1.18 2009/07/04 09:00:41 kristaps Exp $
+.\" $Id: man.7,v 1.19 2009/07/14 15:56:44 kristaps Exp $
.\"
.\" Copyright (c) 2009 Kristaps Dzonsons <kristaps@kth.se>
.\"
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: July 4 2009 $
+.Dd $Mdocdate: July 14 2009 $
.Dt MAN 7
.Os
.\" SECTION
.Nm man
language was historically used to format
.Ux
-manuals. This reference document describes the syntax and structure of
-this language.
+manuals. This reference document describes its syntax, structure, and
+usage.
.Pp
-.Em \&Do not
-use
+.Bf Em
+Do not use
.Nm
-to write your manuals. Use the
+to write your manuals.
+.Ef
+Use the
.Xr mdoc 7
language, instead.
.\" PARAGRAPH
.Sh INPUT ENCODING
.Nm
documents may contain only graphable 7-bit ASCII characters, the
-space character
-.Sq \ ,
-and tabs
-.Sq \et .
-All manuals must have
+space character, and the tabs character. All manuals must have
.Ux
-.Sq \en
line termination.
.Pp
Blank lines are acceptable; where found, the output will assert a