Updated XML documentation for several methods

This commit is contained in:
Lucas Nicodemus 2015-04-12 23:39:04 -06:00
parent 726576e3e0
commit 417ffbc740
7 changed files with 17 additions and 19 deletions

View file

@ -210,6 +210,8 @@ namespace TShockAPI.DB
/// <param name="parentname">parent of group</param>
/// <param name="permissions">permissions</param>
/// <param name="chatcolor">chatcolor</param>
/// <param name="suffix">suffix</param>
/// <param name="prefix">prefix</param> //why is suffix before prefix?!
public void UpdateGroup(string name, string parentname, string permissions, string chatcolor, string suffix, string prefix)
{
Group group = GetGroupByName(name);

View file

@ -106,7 +106,7 @@ namespace TShockAPI.DB
/// Sets the Hashed Password for a given username
/// </summary>
/// <param name="user">User user</param>
/// <param name="group">string password</param>
/// <param name="password">string password</param>
public void SetUserPassword(User user, string password)
{
try
@ -126,7 +126,7 @@ namespace TShockAPI.DB
/// Sets the UUID for a given username
/// </summary>
/// <param name="user">User user</param>
/// <param name="group">string uuid</param>
/// <param name="uuid">string uuid</param>
public void SetUserUUID(User user, string uuid)
{
try

View file

@ -34,8 +34,7 @@ namespace Rests
/// <summary>
/// Rest command delegate
/// </summary>
/// <param name="parameters">Parameters in the url</param>
/// <param name="verbs">{x} in urltemplate</param>
/// <param name="args">RestRequestArgs object containing Verbs, Parameters, Request, and TokenData</param>
/// <returns>Response object or null to not handle request</returns>
public delegate object RestCommandD(RestRequestArgs args);

View file

@ -57,8 +57,7 @@ namespace Rests
/// <summary>
/// Gets value safely, if it does not exist, return null. Sets/Adds value safely, if null it will remove.
/// </summary>
/// <param name="key"></param>
/// <param name="value"></param>
/// <param name="key">the key</param>
/// <returns>Returns null if key does not exist.</returns>
public new object this[string key]
{

View file

@ -27,8 +27,7 @@ namespace Rests
/// <summary>
/// Gets value safely, if it does not exist, return null. Sets/Adds value safely, if null it will remove.
/// </summary>
/// <param name="key"></param>
/// <param name="value"></param>
/// <param name="key">the key</param>
/// <returns>Returns null if key does not exist.</returns>
public new string this[string key]
{

View file

@ -1123,8 +1123,7 @@ namespace TShockAPI
/// <summary>
/// When a server command is run.
/// </summary>
/// <param name="cmd"></param>
/// <param name="e"></param>
/// <param name="args">The CommandEventArgs object</param>
private void ServerHooks_OnCommand(CommandEventArgs args)
{
if (args.Handled)

View file

@ -472,7 +472,6 @@ namespace TShockAPI
/// <summary>
/// Kicks all player from the server without checking for immunetokick permission.
/// </summary>
/// <param name="ply">int player</param>
/// <param name="reason">string reason</param>
public void ForceKickAll(string reason)
{
@ -540,9 +539,10 @@ namespace TShockAPI
/// <summary>
/// Kicks a player from the server without checking for immunetokick permission.
/// </summary>
/// <param name="ply">int player</param>
/// <param name="player">TSPlayer player</param>
/// <param name="reason">string reason</param>
/// <param name="silent">bool silent (default: false)</param>
/// <param name="saveSSI">bool saveSSI (default: false)</param>
public void ForceKick(TSPlayer player, string reason, bool silent = false, bool saveSSI = false)
{
Kick(player, reason, true, silent, null, saveSSI);
@ -551,7 +551,7 @@ namespace TShockAPI
/// <summary>
/// Kicks a player from the server..
/// </summary>
/// <param name="ply">int player</param>
/// <param name="player">TSPlayer player</param>
/// <param name="reason">string reason</param>
/// <param name="force">bool force (default: false)</param>
/// <param name="silent">bool silent (default: false)</param>
@ -585,10 +585,10 @@ namespace TShockAPI
/// <summary>
/// Bans and kicks a player from the server.
/// </summary>
/// <param name="ply">int player</param>
/// <param name="player">TSPlayer player</param>
/// <param name="reason">string reason</param>
/// <param name="force">bool force (default: false)</param>
/// <param name="adminUserName">bool silent (default: null)</param>
/// <param name="adminUserName">string adminUserName (default: null)</param>
public bool Ban(TSPlayer player, string reason, bool force = false, string adminUserName = null)
{
if (!player.ConnectionAlive)
@ -636,7 +636,7 @@ namespace TShockAPI
/// <summary>
/// Shows a file to the user.
/// </summary>
/// <param name="ply">TSPlayer player</param>
/// <param name="player">TSPlayer player</param>
/// <param name="file">string filename reletave to savedir</param>
public void ShowFileToUser(TSPlayer player, string file)
{
@ -674,7 +674,7 @@ namespace TShockAPI
/// <summary>
/// Returns a Group from the name of the group
/// </summary>
/// <param name="ply">string groupName</param>
/// <param name="groupName">string groupName</param>
public Group GetGroup(string groupName)
{
//first attempt on cached groups
@ -760,7 +760,7 @@ namespace TShockAPI
/// <summary>
/// Returns a Sha256 string for a given string
/// </summary>
/// <param name="bytes">bytes to hash</param>
/// <param name="password">string to hash</param>
/// <returns>string sha256</returns>
public string HashPassword(string password)
{
@ -801,7 +801,7 @@ namespace TShockAPI
/// <summary>
/// Attempts to parse a string as a timespan (_d_m_h_s).
/// </summary>
/// <param name="time">The time string.</param>
/// <param name="string">The time string.</param>
/// <param name="seconds">The seconds.</param>
/// <returns>Whether the string was parsed successfully.</returns>
public bool TryParseTime(string str, out int seconds)