From e2a95a5addc7fe0d11f29a1a649f31956c5d75e1 Mon Sep 17 00:00:00 2001
From: YoungHui Park <ypark234@wisc.edu>
Date: Thu, 5 Nov 2020 22:42:22 -0600
Subject: [PATCH] Update settings specification with surf_src_read/write

---
 docs/source/io_formats/settings.rst | 36 +++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/docs/source/io_formats/settings.rst b/docs/source/io_formats/settings.rst
index 588b58b478..47985938ba 100644
--- a/docs/source/io_formats/settings.rst
+++ b/docs/source/io_formats/settings.rst
@@ -723,6 +723,42 @@ attributes/sub-elements:
 
     *Default*: false
 
+---------------------------
+``<surf_src_read>`` Element
+---------------------------
+
+The ``<surf_src_read>`` element specifies a surface source file for OpenMC to
+read source bank for initializing batches.
+This element has the following attributes/sub-elements:
+
+  :path:
+    Absolute or relative path to a surface source file to read in source bank.
+
+    *Default*: ``surface_source.h5`` in current working directory
+
+----------------------------
+``<surf_src_write>`` Element
+----------------------------
+
+The ``<surf_src_write>`` element triggers OpenMC to bank particles crossing
+certain surfaces and write out the source bank in a separate file called
+``surface_source.h5``.
+This element has the following attributes/sub-elements:
+
+  :surf_ids:
+    A list of integers separated by spaces indicating the unique IDs of surfaces
+    for which crossing particles will be banked.
+
+    *Default*: None
+
+  :max_surf_banks:
+    An integer indicating the maximum number of particles to be banked on
+    specified surfaces per processor. The size of source bank in
+    ``surface_source.h5`` is limited to this value times the number of
+    processors.
+
+    *Default*: None
+
 ------------------------------
 ``<survival_biasing>`` Element
 ------------------------------