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