From d63fa5c0b5acec9f7566e965d1fcbdb97df73478 Mon Sep 17 00:00:00 2001
From: AnyOldName3 <krizdjali+github@gmail.com>
Date: Wed, 27 Dec 2017 04:01:10 +0000
Subject: [PATCH] Add rst documentation for the shadow settings.

---
 .../reference/modding/settings/index.rst      |  1 +
 .../reference/modding/settings/shadows.rst    | 89 +++++++++++++++++++
 2 files changed, 90 insertions(+)
 create mode 100644 docs/source/reference/modding/settings/shadows.rst

diff --git a/docs/source/reference/modding/settings/index.rst b/docs/source/reference/modding/settings/index.rst
index 56d76a8d1..a11df35a3 100644
--- a/docs/source/reference/modding/settings/index.rst
+++ b/docs/source/reference/modding/settings/index.rst
@@ -31,6 +31,7 @@ The ranges I have included with each setting are the physically possible ranges,
 	game
 	general
 	shaders
+	shadows
 	input
 	saves
 	sound
diff --git a/docs/source/reference/modding/settings/shadows.rst b/docs/source/reference/modding/settings/shadows.rst
new file mode 100644
index 000000000..d8e862479
--- /dev/null
+++ b/docs/source/reference/modding/settings/shadows.rst
@@ -0,0 +1,89 @@
+Shadow Settings
+###############
+
+enable shadows
+--------------
+
+:Type:		boolean
+:Range:		True/False
+:Default:	False
+
+Enable or disable the rendering of shadows.
+Unlike in the original Morrowind engine, 'Shadow Mapping' is used, which can have a performance impact, but has more realistic results.
+
+number of shadow maps
+---------------------
+
+:Type:		integer
+:Range:		1 to 8, but higher values may conflict with other texture effects
+:Default:	1
+
+Control how many shadow maps to use - more of these means each shadow map texel covers less area, producing better-looking shadows, but may decrease performance.
+Using too many shadow maps will lead to them overriding texture slots used for other effects, producing unpleasant artefacts.
+A value of three is recommended in most cases, but other values may produce better results or performance.
+
+enable debug hud
+----------------
+
+:Type:		boolean
+:Range:		True/False
+:Default:	False
+
+Enable or disable the debug hud to see what the shadow map(s) contain.
+This setting is only recommended for developers, bug reporting and advanced users performing fine-tuning of shadow settings.
+
+compute tight scene bounds
+--------------------------
+
+:Type:		boolean
+:Range:		True/False
+:Default:	False
+
+With this setting enabled, attempt to better use the shadow map(s) by making them cover a smaller area.
+This can be especially helpful when looking downwards with a high viewing distance but will be less useful with the default value.
+The performance impact of this may be very large.
+
+shadow map resolution
+---------------------
+
+:Type:		integer
+:Range:		Dependent on GPU/driver combination
+:Default:	1024
+
+Control How large to make the shadow map(s).
+Higher values increase GPU load but can produce better-looking results.
+Power-of-two values may turn out to be faster than smaller values which are not powers of two on some GPU/driver combinations.
+
+actor shadows
+-------------
+
+:Type:		boolean
+:Range:		True/False
+:Default:	False
+
+Allow actors to cast shadows.
+Potentially decreases performance.
+
+player shadows
+--------------
+
+:Type:		boolean
+:Range:		True/False
+:Default:	False
+
+Allow the player to cast shadows.
+Potentially decreases performance.
+
+terrain shadows
+---------------
+
+:Type:		boolean
+:Range:		True/False
+:Default:	False
+
+Allow terrain to cast shadows.
+Potentially decreases performance.
+
+
+
+Note: Right now, there is no setting allowing toggling of shadows for statics
\ No newline at end of file