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@.

3 files changed, 26 insertions, 2 deletions

diff --git a/regress/man/SH/Makefile b/regress/man/SH/Makefile
index 55133efe..f42a85b2 100644
--- a/regress/man/SH/Makefile
+++ b/regress/man/SH/Makefile
@@ -1,6 +1,6 @@
-# $OpenBSD: Makefile,v 1.6 2019/01/06 04:41:15 schwarze Exp $
+# $OpenBSD: Makefile,v 1.7 2020/02/27 01:25:58 schwarze Exp $
 
-REGRESS_TARGETS	= broken broken_eline empty_before longarg noarg paragraph
+REGRESS_TARGETS	= broken broken_eline empty_before longarg noarg paragraph vert
 LINT_TARGETS	= broken broken_eline empty_before noarg
 HTML_TARGETS	= paragraph
 
diff --git a/regress/man/SH/vert.in b/regress/man/SH/vert.in
new file mode 100644
index 00000000..e4154782
--- /dev/null
+++ b/regress/man/SH/vert.in
@@ -0,0 +1,10 @@
+.\" $OpenBSD: vert.in,v 1.1 2020/02/27 01:25:58 schwarze Exp $
+.TH SH-VERT 1 "February 20, 2020"
+.SH NAME
+SH-vert \- vertical spacing of sections
+.SH DESCRIPTION
+.PD 2v
+.SH EXAMPLES
+.PD 1v
+.PP
+text
diff --git a/regress/man/SH/vert.out_ascii b/regress/man/SH/vert.out_ascii
new file mode 100644
index 00000000..f8afd7e0
--- /dev/null
+++ b/regress/man/SH/vert.out_ascii
@@ -0,0 +1,14 @@
+SH-VERT(1)                  General Commands Manual                 SH-VERT(1)
+
+
+
+NNAAMMEE
+       SH-vert - vertical spacing of sections
+
+DDEESSCCRRIIPPTTIIOONN
+EEXXAAMMPPLLEESS
+       text
+
+
+
+OpenBSD                        February 20, 2020                    SH-VERT(1)