[Bf-blender-cvs] [1be819ea666] master: Cleanup: update comments

[Campbell Barton]

Commit: 1be819ea666058977510d907f7eae88fa1de9581
Author: Campbell Barton
Date:   Wed Oct 28 16:00:26 2020 +1100
Branches: master
https://developer.blender.org/rB1be819ea666058977510d907f7eae88fa1de9581

Cleanup: update comments

Some references to argument levels were still in comments.

===================================================================

M	source/creator/creator.c
M	source/creator/creator_intern.h

===================================================================

diff --git a/source/creator/creator.c b/source/creator/creator.c
index 90d918f71ac..4f5af4bf4ac 100644
--- a/source/creator/creator.c
+++ b/source/creator/creator.c
@@ -411,7 +411,8 @@ int main(int argc,
   G.factory_startup = true;
 #endif
 
-  /* After parsing '0' level args such as `--env-*`, since they impact `BKE_appdir` behavior. */
+  /* After parsing #ARG_PASS_ENVIRONMENT such as `--env-*`,
+   * since they impact `BKE_appdir` behavior. */
   BKE_appdir_init();
 
   /* Initialize sub-systems that use `BKE_appdir.h`. */
@@ -432,7 +433,7 @@ int main(int argc,
   IMB_ffmpeg_init();
 #endif
 
-  /* After level 1 arguments, this is so #WM_main_playanim skips #RNA_init. */
+  /* After #ARG_PASS_SETTINGS arguments, this is so #WM_main_playanim skips #RNA_init. */
   RNA_init();
 
   RE_engines_init();
diff --git a/source/creator/creator_intern.h b/source/creator/creator_intern.h
index 5f184e4cef3..0a13f45eef1 100644
--- a/source/creator/creator_intern.h
+++ b/source/creator/creator_intern.h
@@ -38,7 +38,7 @@ void main_signal_setup_fpe(void);
 
 #endif /* WITH_PYTHON_MODULE */
 
-/* Shared data for argument handlers to store state in */
+/** Shared data for argument handlers to store state in. */
 struct ApplicationState {
   struct {
     bool use_crash_handler;
@@ -57,10 +57,13 @@ extern struct ApplicationState app_state; /* creator.c */
  * Keep in order of execution.
  */
 enum {
+  /** Run before sub-system initialization. */
   ARG_PASS_ENVIRONMENT = 1,
+  /** General settings parsing, also animation player. */
   ARG_PASS_SETTINGS = 2,
-  /** Windowing & graphical settings, ignored in background mode. */
+  /** Windowing & graphical settings (ignored in background mode). */
   ARG_PASS_SETTINGS_GUI = 3,
+  /** Currently use for audio devices. */
   ARG_PASS_SETTINGS_FORCE = 4,
 
   /** Actions & fall back to loading blend file. */
@@ -95,4 +98,4 @@ extern char build_cflags[];
 extern char build_cxxflags[];
 extern char build_linkflags[];
 extern char build_system[];
-#endif
+#endif /* BUILD_DATE */