diff --git a/.gitignore b/.gitignore
index 1b8ce3cde3..67ac189fcc 100644
--- a/.gitignore
+++ b/.gitignore
@@ -60,6 +60,8 @@ doc/[Dd]oxygen/man
# untracked configuration files
/etc/prefs.csh
/etc/prefs.sh
+/etc/config/prefs.csh
+/etc/config/prefs.sh
# source packages - anywhere
*.tar.bz2
diff --git a/etc/bashrc b/etc/bashrc
index 3aaff82598..62c9854d95 100644
--- a/etc/bashrc
+++ b/etc/bashrc
@@ -177,7 +177,7 @@ _foamEval()
_foamSource `$WM_PROJECT_DIR/bin/foamEtcFile prefs.sh`
# Evaluate command-line parameters and record settings for later
-# these can be used to set/unset values, or specify prefs files
+# these can be used to set/unset values, or specify alternative pref files
export FOAM_SETTINGS="$@"
_foamEval $@
@@ -201,7 +201,7 @@ export PATH LD_LIBRARY_PATH MANPATH
# Source project setup files
# ~~~~~~~~~~~~~~~~~~~~~~~~~~
_foamSource $WM_PROJECT_DIR/etc/settings.sh
-_foamSource $WM_PROJECT_DIR/etc/aliases.sh
+_foamSource $WM_PROJECT_DIR/etc/config/aliases.sh
# Source user setup files for optional packages
diff --git a/etc/config/README b/etc/config/README
new file mode 100644
index 0000000000..8c22b46016
--- /dev/null
+++ b/etc/config/README
@@ -0,0 +1,51 @@
+The main OpenFOAM settings are located in the parent etc/ directory
+
+* bashrc, cshrc
+ entry point for sourcing
+
+* settings.csh, settings.sh
+ core settings
+
+* prefs.csh, prefs.sh
+ these files are untracked and can be used for some site-defined
+ settings
+
+
+The etc/config/ directory contains various configuration files in
+sh/csh variants:
+
+* aliases.csh, aliases.sh
+ aliases for interactive shells
+
+* unset.csh, unset.sh
+ sourced to clear as many OpenFOAM environment settings as possible
+
+
+* ensight.csh, ensight.sh
+ application settings for EnSight
+
+* paraview.csh, paraview.sh
+ application settings for ParaView
+
+* scotch.sh
+ application settings for compiling against scotch
+
+---
+
+The config/example directory contains various example configuration files
+in sh/csh variants
+
+* compiler.csh, compiler.sh
+ an example of fine tuning ThirdParty compiler settings for OpenFOAM
+
+* openmpi.csh, openmpi.sh
+ an example of fine tuning openmpi settings for OpenFOAM
+
+* paraview.csh, paraview.sh
+ an example of chaining to the standard config/paraview.sh with a
+ different ParaView_VERSION
+
+* prefs.csh, prefs.sh
+ an example of supplying alternative site-defined settings
+
+---
diff --git a/etc/aliases.csh b/etc/config/aliases.csh
similarity index 96%
rename from etc/aliases.csh
rename to etc/config/aliases.csh
index 5c5b344497..6573c91973 100644
--- a/etc/aliases.csh
+++ b/etc/config/aliases.csh
@@ -22,7 +22,7 @@
# along with OpenFOAM. If not, see .
#
# File
-# etc/aliases.csh
+# etc/config/aliases.csh
#
# Description
# Aliases for working with OpenFOAM
@@ -39,7 +39,7 @@ alias wmSP 'wmSET WM_PRECISION_OPTION=SP'
alias wmDP 'wmSET WM_PRECISION_OPTION=DP'
# clear env
-alias wmUNSET='source $WM_PROJECT_DIR/etc/unset.csh'
+alias wmUNSET='source $WM_PROJECT_DIR/etc/config/unset.csh'
# Toggle wmakeScheduler on/off
# - also need to set WM_HOSTS
diff --git a/etc/aliases.sh b/etc/config/aliases.sh
similarity index 97%
rename from etc/aliases.sh
rename to etc/config/aliases.sh
index df0fda7389..188159745c 100644
--- a/etc/aliases.sh
+++ b/etc/config/aliases.sh
@@ -22,7 +22,7 @@
# along with OpenFOAM. If not, see .
#
# File
-# etc/aliases.sh
+# etc/config/aliases.sh
#
# Description
# Aliases for working with OpenFOAM
@@ -39,7 +39,7 @@ alias wmSP='wmSET WM_PRECISION_OPTION=SP'
alias wmDP='wmSET WM_PRECISION_OPTION=DP'
# clear env
-alias wmUNSET='. $WM_PROJECT_DIR/etc/unset.sh'
+alias wmUNSET='. $WM_PROJECT_DIR/etc/config/unset.sh'
# Toggle wmakeScheduler on/off
# - also need to set WM_HOSTS
diff --git a/etc/config/ensight.csh b/etc/config/ensight.csh
index b1ce4ba112..484fa0fc02 100644
--- a/etc/config/ensight.csh
+++ b/etc/config/ensight.csh
@@ -2,7 +2,7 @@
# ========= |
# \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
# \\ / O peration |
-# \\ / A nd | Copyright (C) 2004-2010 OpenCFD Ltd.
+# \\ / A nd | Copyright (C) 2004-2011 OpenCFD Ltd.
# \\/ M anipulation |
#-------------------------------------------------------------------------------
# License
diff --git a/etc/config/ensight.sh b/etc/config/ensight.sh
index 16ac2bd839..597c51c010 100644
--- a/etc/config/ensight.sh
+++ b/etc/config/ensight.sh
@@ -2,7 +2,7 @@
# ========= |
# \\ / F ield | OpenFOAM: The Open Source CFD Toolbox
# \\ / O peration |
-# \\ / A nd | Copyright (C) 2004-2010 OpenCFD Ltd.
+# \\ / A nd | Copyright (C) 2004-2011 OpenCFD Ltd.
# \\/ M anipulation |
#------------------------------------------------------------------------------
# License
diff --git a/etc/prefs.csh-EXAMPLE b/etc/config/example/prefs.csh
similarity index 98%
rename from etc/prefs.csh-EXAMPLE
rename to etc/config/example/prefs.csh
index 56091f798e..83f7a7b7b4 100644
--- a/etc/prefs.csh-EXAMPLE
+++ b/etc/config/example/prefs.csh
@@ -22,7 +22,7 @@
# along with OpenFOAM. If not, see .
#
# File
-# etc/prefs.csh
+# config/example/prefs.csh
#
# Description
# Preset variables for the OpenFOAM configuration - C-Shell shell syntax.
diff --git a/etc/prefs.sh-EXAMPLE b/etc/config/example/prefs.sh
similarity index 98%
rename from etc/prefs.sh-EXAMPLE
rename to etc/config/example/prefs.sh
index f3e771d030..d2251ce63f 100644
--- a/etc/prefs.sh-EXAMPLE
+++ b/etc/config/example/prefs.sh
@@ -22,7 +22,7 @@
# along with OpenFOAM. If not, see .
#
# File
-# etc/prefs.sh
+# config/example/prefs.sh
#
# Description
# Preset variables for the OpenFOAM configuration - POSIX shell syntax.
diff --git a/etc/unset.csh b/etc/config/unset.csh
similarity index 99%
rename from etc/unset.csh
rename to etc/config/unset.csh
index 48a1637912..d9a3d69787 100644
--- a/etc/unset.csh
+++ b/etc/config/unset.csh
@@ -22,7 +22,7 @@
# along with OpenFOAM. If not, see .
#
# File
-# etc/unset.csh
+# etc/config/unset.csh
#
# Description
# Clear as many OpenFOAM environment settings as possible
diff --git a/etc/unset.sh b/etc/config/unset.sh
similarity index 99%
rename from etc/unset.sh
rename to etc/config/unset.sh
index 23e182aa53..66ee2e35b5 100644
--- a/etc/unset.sh
+++ b/etc/config/unset.sh
@@ -22,7 +22,7 @@
# along with OpenFOAM. If not, see .
#
# File
-# etc/unset.sh
+# etc/config/unset.sh
#
# Description
# Clear as many OpenFOAM environment settings as possible
diff --git a/etc/cshrc b/etc/cshrc
index 330fd66aa9..c87986832a 100644
--- a/etc/cshrc
+++ b/etc/cshrc
@@ -138,7 +138,7 @@ alias _foamSource 'if ($?FOAM_VERBOSE && $?prompt) echo "Sourcing: \!*"; if (\!*
_foamSource `$WM_PROJECT_DIR/bin/foamEtcFile prefs.csh`
# Evaluate command-line parameters and record settings for later
-# these can be used to set/unset values, or specify prefs files
+# these can be used to set/unset values, or specify alternative pref files
setenv FOAM_SETTINGS "${*}"
while ( $#argv > 0 )
switch ($argv[1])
@@ -195,7 +195,7 @@ if ( $status == 0 ) setenv MANPATH $cleaned
# Source project setup files
# ~~~~~~~~~~~~~~~~~~~~~~~~~~
_foamSource $WM_PROJECT_DIR/etc/settings.csh
-_foamSource $WM_PROJECT_DIR/etc/aliases.csh
+_foamSource $WM_PROJECT_DIR/etc/config/aliases.csh
# Source user setup files for optional packages
# ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~