=================================================================== RCS file: /cvs/mandoc/regress/regress.pl.1,v retrieving revision 1.1 retrieving revision 1.3 diff -u -p -r1.1 -r1.3 --- mandoc/regress/regress.pl.1 2017/02/08 03:02:13 1.1 +++ mandoc/regress/regress.pl.1 2017/07/18 18:47:06 1.3 @@ -1,4 +1,4 @@ -.\" $Id: regress.pl.1,v 1.1 2017/02/08 03:02:13 schwarze Exp $ +.\" $Id: regress.pl.1,v 1.3 2017/07/18 18:47:06 schwarze Exp $ .\" .\" Copyright (c) 2017 Ingo Schwarze .\" @@ -14,7 +14,7 @@ .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: February 8 2017 $ +.Dd $Mdocdate: July 18 2017 $ .Dt REGRESS.PL 1 .Os .Sh NAME @@ -23,7 +23,7 @@ .Sh SYNOPSIS .Nm ./regress.pl .Oo -.Ar directory Ns Op Pf : Ar test +.Ar directory Ns Op Pf / Ar test .Op Ar modifier ... .Oc .Sh DESCRIPTION @@ -32,35 +32,24 @@ The steering script allows running the .Xr mandoc 1 regression suite on arbitrary operating systems, -even though the suite was designed for OpenBSD only. +even though the suite was originally designed for OpenBSD only. .Pp When run without an argument, .Nm runs the complete regression suite. .Pp -When run with one argument, that argument can be: -.Bl -enum -.It -A single dot to run the complete suite. -.It -One of the top level directories, for example -.Pa mdoc , -to run the test suite for a complete language or feature group. -.It -A subdirectory, for example -.Pa man/IP , -to run the tests for a specific macro or an individual feature. -.It -A subdirectory with a test name appended with a colon, for example -.Pa char/unicode : Ns Pa named , -to run the tests for one particular input file. -.El +The first argument is a Perl regular expression to match test names, +automatically anchored at the beginning of the names. +Test names are names of test input files without the file name extension +.Pa .in , +for example +.Pa char/unicode/named . .Pp Any additional arguments modify the way the tests are run. The default is .Cm all . The following modifiers are available: -.Bl -tag -width verbose +.Bl -tag -width markdown .It Cm all Run all kinds of subtests. This implies all other modifiers except @@ -85,6 +74,10 @@ warning and error output. Run subtests for .Fl T Cm man output mode. +.It Cm markdown +Run subtests for +.Fl T Cm markdown +output mode. .It Cm utf8 Run subtests for .Fl T Cm utf8 @@ -92,35 +85,6 @@ output mode. .It Cm verbose Display approximate indications of what is being done. .El -.Pp -The amount of summary lines shown can be modified by giving an -argument consisting of a single digit: -.Bl -tag -width verbose -.It Cm 3 -Show all summary lines for all directories entered. -Even without -.Cm verbose , -this generates more than hundred lines of output when running the -complete regression suite. -.It Cm 2 -This is the default. -It shows the summary lines for the -.Ar directory -given on the command line and its immediate children. -Except for -.Pa mdoc , -the output usually fits on one screen. -.It Cm 1 -Only show a single summary line for the whole run. -.It Cm 0 -Do not show any summary lines. -No output means success. -Success or failure can also be seen from the exit status. -.El -.Pp -All failed tests are always reported, even when the -.Cm 0 -modifier is given. .Sh EXIT STATUS .Ex -std .Sh EXAMPLES @@ -136,15 +100,9 @@ Complete check, but keep the tree clean: .Pp .Dl ./regress.pl \&. all clean .Pp -Test all of -.Pa mdoc , -but don't print the usual 65 lines of output: -.Pp -.Dl ./regress.pl mdoc 1 -.Pp Investigate a specific failure: .Pp -.Dl ./regress.pl mdoc/Bd:broken man verbose +.Dl ./regress.pl mdoc/Bd/broken man verbose .Sh HISTORY The .Nm