Refactored build.xml then split javadoc target in two.

One target now reflects the general usage api.
The other target shows all members, including protected and private.

Author: jody

README.md

@@ -50,7 +50,7 @@ MyAppName/
 └── build.xml           # The Ant build script
 ```
 ## Usage Commands
-Open your terminal in the project root and use the following targets:
+Open a terminal in the project root and use the following targets:
 
 | Command |	Description |
 |-----|-----|
@@ -89,10 +89,10 @@ Every time you push code to the main branch or open a Pull Request:
 - The installers are saved as Artifacts in the GitHub Actions run summary for 90 days.
 ### The Release Phase (Continuous Deployment)
 A formal GitHub Release is only triggered when you push a version tag.
-This creates a permanent download page for your users.
+This creates a permanent download page for users.
 
 #### How to trigger a new release:
-To release a new version (e.g., version 1.0.1), run the following commands in your terminal:
+To release a new version (e.g., version 1.0.1), run the following commands in a terminal:
 
 ```Bash
 # 1. Tag the current commit

build.xml

@@ -21,6 +21,31 @@
     </not>
   </condition>
 
+  <macrodef name="generate-javadoc">
+    <attribute name="access-level" default="protected"/>
+    <attribute name="output-subdir"/>
+    <sequential>
+      <mkdir dir="${docs.dir}/@{output-subdir}"/>
+      <javadoc destdir="${docs.dir}/@{output-subdir}"
+               source="1.8"
+               encoding="UTF-8"
+               use="true"
+               author="true"
+               version="true"
+               failonerror="true"
+               access="@{access-level}">
+        <fileset dir="${src.dir}" includes="**/*.java"/>
+        <link href="${javadoc.api.url}"/>
+        <!-- Uncomment to resolve references in Javadoc comments to lib/ jars. -->
+        <!--
+            <classpath>
+            <pathelement path="${build.dir}"/>
+            <fileset dir="lib" includes="**/*.jar" erroronmissingdir="false"/>
+            </classpath>
+        -->
+        </javadoc>
+    </sequential>
+  </macrodef>
 
   <condition property="isMac">
     <os family="mac"/>
@@ -85,28 +110,16 @@
     <java jar="${jar.dir}/${app.name}.jar" fork="true"/>
   </target>
 
-  <target name="javadoc" depends="preflight" description="Generate Javadoc (works for unnamed or named packages)">
-    <mkdir dir="${docs.dir}"/>
-    <javadoc destdir="${docs.dir}"
-             source="1.8"
-             encoding="UTF-8"
-             use="true"
-             author="true"
-             version="true"
-             failonerror="true">
-      <fileset dir="${src.dir}" includes="**/*.java"/>
-
-      <link href="${javadoc.api.url}"/>
-      <!-- Uncomment to resolve references in Javadoc comments. -->
-      <!--
-          <classpath>
-          <pathelement path="${build.dir}"/>
-          <fileset dir="lib" includes="**/*.jar"/>
-          </classpath>
-      -->
-    </javadoc>
+  <target name="javadoc" depends="preflight" description="Generate standard API documentation">
+    <generate-javadoc access-level="protected" output-subdir="api"/>
   </target>
 
+  <target name="javadoc-internal" depends="preflight" description="Generate internal documentation (includes private members)">
+    <generate-javadoc access-level="private" output-subdir="internal"/>
+  </target>
+
+  <target name="javadoc-all" depends="javadoc, javadoc-internal" description="Generate both standard and internal documentation sets"/>
+
   <target name="package" description="Build the native installer for the current OS (DMG, DEB, or MSI)">
     <antcall target="dmg"/>
     <antcall target="debian"/>