OLD | NEW |
(Empty) | |
| 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. |
OLD | NEW |