chiark - git - mdw - mLib/blob - test/tvec-adhoc.3

   1 .\" -*-nroff-*-
   2 .de VS
   3 .sp 1
   4 .RS
   5 .nf
   6 .ft B
   7 ..
   8 .de VE
   9 .ft R
  10 .fi
  11 .RE
  12 .sp 1
  13 ..
  14 .de hP
  15 .IP
  16 .ft B
  17 \h'-\w'\\$1\ 'u'\\$1\ \c
  18 .ft P
  19 ..
  20 .ie t \{\
  21 .  ds o \(bu
  22 .  de VP
  23 .    sp .4v
  24 ..
  25 \}
  26 .el \{\
  27 .  ds o o
  28 .  de VP
  29 .    sp
  30 ..
  31 \}
  32 ..
  33 .TH tvec-adhoc 3 "11 March 2024" "Straylight/Edgeware" "mLib utilities library"
  34 .SH NAME
  35 tvec-adhoc \- ad-hoc testing with the test vector framework
  36 .\" @tvec_adhocconfig
  37 .\" @tvec_adhoc
  38 .
  39 .\" @tvec_begingroup
  40 .\" @TVEC_BEGINGROUP
  41 .\" @tvec_endgroup
  42 .\" @TVEC_TESTGROUP
  43 .\" @TVEC_TESTGROUP_TAG
  44 .\" @tvec_begintest
  45 .\" @TVEC_BEGINTEST
  46 .\" @tvec_endtest
  47 .\" @TVEC_TEST
  48 .\" @TVEC_TEST_TAG
  49 .
  50 .\" @tvec_claim
  51 .\" @TVEC_CLAIM
  52 .\" @tvec_claim_eq
  53 .
  54 .SH SYNOPSIS
  55 .nf
  56 .B "#include <mLib/tvec.h>"
  57 .PP
  58 .BI "const struct tvec_config tvec_adhocconfig;"
  59 .BI "void tvec_adhoc(struct tvec_state *" tv ", struct tvec_test *" t );
  60 .PP
  61 .ta \w'\fBvoid tvec_begingroup('u
  62 .BI "void tvec_begingroup(struct tvec_state *" tv ", const char *" name ,
  63 .BI "   const char *" file ", unsigned " lno );
  64 .BI "void TVEC_BEGINGROUP(struct tvec_state *" tv ", const char *" name );
  65 .BI "void tvec_endgroup(struct tvec_state *" tv );
  66 .BI "TVEC_TESTGROUP(" tv ", " name ") " body
  67 .BI "TVEC_TESTGROUP_TAG(" tag ", " tv ", " name ") " body
  68 .ta \w'\fBvoid tvec_begintest('u
  69 .BI "void tvec_begintest(struct tvec_state *" tv ,
  70 .BI "   const char *" file ", unsigned " lno );
  71 .BI "void TVEC_BEGINTEST(struct tvec_state *" tv );
  72 .BI "void tvec_endtest(struct tvec_state *" tv );
  73 .BI "TVEC_TEST(" tv ") " body
  74 .BI "TVEC_TEST_TAG(" tag ", " tv ") " body
  75 .PP
  76 .ta \w'\fBint tvec_claim('u
  77 .BI "int tvec_claim(struct tvec_state *" tv ", int " ok ,
  78 .BI "   const char *" file ", unsigned " lno ,
  79 .BI "   const char *" msg ", ...);"
  80 .ta \w'\fBint tvec_claim_v('u
  81 .BI "int tvec_claim_v(struct tvec_state *" tv ", int " ok ,
  82 .BI "   const char *" file ", unsigned " lno ,
  83 .BI "   const char *" msg ", va_list *" ap );
  84 .BI "int TVEC_CLAIM(struct tvec_state *" tv ", int " cond );
  85 .ta \w'\fBint tvec_claim_eq('u
  86 .BI "int tvec_claim_eq(struct tvec_state *" tv ,
  87 .BI "   const struct tvec_regty *" ty ,
  88 .BI "   const union tvec_misc *" arg ,
  89 .BI "   const char *" file ", unsigned " lno ,
  90 .BI "   const char *" expr );
  91 .fi