diff --git a/etc/caseDicts/annotated/snappyHexMeshDict b/etc/caseDicts/annotated/snappyHexMeshDict
index 6f2569f24c71eaec1f8672866771fdea778e3e3c..754990a13c6c474545505acbb0e14c3f0a617716 100644
--- a/etc/caseDicts/annotated/snappyHexMeshDict
+++ b/etc/caseDicts/annotated/snappyHexMeshDict
@@ -29,6 +29,11 @@ addLayers       false;
 //           refinement/unrefinement
 // mergePatchFaces    false; // default true
 
+// Optional: allow patch-face merging even if differing patches. This avoids
+// splitting boundary faces and might benefit layer coverage.
+// (Note: only applicable if mergePatchFaces true)
+// mergeAcrossPatches   true;   // default false
+
 // Optional: preserve all generated patches. Default is to remove
 //          zero-sized patches.
 // keepPatches true;
@@ -214,6 +219,13 @@ castellatedMeshControls
             //      boundary : create free-standing boundary faces (baffles
             //                 but without the shared points)
             //faceType baffle;
+
+            //- Optional automatic gap refinement. See section in
+            //  refinementRegions ('gapLevel', 'gapMode')
+
+            //- Optional removal of cells in thin gaps. Start removing cells
+            //  if at refinement level 10 we're detecting thin gaps.
+            //blockLevel 10;
         }
     }