github.com/benhoyt/goawk@v1.8.1/testdata/README (about)

     1  Original README.TESTS from one-true-awk regdir tests directory:
     2  ---------------------------------------------------------------
     3  The archive of test files contains 
     4  
     5  - A shell file called REGRESS that controls the testing process.
     6  
     7  - Several shell files called Compare* that control sub-parts
     8  of the testing.
     9  
    10  - About 160 small tests called t.* that constitute a random
    11  sampling of awk constructions collected over the years.
    12  Not organized, but they touch almost everything.
    13  
    14  - About 60 small tests called p.* that come from the first
    15  two chapters of The AWK Programming Environment.  This is
    16  basic stuff -- they have to work.
    17  
    18  These two sets are intended as regression tests, to be sure
    19  that a new version produces the same results as a previous one.
    20  There are a couple of standard data files used with them,
    21  test.data and test.countries, but others would work too.
    22  
    23  - About 20 files called T.* that are self-contained and
    24  more systematic tests of specific language features.
    25  For example, T.clv tests command-line variable handling.
    26  These tests are not regressions -- they compute the right
    27  answer by separate means, then compare the awk output.
    28  A specific test for each new bug found shows up in at least
    29  one of these, most often T.misc.  There are about 220 tests
    30  total in these files.
    31  
    32  - Two of these files, T.re and T.sub, are systematic tests
    33  of the regular expression and substitution code.  They express
    34  tests in a small language, then generate awk programs that
    35  verify behavior.
    36  
    37  - About 20 files called tt.* that are used as timing tests;
    38  they use the most common awk constructions in straightforward
    39  ways, against a large input file constructed by Compare.tt.
    40  
    41  
    42  There is undoubtedly more stuff in the archive;  it's been
    43  collecting for years and may need pruning.  Suggestions for
    44  improvement, additional tests (especially systematic ones),
    45  and the like are all welcome.
    46