From a3ac3fb4783d7720bd5171a1f2487507ebb3e117 Mon Sep 17 00:00:00 2001
From: Mikolaj Adam Kowalski <mak60@cam.ac.uk>
Date: Sun, 2 Feb 2020 21:12:16 +0100
Subject: [PATCH] Fills gaps in docstring of Element

---
 openmc/element.py | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/openmc/element.py b/openmc/element.py
index ce9c2ce243..325042e913 100644
--- a/openmc/element.py
+++ b/openmc/element.py
@@ -68,6 +68,22 @@ class Element(str):
             is a tuple consisting of a nuclide string, the atom/weight percent,
             and the string 'ao' or 'wo'.
 
+        Raises
+        ------
+        ValueError
+            No data is available for any of natural isotopes of the element
+
+        ValueError
+            If only some natural isotopes are avaiable in cross-sections data
+            library and element is not O, W or Ta
+
+        ValueError
+            Enrichment of isotope not present in natural composition of
+            the element is requested
+
+        ValueError
+            Enrichment is requested of the element composed of single isotope
+
         Notes
         -----
         When the `enrichment` argument is specified, a correlation from
@@ -77,6 +93,8 @@ class Element(str):
         respectively, of the U235 weight fraction. The remainder of the
         isotopic weight is assigned to U238.
 
+        Function does not check if enrichment value is in a valid range <0;100>
+
         """
 
         # Get the nuclides present in nature
@@ -186,7 +204,7 @@ class Element(str):
                 abundances[nuclide] /= sum_abundances
 
         # Modify mole fractions if enrichment provided
-        # New treatment for arbitrary element
+        # New treatment for arbitrary element94.96165869352852
         # Interpret required enrichment as weight %
         elif enrichment is not None and enrichment_target is not None: