1This directory contains test configuration files, currently always '.dfa' files
2intended to be used in the build by setting the make macro DFA_XTRA to the name
3of the file.
4
5These files are used in release validation of the 'configure' builds of libpng
6by building 'make check', or 'make all-am' for cross-builds, with each .dfa
7file.
8
9The files in this directory may change between minor releases, however
10contributions describing specific builds of libpng are welcomed.  There is no
11guarantee that libpng will continue to build with such configurations; support
12for given configurations can be, and has been, dropped between successive minor
13releases.  However if a .dfa file describing a configuration is not in this
14directory it is very unlikely that it will be tested before a minor release!
15
16You can use these .dfa files as the basis of new configurations.  Files in this
17directory should not have any use restrictions or restrictive licenses.
18
19This directory is not included in the .zip and .7z distributions, which do
20not contain 'configure' scripts.
21
22DOCUMENTATION
23=============
24
25Examples:
26   ${srcdir}/pngusr.dfa
27   ${srcdir}/contrib/pngminim/*/pngusr.dfa
28
29Documentation of the options:
30   ${srcdir}/scripts/pnglibconf.dfa
31
32Documentation of the file format:
33   ${srcdir}/scripts/options.awk
34
35FILE NAMING
36===========
37
38File names in this directory may NOT contain any of the five characters:
39
40   - , + * ?
41
42Neither may they contain any space character.
43
44While other characters may be used it is strongly suggested that file names be
45limited to lower case Latiin alphabetic characters (a-z), digits (0-9) and, if
46necessary the underscore (_) character.  File names should be about 8 characters
47long (excluding the .dfa extension).  Submitted .dfa files should have names
48between 7 and 16 characters long, shorter names (6 characters or less) are
49reserved for standard tests.
50