| 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. |
