doc: 完善javadoc

Signed-off-by: 502647092 <admin@yumc.pw>

src/main/java/pw/yumc/YumCore/bukkit/Log.java

@@ -55,18 +55,20 @@ public class Log {
      * @param message
      *            Message to be displayed
      */
-    public static void console(final String msg) {
+    public static void console(final String message) {
-        console.sendMessage(prefix + msg);
+        console.sendMessage(prefix + message);
     }
 
     /**
      * Sends console a message
      *
      * @param message
-     *            Message to be displayed
+     *            消息
+     * @param object
+     *            格式化参数
      */
-    public static void console(final String msg, final Object... object) {
+    public static void console(final String message, final Object... object) {
-        console.sendMessage(prefix + String.format(msg, object));
+        console.sendMessage(prefix + String.format(message, object));
     }
 
     /**
@@ -112,6 +114,8 @@ public class Log {
      *
      * @param msg
      *            消息
+     * @param e
+     *            异常
      */
     public static void debug(final String msg, final Throwable e) {
         if (debug) {

src/main/java/pw/yumc/YumCore/bukkit/P.java

@@ -8,6 +8,8 @@ import org.bukkit.command.PluginCommand;
 import org.bukkit.plugin.PluginDescriptionFile;
 import org.bukkit.plugin.java.JavaPlugin;
 
+import pw.yumc.YumCore.config.FileConfig;
+
 /**
  * 插件Instance获取类
  *
@@ -42,6 +44,8 @@ public class P {
     }
 
     /**
+     * @param FC
+     *            {@link FileConfig}
      * @return 获得插件配置文件
      */
     @SuppressWarnings("unchecked")
@@ -78,6 +82,8 @@ public class P {
     }
 
     /**
+     * @param PI
+     *            插件主类
      * @return 获得插件
      */
     @SuppressWarnings("unchecked")

src/main/java/pw/yumc/YumCore/bukkit/compatible/C.java

@@ -302,6 +302,12 @@ public class C {
          *            标题
          * @param subtitle
          *            子标题
+         * @param fadeInTime
+         *            淡入时间
+         * @param stayTime
+         *            持续时间
+         * @param fadeOutTime
+         *            淡出时间
          */
         public static void broadcast(final String title, final String subtitle, final int fadeInTime, final int stayTime, final int fadeOutTime) {
             for (final org.bukkit.entity.Player player : Player.getOnlinePlayers()) {

src/main/java/pw/yumc/YumCore/commands/CommandHelp.java

@@ -114,8 +114,14 @@ public class CommandHelp {
     /**
      * 发送帮助
      *
-     * @param ca
+     * @param sender
-     *            命令参数
+     *            命令发送者
+     * @param command
+     *            命令
+     * @param label
+     *            标签
+     * @param args
+     *            参数
      */
     public void send(final CommandSender sender, final Command command, final String label, final String[] args) {
         if (this.HELPPAGECOUNT == 0) {
@@ -158,7 +164,7 @@ public class CommandHelp {
 
     /**
      * 设置解析器
-     * 
+     *
      * @param helpParse
      *            帮助解析器
      */

src/main/java/pw/yumc/YumCore/commands/CommandManager.java

@@ -130,7 +130,7 @@ public class CommandManager implements TabExecutor {
     /**
      * 通过注解读取命令并注册
      *
-     * @param clazz
+     * @param clazzs
      *            子命令处理类
      */
     public void register(final CommandExecutor... clazzs) {

src/main/java/pw/yumc/YumCore/config/AbstractInjectConfig.java

@@ -11,6 +11,7 @@ import org.bukkit.configuration.ConfigurationSection;
 import pw.yumc.YumCore.bukkit.Log;
 
 /**
+ * 抽象注入配置
  *
  * @since 2016年7月5日 上午10:11:22
  * @author 喵♂呜
@@ -26,6 +27,9 @@ public abstract class AbstractInjectConfig {
 
     /**
      * 注入配置数据
+     *
+     * @param config
+     *            配置区
      */
     public void inject(final ConfigurationSection config) {
         if (config == null) {
@@ -49,7 +53,7 @@ public abstract class AbstractInjectConfig {
 
     /**
      * 转换字段值类型
-     * 
+     *
      * @param type
      *            字段类型
      * @param path
@@ -138,9 +142,6 @@ public abstract class AbstractInjectConfig {
      *            配置路径
      * @param field
      *            字段
-     * @return 是否解析成功
-     * @throws IllegalArgumentException
-     * @throws IllegalAccessException
      */
     protected void setField(final String path, final Field field) {
         Object value = config.get(path);

src/main/java/pw/yumc/YumCore/config/FileConfig.java

@@ -159,6 +159,8 @@ public class FileConfig extends AbstractConfig {
      *            路径
      * @param obj
      *            字符串
+     * @param allowrepeat
+     *            是否允许重复
      * @return {@link FileConfig}
      */
     public FileConfig addToStringList(final String path, final String obj, final boolean allowrepeat) {
@@ -214,7 +216,7 @@ public class FileConfig extends AbstractConfig {
     /**
      * 获得Location
      *
-     * @param key
+     * @param path
      *            键
      * @param def
      *            默认地点
@@ -297,8 +299,10 @@ public class FileConfig extends AbstractConfig {
     /**
      * 比较版本号
      *
-     * @param 新版本
+     * @param newver
-     * @param 旧版本
+     *            新版本
+     * @param oldver
+     *            旧版本
      * @return 是否需要更新
      */
     public boolean needUpdate(final String newver, final String oldver) {
@@ -428,6 +432,12 @@ public class FileConfig extends AbstractConfig {
         }
     }
 
+    /**
+     * 备份配置文件
+     *
+     * @param oldcfg
+     *            配置文件
+     */
     protected void backupConfig(final FileConfig oldcfg) {
         final String filename = oldcfg.getConfigName();
         try {
@@ -510,6 +520,8 @@ public class FileConfig extends AbstractConfig {
      *
      * @param file
      *            配置文件
+     * @param check
+     *            是否检查文件
      * @return FileConfig
      */
     protected FileConfig init(final File file, final boolean check) {
@@ -573,7 +585,6 @@ public class FileConfig extends AbstractConfig {
      *            新配置文件
      * @param oldcfg
      *            旧配置文件
-     *
      * @return 更新以后的配置文件
      */
     protected FileConfig updateConfig(final FileConfig newCfg, final FileConfig oldCfg) {

src/main/java/pw/yumc/YumCore/config/InjectConfigurationSection.java

@@ -16,6 +16,9 @@ public abstract class InjectConfigurationSection extends AbstractInjectConfig {
 
     /**
      * 重载配置文件
+     *
+     * @param config
+     *            配置区
      */
     public void reload(final ConfigurationSection config) {
         inject(config);

src/main/java/pw/yumc/YumCore/config/PlayerConfig.java

@@ -16,8 +16,8 @@ public class PlayerConfig extends FileConfig {
     /**
      * 获得玩家配置(保存在 指定 文件夹)
      *
-     * @param 指定目录
+     * @param dir
-     *            插件
+     *            指定目录
      * @param player
      *            玩家
      */
@@ -28,8 +28,8 @@ public class PlayerConfig extends FileConfig {
     /**
      * 获得玩家配置(保存在 CONFIG_FOLDER 文件夹)
      *
-     * @param playername
+     * @param player
-     *            玩家名称
+     *            玩家
      */
     public PlayerConfig(final Player player) {
         this(player.getName());
@@ -38,8 +38,8 @@ public class PlayerConfig extends FileConfig {
     /**
      * 获得玩家配置(保存在 CONFIG_FOLDER 文件夹)
      *
-     * @param player
+     * @param playername
-     *            玩家
+     *            玩家名称
      */
     public PlayerConfig(final String playername) {
         super(new File(plugin.getDataFolder(), CONFIG_FOLDER), playername + ".yml");

src/main/java/pw/yumc/YumCore/config/YumConfig.java

@@ -15,8 +15,8 @@ public class YumConfig {
     /**
      * 获得本地配置文件
      *
-     * @param url
+     * @param filename
-     *            配置文件地址
+     *            本地文件名称
      * @return {@link FileConfig}
      */
     public static FileConfig getLocal(final String filename) {
@@ -31,13 +31,14 @@ public class YumConfig {
      *            配置文件地址
      * @return {@link FileConfig}
      */
-    public static FileConfig getRemote(final String filename) {
+    public static FileConfig getRemote(final String url) {
         FileConfig config = null;
         try {
-            config = new RemoteConfig(REMOTEFILECENTER + filename);
+            config = new RemoteConfig(REMOTEFILECENTER + url);
         } catch (final IOException e) {
+            Log.debug(e);
         }
-        Log.info(String.format(config == null ? createError : fromYumc, filename));
+        Log.info(String.format(config == null ? createError : fromYumc, url));
         return config;
     }
 }

src/main/java/pw/yumc/YumCore/statistic/Statistics.java

@@ -106,9 +106,6 @@ public class Statistics {
 
     /**
      * 插件使用数据统计
-     *
-     * @throws IOException
-     *             IO异常
      */
     public Statistics() {
         try {

src/main/java/pw/yumc/YumCore/tellraw/MessagePart.java

@@ -45,7 +45,7 @@ public class MessagePart {
     }
 
     /**
-     * 是否有文本
+     * @return 是否有文本
      */
     public boolean hasText() {
         return text != null && !text.isEmpty();

src/main/java/pw/yumc/YumCore/tellraw/Tellraw.java

@@ -227,8 +227,8 @@ public class Tellraw {
     /**
      * 悬浮消息
      *
-     * @param text
+     * @param texts
-     *            文本
+     *            文本列
      * @return {@link Tellraw}
      */
     public Tellraw tip(final List<String> texts) {
@@ -256,8 +256,8 @@ public class Tellraw {
     /**
      * 悬浮消息
      *
-     * @param text
+     * @param texts
-     *            文本
+     *            文本列
      * @return {@link Tellraw}
      */
     public Tellraw tip(final String... texts) {

src/main/java/pw/yumc/YumCore/update/SubscribeTask.java

@@ -92,6 +92,9 @@ public class SubscribeTask implements Runnable {
 
     /**
      * 自动更新
+     *
+     * @param isMaven
+     *            是否为Maven
      */
     public SubscribeTask(final boolean isMaven) {
         this(false, isMaven);
@@ -99,6 +102,11 @@ public class SubscribeTask implements Runnable {
 
     /**
      * 自动更新
+     *
+     * @param isSecret
+     *            是否为私有
+     * @param isMaven
+     *            是否为Maven
      */
     public SubscribeTask(final boolean isSecret, final boolean isMaven) {
         this("master", isSecret, isMaven);
@@ -109,6 +117,10 @@ public class SubscribeTask implements Runnable {
      *
      * @param branch
      *            更新分支
+     * @param isSecret
+     *            是否为私有
+     * @param isMaven
+     *            是否为Maven
      */
     public SubscribeTask(final String branch, final boolean isSecret, final boolean isMaven) {
         this.branch = branch;
@@ -179,8 +191,10 @@ public class SubscribeTask implements Runnable {
     /**
      * 比较版本号
      *
-     * @param 新版本
+     * @param v1
-     * @param 旧版本
+     *            新版本
+     * @param v2
+     *            旧版本
      * @return 是否需要更新
      */
     public boolean needUpdate(final String v1, final String v2) {