guides/upgrade/v1612-User-Upgrade-Guide.md

+<!-- --- title: User Upgrade Guide (OpenFOAM-v1612) -->
+
+[Back to Upgrade Guides](/guides/upgrade/upgrade)
+
+## General input
+
+Dictionary keyword entries including the text "Name" have been shortened, e.g. `pName` becomes `p`, `phiName` becomes `phi` etc.
+
+## Function objects
+
+* keywords: `outputControl` renamed `writeControl`
+* library locations: `functionObjectLibs` renamed `libs`
+* `faceSource` renamed `surfaceFieldValue`
+* `cellSource` renamed `volFieldValue`
+* `pressureTools` renamed `pressure`
+* `createTurbulenceFields` renamed `turbulenceFields`
+* `Peclet` renamed `PecletNo`
+
+## Utilities
+
+* `foamCalc` and `foamExecFlowFunctionObjects` absorbed into the new
+`postProcess` utility. More details in [v1612-utility-postProcess](v1612-utility-postProcess).
+* many utilities converted into function objects
+* the input format for the `changeDictionary` utility has been simplified. In earlier releases the input followed, e.g.:
+
+```
+    dictionaryReplacement
+    {
+        U
+        {
+            internalField   uniform (1 0 0);
+        }
+    }
+```
+
+The new syntax removes the outer dictionary level, i.e.
+
+```
+    U
+    {
+        internalField   uniform (1 0 0);
+    }
+```
+
+## Deprecated utilities
+
+* `expandDictionary` becomes `foamDictionary -expand`
+* `foamDebugSwitches` becomes `foamDictionary/foamList -debug`
+* `foamInfoExec` becomes `foamDictionary`
+* `secondaryWrite` behaviour can be recovered using function object time controls
+* `execFlowFunctionObjects` becomes `postProcess`