[Cmake-commits] [cmake-commits] king committed readme.txt 1.14 1.15

[cmake-commits at cmake.org]

Update of /cvsroot/CMake/CMake/Modules
In directory public:/mounts/ram/cvs-serv14471/Modules

Modified Files:
	readme.txt 
Log Message:
ENH: Improve find_package version numbering

Make the number of version components specified explicitly available.
Set variables for unspecified version components to "0" instead of
leaving them unset.  This simplifies version number handling for find-
and config-modules.  Also support a fourth "tweak" version component
since some packages use them.


Index: readme.txt
===================================================================
RCS file: /cvsroot/CMake/CMake/Modules/readme.txt,v
retrieving revision 1.14
retrieving revision 1.15
diff -C 2 -d -r1.14 -r1.15
*** readme.txt	29 Jan 2008 01:38:47 -0000	1.14
--- readme.txt	10 Sep 2008 14:11:47 -0000	1.15
***************
*** 68,85 ****
  A FindXXX.cmake module will typically be loaded by the command
  
!   FIND_PACKAGE(XXX [major[.minor[.patch]]] [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.
  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.
  
  If the QUIET option is given to the command it will set the variable
--- 68,90 ----
  A FindXXX.cmake module will typically be loaded by the command
  
!   FIND_PACKAGE(XXX [major[.minor[.patch[.tweak]]]] [EXACT]
                 [QUIET] [REQUIRED [components...]])
  
  If any version numbers are given to the command it will set the
! 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 "XXX_VERSION..." version variables docmented by the module.
  
  If the QUIET option is given to the command it will set the variable