summaryrefslogtreecommitdiffstats
path: root/Modules/readme.txt
diff options
context:
space:
mode:
Diffstat (limited to 'Modules/readme.txt')
-rw-r--r--Modules/readme.txt19
1 files changed, 12 insertions, 7 deletions
diff --git a/Modules/readme.txt b/Modules/readme.txt
index 8d4615a..8e4474e 100644
--- a/Modules/readme.txt
+++ b/Modules/readme.txt
@@ -67,20 +67,25 @@ line.
A FindXXX.cmake module will typically be loaded by the command
- FIND_PACKAGE(XXX [major[.minor[.patch]]] [EXACT]
+ FIND_PACKAGE(XXX [major[.minor[.patch[.tweak]]]] [EXACT]
[QUIET] [REQUIRED [components...]])
If any version numbers are given to the command it will set the
-variable XXX_FIND_VERSION to contain the whole version. The variables
-XXX_FIND_VERSION_MAJOR, XXX_FIND_VERSION_MINOR, and
-XXX_FIND_VERSION_PATCH will be set to contain the corresponding
-portions of the version number. The variable XXX_FIND_VERSION_EXACT
-will indicate whether an exact version is requested.
+following variables before loading the module:
+
+ XXX_FIND_VERSION = full requested version string
+ XXX_FIND_VERSION_MAJOR = major version if requested, else 0
+ XXX_FIND_VERSION_MINOR = minor version if requested, else 0
+ XXX_FIND_VERSION_PATCH = patch version if requested, else 0
+ XXX_FIND_VERSION_TWEAK = tweak version if requested, else 0
+ XXX_FIND_VERSION_COUNT = number of version components, 0 to 4
+ XXX_FIND_VERSION_EXACT = true if EXACT option was given
+
If the find module supports versioning it should locate a version of
the package that is compatible with the version requested. If a
compatible version of the package cannot be found the module should
not report success. The version of the package found should be stored
-in the version variables named above.
+in "XXX_VERSION..." version variables docmented by the module.
If the QUIET option is given to the command it will set the variable
XXX_FIND_QUIETLY to true before loading the FindXXX.cmake module. If