autoconf: Cache Variable Names

1 
1 7.4.1 Cache Variable Names
1 --------------------------
1 
1 The names of cache variables should have the following format:
1 
1      PACKAGE-PREFIX_cv_VALUE-TYPE_SPECIFIC-VALUE_[ADDITIONAL-OPTIONS]
1 
1 for example, `ac_cv_header_stat_broken' or
1 `ac_cv_prog_gcc_traditional'.  The parts of the variable name are:
1 
1 PACKAGE-PREFIX
1      An abbreviation for your package or organization; the same prefix
1      you begin local Autoconf macros with, except lowercase by
1      convention.  For cache values used by the distributed Autoconf
1      macros, this value is `ac'.
1 
1 `_cv_'
1      Indicates that this shell variable is a cache value.  This string
1      _must_ be present in the variable name, including the leading
1      underscore.
1 
1 VALUE-TYPE
1      A convention for classifying cache values, to produce a rational
11      naming system.  The values used in Autoconf are listed in ⇒
      Macro Names.
1 
1 SPECIFIC-VALUE
1      Which member of the class of cache values this test applies to.
1      For example, which function (`alloca'), program (`gcc'), or output
1      variable (`INSTALL').
1 
1 ADDITIONAL-OPTIONS
1      Any particular behavior of the specific member that this test
1      applies to.  For example, `broken' or `set'.  This part of the
1      name may be omitted if it does not apply.
1 
1    The values assigned to cache variables may not contain newlines.
1 Usually, their values are Boolean (`yes' or `no') or the names of files
1 Variable Index:: for an index of cache variables with documented
1 semantics.
1