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