From f13c4c7218103e7d7be9902ae8646e3f8ad95156 Mon Sep 17 00:00:00 2001
From: Paul Romano <paul.k.romano@gmail.com>
Date: Sun, 13 Sep 2015 11:36:55 +0700
Subject: [PATCH] Add source file format in documentation.

---
 docs/source/devguide/index.rst  |  1 +
 docs/source/devguide/source.rst | 21 +++++++++++++++++++++
 2 files changed, 22 insertions(+)
 create mode 100644 docs/source/devguide/source.rst

diff --git a/docs/source/devguide/index.rst b/docs/source/devguide/index.rst
index 3f87ecfad2..02015cfb4b 100644
--- a/docs/source/devguide/index.rst
+++ b/docs/source/devguide/index.rst
@@ -17,6 +17,7 @@ as debugging.
     workflow
     xml-parsing
     statepoint
+    source
     particle_restart
     track
     voxel
diff --git a/docs/source/devguide/source.rst b/docs/source/devguide/source.rst
new file mode 100644
index 0000000000..20457fb116
--- /dev/null
+++ b/docs/source/devguide/source.rst
@@ -0,0 +1,21 @@
+.. _devguide_source:
+
+==================
+Source File Format
+==================
+
+Normally, source data is stored in a state point file. However, it is possible
+to request that the source be written separately, in which case the format used
+is that documented here.
+
+**/filetype** (*int*)
+
+    Flags what type of file this is. A value of -1 indicates a statepoint file,
+    a value of -2 indicates a particle restart file, a value of -3 indicates a
+    source file, and a value of -4 indicates a track file.
+
+**/source_bank** (Compound type)
+
+    Source bank information for each particle. The compound type has fields
+    ``wgt``, ``xyz``, ``uvw``, and ``E`` which represent the weight, position,
+    direction, and energy of the source particle, respectively.