doxygen: fix some comments in cmPolicies.h
This commit is contained in:
parent
4a48be323b
commit
477459010f
|
@ -21,8 +21,9 @@ class cmPolicy;
|
||||||
/** \class cmPolicies
|
/** \class cmPolicies
|
||||||
* \brief Handles changes in CMake behavior and policies
|
* \brief Handles changes in CMake behavior and policies
|
||||||
*
|
*
|
||||||
* See the cmake wiki section on policies for an overview of this class's
|
* See the cmake wiki section on
|
||||||
* purpose
|
* <a href="http://www.cmake.org/Wiki/CMake/Policies">policies</a>
|
||||||
|
* for an overview of this class's purpose
|
||||||
*/
|
*/
|
||||||
class cmPolicies
|
class cmPolicies
|
||||||
{
|
{
|
||||||
|
@ -30,32 +31,46 @@ public:
|
||||||
cmPolicies();
|
cmPolicies();
|
||||||
~cmPolicies();
|
~cmPolicies();
|
||||||
|
|
||||||
enum PolicyStatus { OLD, WARN, NEW, REQUIRED_IF_USED, REQUIRED_ALWAYS };
|
/// Status of a policy
|
||||||
|
enum PolicyStatus {
|
||||||
|
OLD, ///< Use old behavior
|
||||||
|
WARN, ///< Use old behavior but issue a warning
|
||||||
|
NEW, ///< Use new behavior
|
||||||
|
/// Issue an error if user doesn't set policy status to NEW and hits the
|
||||||
|
/// check
|
||||||
|
REQUIRED_IF_USED,
|
||||||
|
REQUIRED_ALWAYS ///< Issue an error unless user sets policy status to NEW.
|
||||||
|
};
|
||||||
static const char* PolicyStatusNames[];
|
static const char* PolicyStatusNames[];
|
||||||
|
|
||||||
|
/// Policy identifiers
|
||||||
enum PolicyID
|
enum PolicyID
|
||||||
{
|
{
|
||||||
CMP0000, // Policy version specification
|
CMP0000, ///< Policy version specification
|
||||||
CMP0001, // Ignore old compatibility variable
|
CMP0001, ///< Ignore old compatibility variable
|
||||||
CMP0002, // Target names must be unique
|
CMP0002, ///< Target names must be unique
|
||||||
CMP0003, // Linking does not include extra -L paths
|
CMP0003, ///< Linking does not include extra -L paths
|
||||||
CMP0004, // Libraries linked may not have leading or trailing whitespace
|
CMP0004, ///< Libraries linked may not have leading or trailing whitespace
|
||||||
CMP0005, // Definition value escaping
|
CMP0005, ///< Definition value escaping
|
||||||
CMP0006, // BUNDLE install rules needed for MACOSX_BUNDLE targets
|
CMP0006, ///< BUNDLE install rules needed for MACOSX_BUNDLE targets
|
||||||
CMP0007, // list command handling of empty elements
|
CMP0007, ///< list command handling of empty elements
|
||||||
CMP0008, // Full-path libraries must be a valid library file name
|
CMP0008, ///< Full-path libraries must be a valid library file name
|
||||||
CMP0009, // GLOB_RECURSE should not follow symlinks by default
|
CMP0009, ///< GLOB_RECURSE should not follow symlinks by default
|
||||||
CMP0010, // Bad variable reference syntax is an error
|
CMP0010, ///< Bad variable reference syntax is an error
|
||||||
CMP0011, // Strong policy scope for include and find_package
|
CMP0011, ///< Strong policy scope for include and find_package
|
||||||
CMP0012, // Recognize numbers and boolean constants in if()
|
CMP0012, ///< Recognize numbers and boolean constants in if()
|
||||||
CMP0013, // Duplicate binary directories not allowed
|
CMP0013, ///< Duplicate binary directories not allowed
|
||||||
CMP0014, // Input directories must have CMakeLists.txt
|
CMP0014, ///< Input directories must have CMakeLists.txt
|
||||||
CMP0015, // link_directories() treats paths relative to source dir
|
CMP0015, ///< link_directories() treats paths relative to source dir
|
||||||
CMP0016, // target_link_libraries() fails if only argument is not a target
|
/// target_link_libraries() fails if only argument is not a target
|
||||||
CMP0017, // Prefer files in CMAKE_ROOT when including from CMAKE_ROOT
|
CMP0016,
|
||||||
|
CMP0017, ///< Prefer files in CMAKE_ROOT when including from CMAKE_ROOT
|
||||||
|
|
||||||
// Always the last entry. Useful mostly to avoid adding a comma
|
/** \brief Always the last entry.
|
||||||
// the last policy when adding a new one.
|
*
|
||||||
|
* Useful mostly to avoid adding a comma the last policy when adding a new
|
||||||
|
* one.
|
||||||
|
*/
|
||||||
CMPCOUNT
|
CMPCOUNT
|
||||||
};
|
};
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue