50 lines
1.8 KiB
Plaintext
50 lines
1.8 KiB
Plaintext
|
This directory contains test configuration files, currently always '.dfa' files
|
||
|
|
intended to be used in the build by setting the make macro DFA_XTRA to the name
|
||
|
|
of the file.
|
||
|
|
|
||
|
|
These files are used in release validation of the 'configure' builds of libpng
|
||
|
|
by building 'make check', or 'make all-am' for cross-builds, with each .dfa
|
||
|
|
file.
|
||
|
|
|
||
|
|
The files in this directory may change between minor releases, however
|
||
|
|
contributions describing specific builds of libpng are welcomed. There is no
|
||
|
|
guarantee that libpng will continue to build with such configurations; support
|
||
|
|
for given configurations can be, and has been, dropped between successive minor
|
||
|
|
releases. However if a .dfa file describing a configuration is not in this
|
||
|
|
directory it is very unlikely that it will be tested before a minor release!
|
||
|
|
|
||
|
|
You can use these .dfa files as the basis of new configurations. Files in this
|
||
|
|
directory should not have any use restrictions or restrictive licenses.
|
||
|
|
|
||
|
|
This directory is not included in the .zip and .7z distributions, which do
|
||
|
|
not contain 'configure' scripts.
|
||
|
|
|
||
|
|
DOCUMENTATION
|
||
|
|
=============
|
||
|
|
|
||
|
|
Examples:
|
||
|
|
${srcdir}/pngusr.dfa
|
||
|
|
${srcdir}/contrib/pngminim/*/pngusr.dfa
|
||
|
|
|
||
|
|
Documentation of the options:
|
||
|
|
${srcdir}/scripts/pnglibconf.dfa
|
||
|
|
|
||
|
|
Documentation of the file format:
|
||
|
|
${srcdir}/scripts/options.awk
|
||
|
|
|
||
|
|
FILE NAMING
|
||
|
|
===========
|
||
|
|
|
||
|
|
File names in this directory may NOT contain any of the five characters:
|
||
|
|
|
||
|
|
- , + * ?
|
||
|
|
|
||
|
|
Neither may they contain any space character.
|
||
|
|
|
||
|
|
While other characters may be used it is strongly suggested that file names be
|
||
|
|
limited to lower case Latiin alphabetic characters (a-z), digits (0-9) and, if
|
||
|
|
necessary the underscore (_) character. File names should be about 8 characters
|
||
|
|
long (excluding the .dfa extension). Submitted .dfa files should have names
|
||
|
|
between 7 and 16 characters long, shorter names (6 characters or less) are
|
||
|
|
reserved for standard tests.
|