summaryrefslogtreecommitdiffstats
path: root/Source/cmake.h
diff options
context:
space:
mode:
Diffstat (limited to 'Source/cmake.h')
-rw-r--r--Source/cmake.h19
1 files changed, 19 insertions, 0 deletions
diff --git a/Source/cmake.h b/Source/cmake.h
index d2ac956..3a9c165 100644
--- a/Source/cmake.h
+++ b/Source/cmake.h
@@ -17,6 +17,25 @@
// This class represents a cmake invocation. It is the top level class when
// running cmake. Most cmake based GUIS should primarily create an instance
// of this class and communicate with it.
+//
+// The basic process for a GUI is as follows:
+//
+// 1) Create a cmake instance
+// 2) Set the Home & Start directories, generator, and cmake command. this
+// can be done using the Set methods or by using SetArgs and passing in
+// command line arguments.
+// 3) Load the cache by calling LoadCache (duh)
+// 4) if you are using command line arguments with -D or -C flags then
+// call SetCacheArgs (or if for some other reason you want to modify the
+// cache, do it now.
+// 5) Finally call Configure
+// 6) Let the user change values and go back to step 5
+// 7) call Generate
+//
+// If your GUI allows the user to change the start & home directories then
+// you must at a minimum redo steps 2 through 7.
+//
+
#include "cmStandardIncludes.h"
#include "cmSystemTools.h"