[BACK]Return to literal.out_ascii CVS log [TXT][DIR] Up to [cvsweb.bsd.lv] / mandoc / regress / man / RS
File: [cvsweb.bsd.lv] / mandoc / regress / man / RS / literal.out_ascii (download)

Revision 1.2, Sat Jan 5 20:04:50 2019 UTC (5 years, 4 months ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_14_5
Changes since 1.1: +9 -6 lines 

Slowly start doing more HTML output tests, in this case for the
interaction of .nf and .RS, related to man_macro.c rev. 1.106.

HTML regression testing is tricky because it is extremely prone to
over-testing, i.e. unintentional testing for volatile formatting
details which are irrelevant for deciding whether the HTML output
is good or bad.  Minor changes to the formatter - which is still
heavily under development - might result in the necessity to
repeatedly adjust many test cases.

Then again, HTML syntax rules are so complicated that without
regression testing, the risk is simply too high that later changes
will re-introduce issues that were already fixed earlier.  Let's
just try to design the tests very carefully in such a way that
the *.out_html files contain nothing that is likely to change, and
defer testing in cases where the HTML output is not yet clean enough
to allow designing tests in such a way.

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



NNAAMMEE
       RS-literal - indented literal text

DDEESSCCRRIIPPTTIIOONN
       BEGINTEST
       initial regular text
       literal text
       before display
              This is a short line.
              This is a very long line that would wrap if it weren't in literal context.
       literal text
       after display
       final regular text
       ENDTEST
       end of file



OpenBSD                         January 5, 2019                  RS-LITERAL(1)