[BACK]Return to transp.out_ascii CVS log [TXT][DIR] Up to [cvsweb.bsd.lv] / mandoc / regress / mdoc / Rs
File: [cvsweb.bsd.lv] / mandoc / regress / mdoc / Rs / transp.out_ascii (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@.

RS-TRANSPARENT(1)           General Commands Manual          RS-TRANSPARENT(1)

NNAAMMEE
     RRss--ttrraannssppaarreenntt - transparent nodes in reference blocks

SSEEEE AALLSSOO
     first after title and last, _t_i_t_l_e.

     first, middle, and last before title, _t_i_t_l_e.

     first after title and transparent, middle before transparent, and last
     before transparent, _t_i_t_l_e.

     first after transparent and last before transparent and title, _t_i_t_l_e.

OpenBSD                        February 27, 2020                       OpenBSD