From 8ae0a3b5a6518a573f1287356f23d7a03398678a Mon Sep 17 00:00:00 2001
From: Ruby Rose <deadsurgeon42@gmail.com>
Date: Thu, 8 Jun 2017 17:18:38 +0300
Subject: [PATCH] Write proper docs

---
 TShockAPI/TSPlayer.cs | 22 ++++++++++++++++++----
 1 file changed, 18 insertions(+), 4 deletions(-)

diff --git a/TShockAPI/TSPlayer.cs b/TShockAPI/TSPlayer.cs
index 9b42d7b4..42d1b157 100644
--- a/TShockAPI/TSPlayer.cs
+++ b/TShockAPI/TSPlayer.cs
@@ -1254,19 +1254,33 @@ namespace TShockAPI
 				return Group.HasPermission(permission);
 		}
 
-		/// <inheritdoc cref="HasPermission(string)"/>
+		/// <summary>
+		/// Checks to see if a player has permission to use the specific banned item.
+		/// Fires the <see cref="PlayerHooks.OnPlayerItembanPermission"/> hook which may be handled to override item ban permission checks.
+		/// </summary>
+		/// <param name="bannedItem">The <see cref="ItemBan" /> to check.</param>
+		/// <returns>True if the player has permission to use the banned item.</returns>
 		public bool HasPermission(ItemBan bannedItem)
 		{
 			return TShock.Itembans.ItemIsBanned(bannedItem.Name, this);
 		}
 
-		/// <inheritdoc cref="HasPermission(string)"/>
+		/// <summary>
+		/// Checks to see if a player has permission to use the specific banned projectile.
+		/// Fires the <see cref="PlayerHooks.OnPlayerProjbanPermission"/> hook which may be handled to override projectile ban permission checks.
+		/// </summary>
+		/// <param name="bannedProj">The <see cref="ProjectileBan" /> to check.</param>
+		/// <returns>True if the player has permission to use the banned projectile.</returns>
 		public bool HasPermission(ProjectileBan bannedProj)
 		{
 			return TShock.ProjectileBans.ProjectileIsBanned(bannedProj.ID, this);
 		}
-
-		/// <inheritdoc cref="HasPermission(string)"/>
+		/// <summary>
+		/// Checks to see if a player has permission to use the specific banned tile.
+		/// Fires the <see cref="PlayerHooks.OnPlayerTilebanPermission"/> hook which may be handled to override tile ban permission checks.
+		/// </summary>
+		/// <param name="bannedTile">The <see cref="TileBan" /> to check.</param>
+		/// <returns>True if the player has permission to use the banned tile.</returns>
 		public bool HasPermission(TileBan bannedTile)
 		{
 			return TShock.TileBans.TileIsBanned(bannedTile.ID, this);