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