.\" -*-nroff-*-
.\"
.\" Manual for ad-hoc testing with the test vector framework
.\"
.\" (c) 2024 Straylight/Edgeware
.\"
.
.\"----- Licensing notice ---------------------------------------------------
.\"
.\" This file is part of the mLib utilities library.
.\"
.\" mLib is free software: you can redistribute it and/or modify it under
.\" the terms of the GNU Library General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or (at
.\" your option) any later version.
.\"
.\" mLib is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Library General Public
.\" License for more details.
.\"
.\" You should have received a copy of the GNU Library General Public
.\" License along with mLib.  If not, write to the Free Software
.\" Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,
.\" USA.
.
.\"--------------------------------------------------------------------------
.so ../defs.man \" @@@PRE@@@
.
.\"--------------------------------------------------------------------------
.TH tvec-adhoc 3mLib "11 March 2024" "Straylight/Edgeware" "mLib utilities library"
.\" @tvec_adhocconfig
.\" @tvec_adhoc
.
.\" @tvec_begingroup
.\" @TVEC_BEGINGROUP
.\" @tvec_endgroup
.\" @TVEC_TESTGROUP
.\" @TVEC_TESTGROUP_TAG
.\" @tvec_begintest
.\" @TVEC_BEGINTEST
.\" @tvec_endtest
.\" @TVEC_TEST
.\" @TVEC_TEST_TAG
.
.\" @tvec_claim
.\" @TVEC_CLAIM
.\" @tvec_claimeq
.
.\"--------------------------------------------------------------------------
.SH NAME
tvec-adhoc \- ad-hoc testing with the test vector framework
.
.\"--------------------------------------------------------------------------
.SH SYNOPSIS
.
.nf
.B "#include <mLib/tvec-adhoc.h>"
.PP
.BI "const struct tvec_config tvec_adhocconfig;"
.BI "void tvec_adhoc(struct tvec_state *" tv ", struct tvec_test *" t );
.PP
.ta \w'\fBvoid tvec_begingroup('u
.BI "void tvec_begingroup(struct tvec_state *" tv ", const char *" name ,
.BI "	const char *" file ", unsigned " lno );
.BI "void TVEC_BEGINGROUP(struct tvec_state *" tv ", const char *" name );
.BI "void tvec_endgroup(struct tvec_state *" tv );
.BI "TVEC_TESTGROUP(" tv ", " name ") " body
.BI "TVEC_TESTGROUP_TAG(" tag ", " tv ", " name ") " body
.ta \w'\fBvoid tvec_begintest('u
.BI "void tvec_begintest(struct tvec_state *" tv ,
.BI "	const char *" file ", unsigned " lno );
.BI "void TVEC_BEGINTEST(struct tvec_state *" tv );
.BI "void tvec_endtest(struct tvec_state *" tv );
.BI "TVEC_TEST(" tv ") " body
.BI "TVEC_TEST_TAG(" tag ", " tv ") " body
.PP
.ta \w'\fBint tvec_claim('u
.BI "int tvec_claim(struct tvec_state *" tv ", int " ok ,
.BI "	const char *" file ", unsigned " lno ,
.BI "	const char *" msg ", ...);"
.ta \w'\fBint tvec_claim_v('u
.BI "int tvec_claim_v(struct tvec_state *" tv ", int " ok ,
.BI "	const char *" file ", unsigned " lno ,
.BI "	const char *" msg ", va_list *" ap );
.BI "int TVEC_CLAIM(struct tvec_state *" tv ", int " cond );
.ta \w'\fBint tvec_claimeq('u
.BI "int tvec_claimeq(struct tvec_state *" tv ,
.BI "	const struct tvec_regty *" ty ,
.BI "	const union tvec_misc *" arg ,
.BI "	const struct tvec_reg *" rval ,
.BI "	const struct tvec_reg *" rref ,
.BI "	const char *" file ", unsigned " lno ,
.BI "	const char *" expr );
.fi