Home | History | Annotate | Download | only in conftest
      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.
     50