1 files changed, 14 insertions, 0 deletions
diff --git a/source/blender/blenkernel/BKE_main.h b/source/blender/blenkernel/BKE_main.h
index 0048ad4dde5..7c3a64f1cad 100644
--- a/source/blender/blenkernel/BKE_main.h
+++ b/source/blender/blenkernel/BKE_main.h
@@ -138,6 +138,14 @@ typedef struct Main {
    */
   bool is_locked_for_linking;
 
+  /**
+   * True if this main is the 'GMAIN' of current Blender.
+   *
+   * \note There should always be only one global main, all others generated temporarily for
+   * various data management process must have this property set to false..
+   */
+  bool is_global_main;
+
   BlendThumbnail *blen_thumb;
 
   struct Library *curlib;
@@ -202,6 +210,12 @@ typedef struct Main {
   struct MainLock *lock;
 } Main;
 
+/**
+ * Create a new Main data-base.
+ *
+ * \note Always generate a non-global Main, use #BKE_blender_globals_main_replace to put a newly
+ * created one in `G_MAIN`.
+ */
 struct Main *BKE_main_new(void);
 void BKE_main_free(struct Main *mainvar);