===================================================================
RCS file: /cvs/mandoc/mandoc.1,v
retrieving revision 1.202
retrieving revision 1.208
diff -u -p -r1.202 -r1.208
--- mandoc/mandoc.1	2017/06/24 14:38:32	1.202
+++ mandoc/mandoc.1	2017/06/27 12:18:00	1.208
@@ -1,4 +1,4 @@
-.\"	$Id: mandoc.1,v 1.202 2017/06/24 14:38:32 schwarze Exp $
+.\"	$Id: mandoc.1,v 1.208 2017/06/27 12:18:00 schwarze Exp $
 .\"
 .\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
 .\" Copyright (c) 2012, 2014-2017 Ingo Schwarze <schwarze@openbsd.org>
@@ -15,7 +15,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: June 24 2017 $
+.Dd $Mdocdate: June 27 2017 $
 .Dt MANDOC 1
 .Os
 .Sh NAME
@@ -688,7 +688,7 @@ Messages displayed by
 .Nm
 follow this format:
 .Bd -ragged -offset indent
-.Nm Ns :
+.Nm :
 .Ar file : Ns Ar line : Ns Ar column : level : message : macro args
 .Pq Ar os
 .Ed
@@ -816,6 +816,18 @@ macro does not use CVS
 keyword substitution, but using it is conventionally expected in the
 .Ox
 base system.
+.It Sy "unknown architecture"
+.Pq mdoc , Ox , Nx
+The third argument of the
+.Ic \&Dt
+macro does not match any of the architectures this operating system
+is running on.
+.It Sy "operating system explicitly specified"
+.Pq mdoc , Ox , Nx
+The
+.Ic \&Os
+macro has an argument.
+In the base system, it is conventionally left blank.
 .It Sy "RCS id missing"
 .Pq Ox , Nx
 The manual page lacks the comment line with the RCS identifier
@@ -845,6 +857,11 @@ A single manual page contains two copies of the RCS id
 the same operating system.
 Consider deleting the later instance and moving the first one up
 to the top of the page.
+.It Sy "typo in section name"
+.Pq mdoc
+Fuzzy string matching revealed that the argument of an
+.Ic \&Sh
+macro is similar, but not identical to a standard section name.
 .It Sy "useless macro"
 .Pq mdoc
 A
@@ -1158,7 +1175,9 @@ The paragraph macro is moved after the end of the list
 .Pq mdoc
 An input line begins with an
 .Ic \&Ns
-macro.
+macro, or the next argument after an
+.Ic \&Ns
+macro is an isolated closing delimiter.
 The macro is ignored.
 .It Sy "blocks badly nested"
 .Pq mdoc
@@ -1266,6 +1285,7 @@ A
 .Ic \&Bl ,
 .Ic \&D1 ,
 .Ic \&Dl ,
+.Ic \&MT ,
 .Ic \&RS ,
 or
 .Ic \&UR
@@ -1401,6 +1421,8 @@ An empty pair of square brackets is shown.
 .It Sy "missing resource identifier, using \(dq\(dq"
 .Pq man
 The
+.Ic \&MT
+or
 .Ic \&UR
 macro is invoked without any argument.
 An empty pair of angle brackets is shown.
@@ -1753,7 +1775,7 @@ An
 .Xr mdoc 7
 block closing macro, a
 .Xr man 7
-.Ic \&RE
+.Ic \&ME , \&RE
 or
 .Ic \&UE
 macro, an
@@ -1787,7 +1809,7 @@ At the end of the document, an explicit
 block, a
 .Xr man 7
 next-line scope or
-.Ic \&RS
+.Ic \&MT , \&RS
 or
 .Ic \&UR
 block, an equation, table, or
@@ -1959,6 +1981,7 @@ A macro or request is invoked with too many arguments:
 .Bl -dash -offset 2n -width 2n -compact
 .It
 .Ic \&Fo ,
+.Ic \&MT ,
 .Ic \&PD ,
 .Ic \&RS ,
 .Ic \&UR ,