STYLE: adjust wording, file-layout

- comments in bashrc, cshrc.
- about controlDict names for allowSystemOperations

etc/bashrc

@@ -54,7 +54,7 @@ FOAM_INST_DIR="$HOME/$WM_PROJECT"
 #
 # END OF (NORMAL) USER EDITABLE PART
 ################################################################################
-: # Extra safety - if the user commented out all fallback values
+: # Safety statement (if the user removed all fallback values)
 unset rc
 
 # Configuration environment variables.
@@ -94,7 +94,7 @@ export WM_MPLIB=SYSTEMOPENMPI
 
 
 #------------------------------------------------------------------------------
-# (legacy / advanced)
+# (advanced / legacy)
 #
 # [FOAM_SIGFPE] - Trap floating-point exceptions.
 #               - overrides the 'trapFpe' controlDict entry
@@ -110,9 +110,17 @@ export WM_MPLIB=SYSTEMOPENMPI
 # = POSIX
 #export WM_OSTYPE=POSIX
 
+# [FOAM_JOB_DIR] - location of jobControl
+#                - unset: equivalent to ~/.OpenFOAM/jobControl
+# export FOAM_JOB_DIR="$HOME/.OpenFOAM/jobControl"
+
+# [FOAM_CODE_TEMPLATES] - dynamicCode templates
+# - unset: uses 'foamEtcFile -list codeTemplates/dynamicCode'
+##export FOAM_CODE_TEMPLATES="$WM_PROJECT_DIR/etc/codeTemplates/dynamicCode"
+
 ################################################################################
 
-# Old directories to be cleaned from PATH, LD_LIBRARY_PATH
+# Capture values of old directories to be cleaned from PATH, LD_LIBRARY_PATH
 foamOldDirs="$WM_PROJECT_DIR $WM_THIRD_PARTY_DIR \
     $HOME/$WM_PROJECT/$USER $FOAM_USER_APPBIN $FOAM_USER_LIBBIN \
     $WM_PROJECT_SITE $FOAM_SITE_APPBIN $FOAM_SITE_LIBBIN"
@@ -122,6 +130,9 @@ export WM_PROJECT_INST_DIR=$FOAM_INST_DIR
 export WM_PROJECT_DIR=$WM_PROJECT_INST_DIR/$WM_PROJECT-$WM_PROJECT_VERSION
 export WM_THIRD_PARTY_DIR=$WM_PROJECT_INST_DIR/ThirdParty-$WM_PROJECT_VERSION
 
+# [WM_PROJECT_USER_DIR] - Location of user files
+export WM_PROJECT_USER_DIR=$HOME/$WM_PROJECT/$USER-$WM_PROJECT_VERSION
+
 # [WM_PROJECT_SITE] - Location of site-specific (group) files
 # default (unset) implies WM_PROJECT_INST_DIR/site
 if [ -d "$WM_PROJECT_SITE" ]
@@ -131,9 +142,6 @@ else
     unset WM_PROJECT_SITE
 fi
 
-# [WM_PROJECT_USER_DIR] - Location of user files
-export WM_PROJECT_USER_DIR=$HOME/$WM_PROJECT/$USER-$WM_PROJECT_VERSION
-
 # Load shell functions
 unset WM_SHELL_FUNCTIONS
 . $WM_PROJECT_DIR/etc/config.sh/functions