From a5889fd9662660e02ab5213feee20077af32bbec Mon Sep 17 00:00:00 2001
From: Gabriel Arriagada <65878291+GNosii@users.noreply.github.com>
Date: Mon, 14 Nov 2022 15:27:53 -0400
Subject: [PATCH] Improve javadocs with <group> tags. (#6304)

* Group packages in Javadocs

Allows for easier navigation of Javadocs
Tested-by: Gabriel Arriagada <65878291+gnosii@users.noreply.github.com>

* Replace plain link with "a" tag
Allows for interaction with the link.

Tested-by: Gabriel Arriagada <65878291+gnosii@users.noreply.github.com>

* Go back in time

Goes back to hard-coded Java 16 as requested by LlmDl
---
 pom.xml                                     | 35 +++++++++++++++++++++
 src/com/palmergames/bukkit/towny/Towny.java |  5 +--
 2 files changed, 36 insertions(+), 4 deletions(-)

diff --git a/pom.xml b/pom.xml
index 04440d21d5..50dcbbc933 100644
--- a/pom.xml
+++ b/pom.xml
@@ -259,6 +259,41 @@
                 <configuration>
                     <source>16</source>
                     <doclint>all,-missing</doclint>
+                    <doctitle>Towny - ${project.version}</doctitle>
+                    <groups>
+                        <group>
+                            <title>Events</title>
+                            <packages>com.palmergames.bukkit.towny.event*</packages>
+                        </group>
+                        <group>
+                            <title>Objects</title>
+                            <packages>com.palmergames.bukkit.towny.object*</packages>
+                        </group>
+                        <group>
+                            <title>Tasks</title>
+                            <packages>com.palmergames.bukkit.towny.regen*:com.palmergames.bukkit.towny.tasks</packages>
+                        </group>
+                        <group>
+                            <title>Plugin</title>
+                            <packages>com.palmergames.bukkit.towny.command*:com.palmergames.bukkit.towny.listeners*:com.palmergames.bukkit.towny:com.palmergames.bukkit.config*:com.palmergames.bukkit.towny.db*</packages>
+                        </group>
+                        <group>
+                            <title>Player</title>
+                            <packages>com.palmergames.bukkit.towny.confirmations:com.palmergames.bukkit.towny.invites:com.palmergames.bukkit.towny.conversation:com.palmergames.bukkit.towny.huds</packages>
+                        </group>
+                        <group>
+                            <title>Hooks</title>
+                            <packages>com.palmergames.bukkit.towny.permissions:com.palmergames.bukkit.towny.hooks:com.palmergames.bukkit.towny.chat*</packages>
+                        </group>
+                        <group>
+                            <title>Exceptions</title>
+                            <packages>com.palmergames.bukkit.towny.exceptions*:com.palmergames.bukkit.towny.invites.exceptions</packages>
+                        </group>
+                        <group>
+                            <title>Utilities</title>
+                            <packages>com.palmergames.annotations:com.palmergames.util:com.palmergames.bukkit.util:com.palmergames.bukkit.towny.utils</packages>
+                        </group>
+                    </groups>
                 </configuration>
             </plugin>
             <plugin>  <!-- Create sources.jar -->
diff --git a/src/com/palmergames/bukkit/towny/Towny.java b/src/com/palmergames/bukkit/towny/Towny.java
index e99bb4ecb1..f79ac69050 100644
--- a/src/com/palmergames/bukkit/towny/Towny.java
+++ b/src/com/palmergames/bukkit/towny/Towny.java
@@ -94,10 +94,7 @@
 import java.util.logging.Level;
 
 /**
- * Towny Plugin for Bukkit
- * 
- * Website &amp; Source: https://github.com/TownyAdvanced/Towny
- * 
+ * Main class for <a href="https://github.com/TownyAdvanced/Towny">Towny</a>
  * @author Shade, ElgarL, LlmDl
  */
 public class Towny extends JavaPlugin {