Comment fixes.

git-svn-id: https://crawl-ref.svn.sourceforge.net/svnroot/crawl-ref/trunk@9054 c06c8d41-db1a-0410-9941-cceddc491573

1 files changed, 20 insertions, 11 deletions

diff --git a/crawl-ref/source/randart.cc b/crawl-ref/source/randart.cc
index c076adfdeb..ce912f8ed7 100644
--- a/crawl-ref/source/randart.cc
+++ b/crawl-ref/source/randart.cc
@@ -52,7 +52,8 @@ static bool _god_fits_artefact(const god_type which_god, const item_def &item,
     bool type_bad = false;
     switch (which_god)
     {
-    case GOD_ELYVILON: // peaceful healer god, no weapons, no berserking
+    case GOD_ELYVILON:
+        // Peaceful healer god: no weapons, no berserking.
         if (item.base_type == OBJ_WEAPONS)
             type_bad = true;
 
@@ -60,12 +61,14 @@ static bool _god_fits_artefact(const god_type which_god, const item_def &item,
             type_bad = true;
         break;
 
-    case GOD_OKAWARU: // precision fighter
+    case GOD_OKAWARU:
+        // Precision fighter god: no inaccuracy.
         if (item.base_type == OBJ_JEWELLERY && item.sub_type == AMU_INACCURACY)
             type_bad = true;
         break;
 
     case GOD_ZIN:
+        // Lawful god: no increased hunger.
         if (item.base_type == OBJ_JEWELLERY && item.sub_type == RING_HUNGER)
             type_bad = true;
         break;
@@ -79,11 +82,10 @@ static bool _god_fits_artefact(const god_type which_god, const item_def &item,
         break;
 
     case GOD_TROG:
-        // Trog hates spell use.
+        // Anti-magic god: no spell use, no enhancing magic.
         if (item.base_type == OBJ_BOOKS)
             type_bad = true;
 
-        // hates anything enhancing magic
         if (item.base_type == OBJ_JEWELLERY && (item.sub_type == RING_WIZARDRY
             || item.sub_type == RING_FIRE || item.sub_type == RING_ICE
             || item.sub_type == RING_MAGICAL_POWER))
@@ -123,11 +125,13 @@ static bool _god_fits_artefact(const god_type which_god, const item_def &item,
     switch (which_god)
     {
     case GOD_BEOGH:
+        // Orc god: no orc slaying.
         if (brand == SPWPN_ORC_SLAYING)
-            return (false); // goes against orcish theme
+            return (false);
         break;
 
-    case GOD_ELYVILON: // peaceful healer god, no weapons, no berserking
+    case GOD_ELYVILON:
+        // Peaceful healer god: no berserking.
         if (randart_wpn_property(item, RAP_ANGRY)
             || randart_wpn_property(item, RAP_BERSERK))
         {
@@ -136,11 +140,13 @@ static bool _god_fits_artefact(const god_type which_god, const item_def &item,
         break;
 
     case GOD_ZIN:
+        // Lawful god: no mutagenics.
         if (randart_wpn_property(item, RAP_MUTAGENIC))
-            return (false); // goes against anti-mutagenic theme
+            return (false);
         break;
 
-    case GOD_SHINING_ONE: // holiness, honourable combat
+    case GOD_SHINING_ONE:
+        // Crusader god: holiness, honourable combat.
         if (item.base_type == OBJ_WEAPONS && brand != SPWPN_HOLY_WRATH)
             return (false);
 
@@ -151,7 +157,8 @@ static bool _god_fits_artefact(const god_type which_god, const item_def &item,
         }
         break;
 
-    case GOD_LUGONU: // corruption
+    case GOD_LUGONU:
+        // Abyss god: corruption.
         if (item.base_type == OBJ_WEAPONS && brand != SPWPN_DISTORTION)
             return (false);
         break;
@@ -159,12 +166,14 @@ static bool _god_fits_artefact(const god_type which_god, const item_def &item,
     case GOD_SIF_MUNA:
     case GOD_KIKUBAAQUDGHA:
     case GOD_VEHUMET:
+        // The magic gods: no preventing spellcasting.
         if (randart_wpn_property(item, RAP_PREVENT_SPELLCASTING))
             return (false);
         break;
 
-    case GOD_TROG: // hates anything enhancing magic
-        if (brand == SPWPN_PAIN) // involves necromantic magic
+    case GOD_TROG:
+        // Anti-magic god: no spell use, no enhancing magic.
+        if (brand == SPWPN_PAIN) // Pain involves necromantic spell use.
             return (false);
 
         if (randart_wpn_property(item, RAP_MAGICAL_POWER))