Directory macros/latex/contrib/qstest

This is the public release of the qstest bundle
(written for DocScape Publisher <URL:http://www.docscape.de>)
(C) 2006, 2007 QuinScape GmbH <URL:http://www.quinscape.de>

This software comes without warranty of any kind.

The TeX source files are licensed under the LPPL version 1.3 or later,
see the individual files for details.  Generated files refer to the
license of their respective source.  Makefile and this README may be
freely used, modified and copied.

The bundle contains the packages `makematch' for matching patterns to
targets (with a generalization in the form of pattern lists and
keyword lists), and `qstest' for performing unit tests, allowing to
run a number of logged tests ensuring the consistency of values,
properties and call sequences during execution of test code.  Both
packages make extensive use of qstest in their package documentation,
providing illustrated examples that are automatically verified to work
as expected.

For efficiency and feature completeness reasons, both styles require
the use of an eTeX-based engine for LaTeX, as recommended by the LaTeX
team for some years (while the source code provides a way of producing
files for a non-eTeX setup, this is discouraged, untested, not feature
complete, not supported by Makefile and author).

Files in the bundle:

Makefile: this contains rules for managing unpacking, testing, and
installing the bundle in TDS-compliant trees.  Interesting targets are
all generated files, "test", and "install".

qstest.ins: installer file.  Running
    tex qstest.ins
will unpack the packages (but not their driver files) right into the 
target tree if your docstrip is configured for it.  If you want to
unpack into the current directory instead (and avoid getting asked
whether you want to overwrite old files, as is desirable for working
with the program `make'), you can do so by instead running
    tex "\let\Make=y \input qstest.ins"
Should qstest.ins be missing, you can use (or look at) the Makefile
for regenerating it.

makematch.dtx: documented source of makematch.sty.  Running this
document through LaTeX will give you the documentation of the package,
but without the documented package source.

qstest.dtx: documented source of qstest.sty.  Running this document
through LaTeX will give you the documentation of the package, but
without the documented package source.


The following files are also placed on CTAN for informational
purposes; as part of a TeX installation it would usually be preferable
to rather install DVI files with full source code listing, generated
by running latex on the files of form *.drv (see below):

qstest.pdf: the result of running PDFLaTeX on qstest.dtx, namely the
documentation for the qstest package without source code listing.

makematch.pdf: the result of running PDFLaTeX on qstest.dtx, namely
the documentation for the makematch package without source code
listing.


The following files will be unpacked by qstest.ins:

makematch.sty: this package matches pattern lists with wildcards to
keyword lists.

makematch.drv: this file can be run through LaTeX in order to generate
the documentation for the makematch package including the full
documented source code.

qstest.sty: this package allows one to perform unit tests and check
for values, definitions and macro call sequences to meet expectations.
Call sequences are specified with a syntax reminiscent of regular
expressions.

qstest.drv: this file can be run through LaTeX in order to generate
the documentation for the qstest package including the full documented
source code.

makematch-qs.tex: a standalone unit test of makematch.sty, to be run
through LaTeX.

qstest-qs.tex: a standalone unit test of qstest.sty, to be run
through LaTeX.


David Kastrup <dak@gnu.org>
QuinScape GmbH
http://www.QuinScape.de