mandoc/regress/mdoc/Rs/transp.in - view

Return to transp.in CVS log

Up to [cvsweb.bsd.lv] / mandoc / regress / mdoc / Rs

File: [cvsweb.bsd.lv] / mandoc / regress / mdoc / Rs / transp.in (download)

Revision 1.1, Thu Feb 27 01:44:04 2020 UTC (4 years, 3 months ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_14_6, HEAD

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

.\" $OpenBSD: transp.in,v 1.1 2020/02/27 01:25:58 schwarze Exp $
.Dd $Mdocdate: February 27 2020 $
.Dt RS-TRANSPARENT 1
.Os
.Sh NAME
.Nm Rs-transparent
.Nd transparent nodes in reference blocks
.Sh SEE ALSO
.Tg transparent
.Rs
.%T title
.%A first after title
.%A last
.Re
.Rs
.%A first
.%A middle
.%A last before title
.%T title
.Re
.Rs
.%T title
.Tg transparent
.%A first after title and transparent
.%A middle before transparent
.Tg transparent
.%A last before transparent
.Tg transparent
.Re
.Rs
.Tg transparent
.%A first after transparent
.%A last before transparent and title
.Tg transparent
.%T title
.Re