STYLE: Note find_package COMPONENTS in modules doc

This mentions the COMPONENTS option of find_package in the module author
documentation file "Modules/readme.txt".  See issue #8539.
This commit is contained in:
Brad King 2009-02-16 10:33:09 -05:00
parent 1b499f0019
commit 0d34d44917
1 changed files with 3 additions and 2 deletions

View File

@ -68,7 +68,7 @@ line.
A FindXXX.cmake module will typically be loaded by the command A FindXXX.cmake module will typically be loaded by the command
FIND_PACKAGE(XXX [major[.minor[.patch[.tweak]]]] [EXACT] FIND_PACKAGE(XXX [major[.minor[.patch[.tweak]]]] [EXACT]
[QUIET] [REQUIRED [components...]]) [QUIET] [[REQUIRED|COMPONENTS] [components...]])
If any version numbers are given to the command it will set the If any version numbers are given to the command it will set the
following variables before loading the module: following variables before loading the module:
@ -96,7 +96,8 @@ XXX_FIND_REQUIRED to true before loading the FindXXX.cmake module. If
this variable is set the module should issue a FATAL_ERROR if the this variable is set the module should issue a FATAL_ERROR if the
package cannot be found. For each package-specific component, say package cannot be found. For each package-specific component, say
YYY, listed after the REQUIRED option a variable XXX_FIND_REQUIRED_YYY YYY, listed after the REQUIRED option a variable XXX_FIND_REQUIRED_YYY
to true. The set of components listed will also be specified in a to true. The set of components listed after either the REQUIRED
option or the COMPONENTS option will be specified in a
XXX_FIND_COMPONENTS variable. This can be used by the FindXXX.cmake XXX_FIND_COMPONENTS variable. This can be used by the FindXXX.cmake
module to determine which sub-components of the package must be found. module to determine which sub-components of the package must be found.
If neither the QUIET nor REQUIRED options are given then the If neither the QUIET nor REQUIRED options are given then the