mdocml: document new SEE ALSO .Xr warnings

mdocml: document new SEE ALSO .Xr warnings

[schwarze]

Log Message:
-----------
document new SEE ALSO .Xr warnings

Modified Files:
--------------
    mdocml:
        demandoc.1
        mandoc.1

Revision Data
-------------
Index: mandoc.1
===================================================================
RCS file: /usr/vhosts/mdocml.bsd.lv/cvs/mdocml/mandoc.1,v
retrieving revision 1.111
retrieving revision 1.112
diff -Lmandoc.1 -Lmandoc.1 -u -p -r1.111 -r1.112
--- mandoc.1
+++ mandoc.1
@@ -766,6 +766,22 @@ The same standard section title occurs m
 .Pq mdoc
 A standard section header occurs in a section of the manual
 where it normally isn't useful.
+.It Sy "unusual Xr order"
+.Pq mdoc
+In the SEE ALSO section, an
+.Ic \&Xr
+macro with a lower section number follows one with a higher number,
+or two
+.Ic \&Xr
+macros refering to the same section are out of alphabetical order.
+.It Sy "unusual Xr punctuation"
+.Pq mdoc
+In the SEE ALSO section, punctuation between two
+.Ic \&Xr
+macros differs from a single comma, or there is trailing punctuation
+after the last
+.Ic \&Xr
+macro.
 .It Sy "AUTHORS section without An macro"
 .Pq mdoc
 An AUTHORS sections contains no
Index: demandoc.1
===================================================================
RCS file: /usr/vhosts/mdocml.bsd.lv/cvs/mdocml/demandoc.1,v
retrieving revision 1.7
retrieving revision 1.8
diff -Ldemandoc.1 -Ldemandoc.1 -u -p -r1.7 -r1.8
--- demandoc.1
+++ demandoc.1
@@ -92,7 +92,7 @@ This is accomplished as follows (assumin
 .Dl $ demandoc -w file.1 | spell -b
 .Sh SEE ALSO
 .Xr mandoc 1 ,
-.Xr man 7
+.Xr man 7 ,
 .Xr mdoc 7
 .Sh HISTORY
 .Nm
--
 To unsubscribe send an email to source+unsubscribe@mdocml.bsd.lv