ENH: Define STRINGS cache entry property

This property defines a list of values for a cache entry of type STRING.
A CMake GUI may optionally use a drop-down selection widget for the
entry instead of a generic text entry field.  We do not enforce that the
value of the entry match one of the strings listed.

1 files changed, 11 insertions, 0 deletions

diff --git a/Source/cmCacheManager.cxx b/Source/cmCacheManager.cxx
index f65c80d..bc3830f 100644
--- a/Source/cmCacheManager.cxx
+++ b/Source/cmCacheManager.cxx
@@ -357,6 +357,7 @@ const char* cmCacheManager::PersistentProperties[] =
 {
   "ADVANCED",
   "MODIFIED",
+  "STRINGS",
   0
 };
 
@@ -988,6 +989,16 @@ void cmCacheManager::DefineProperties(cmake *cm)
       );
 
   cm->DefineProperty
+    ("STRINGS", cmProperty::CACHE,
+     "Enumerate possible STRING entry values for GUI selection.",
+     "For cache entries with type STRING, this enumerates a set of values.  "
+     "CMake GUIs may use this to provide a selection widget instead of a "
+     "generic string entry field.  "
+     "This is for convenience only.  "
+     "CMake does not enforce that the value matches one of those listed."
+      );
+
+  cm->DefineProperty
     ("VALUE", cmProperty::CACHE,
      "Value of a cache entry.",
      "This property maps to the actual value of a cache entry.  "