Introduce the concept of nodes that are semantically transparent:

they are skipped when looking for previous or following high-level
macros.  Examples include roff(7) .ft, .ll, and .ta, mdoc(7) .Sm
and .Tg, and man(7) .DT and .PD.  Use this concept for a variety
of improved decisions in various validators and formatters.

While here,
* remove a few const qualifiers on struct arguments that caused trouble;
* get rid of some more Yoda notation in the vicinity;
* and apply some other stylistic improvements in the vicinity.

I found this class of issues while considering .Tg patches from kn@.

7 files changed, 120 insertions, 3 deletions

diff --git a/regress/man/IP/Makefile b/regress/man/IP/Makefile
index a677b970..70094e5f 100644
--- a/regress/man/IP/Makefile
+++ b/regress/man/IP/Makefile
@@ -1,7 +1,8 @@
-# $OpenBSD: Makefile,v 1.9 2019/01/06 04:41:15 schwarze Exp $
+# $OpenBSD: Makefile,v 1.10 2020/02/27 01:25:58 schwarze Exp $
 
-REGRESS_TARGETS = empty literal longhead manyargs spacing width
+REGRESS_TARGETS = bullet empty literal longhead manyargs spacing vert width
+UTF8_TARGETS	= bullet
 LINT_TARGETS	= empty
-HTML_TARGETS	= literal
+HTML_TARGETS	= bullet literal
 
 .include <bsd.regress.mk>
diff --git a/regress/man/IP/bullet.in b/regress/man/IP/bullet.in
new file mode 100644
index 00000000..138a681b
--- /dev/null
+++ b/regress/man/IP/bullet.in
@@ -0,0 +1,22 @@
+.\" $OpenBSD: bullet.in,v 1.1 2020/02/27 01:25:58 schwarze Exp $
+.TH IP-BULLET 1 "February 20, 2020"
+.SH NAME
+IP-bullet \- bullet lists
+.SH DESCRIPTION
+BEGINTEST
+.IP * 3n
+one
+.IP *
+two
+.IP \(bu
+three
+.IP \(bu
+four
+.IP \-
+five
+.IP \-
+six
+.PP
+ENDTEST
+.br
+end of file
diff --git a/regress/man/IP/bullet.out_ascii b/regress/man/IP/bullet.out_ascii
new file mode 100644
index 00000000..a01f25c2
--- /dev/null
+++ b/regress/man/IP/bullet.out_ascii
@@ -0,0 +1,28 @@
+IP-BULLET(1)                General Commands Manual               IP-BULLET(1)
+
+
+
+NNAAMMEE
+       IP-bullet - bullet lists
+
+DDEESSCCRRIIPPTTIIOONN
+       BEGINTEST
+
+       *  one
+
+       *  two
+
+       +o  three
+
+       +o  four
+
+       -  five
+
+       -  six
+
+       ENDTEST
+       end of file
+
+
+
+OpenBSD                        February 20, 2020                  IP-BULLET(1)
diff --git a/regress/man/IP/bullet.out_html b/regress/man/IP/bullet.out_html
new file mode 100644
index 00000000..95c452b0
--- /dev/null
+++ b/regress/man/IP/bullet.out_html
@@ -0,0 +1,12 @@
+<ul class="Bl-bullet">
+  <li>one</li>
+  <li>two</li>
+</ul>
+<ul class="Bl-bullet">
+  <li>three</li>
+  <li>four</li>
+</ul>
+<ul class="Bl-dash">
+  <li>five</li>
+  <li>six</li>
+</ul>
diff --git a/regress/man/IP/bullet.out_utf8 b/regress/man/IP/bullet.out_utf8
new file mode 100644
index 00000000..fa021fd5
--- /dev/null
+++ b/regress/man/IP/bullet.out_utf8
@@ -0,0 +1,28 @@
+IP-BULLET(1)                General Commands Manual               IP-BULLET(1)
+
+
+
+NNAAMMEE
+       IP-bullet - bullet lists
+
+DDEESSCCRRIIPPTTIIOONN
+       BEGINTEST
+
+       *  one
+
+       *  two
+
+       •  three
+
+       •  four
+
+       -  five
+
+       -  six
+
+       ENDTEST
+       end of file
+
+
+
+OpenBSD                        February 20, 2020                  IP-BULLET(1)
diff --git a/regress/man/IP/vert.in b/regress/man/IP/vert.in
new file mode 100644
index 00000000..cc5e2038
--- /dev/null
+++ b/regress/man/IP/vert.in
@@ -0,0 +1,10 @@
+.\" $OpenBSD: vert.in,v 1.1 2020/02/27 01:25:58 schwarze Exp $
+.TH IP-VERT 1 "February 19, 2020"
+.SH NAME
+IP-vert \- vertical spacing before indented paragraphs
+.SH DESCRIPTION
+.PD 2v
+.IP tag
+text
+.IP tag
+text
diff --git a/regress/man/IP/vert.out_ascii b/regress/man/IP/vert.out_ascii
new file mode 100644
index 00000000..428733be
--- /dev/null
+++ b/regress/man/IP/vert.out_ascii
@@ -0,0 +1,16 @@
+IP-VERT(1)                  General Commands Manual                 IP-VERT(1)
+
+
+
+NNAAMMEE
+       IP-vert - vertical spacing before indented paragraphs
+
+DDEESSCCRRIIPPTTIIOONN
+       tag    text
+
+
+       tag    text
+
+
+
+OpenBSD                        February 19, 2020                    IP-VERT(1)