Convert documentation to AsciiDoc

.github/workflows/maven.yml

@@ -83,7 +83,7 @@ jobs:
             aspectjtools/target/flattened-pom.xml
 
       - name: Create docs
-        run: ./mvnw -B --file pom.xml -DskipTests process-resources -pl docs -P create-docs
+        run: ./mvnw -B --file pom.xml -DskipTests package -pl docs -P create-docs
 
       - name: Attach docs to build
         uses: actions/upload-artifact@v3

.gitignore

@@ -35,12 +35,10 @@ bin/
 /lib/provisioned.marker
 /lib/ant/
 /lib/commons/
-/lib/docbook/
 /lib/jarjar/
 /lib/jdtcore-aj/
 /lib/junit/
 /lib/regexp/
-/lib/saxon/
 
 # AspectJ core dumps
 ajcore.*.txt

README.md

@@ -44,8 +44,8 @@ Ensure you run this with a JDK - the more recent the better since some tests wil
 * [Setting up a development environment](docs/developer/IDE.md)
 * [Getting started with AspectJ](https://www.eclipse.org/aspectj/doc/released/progguide/starting.html)
 * [Programming Guide](https://www.eclipse.org/aspectj/doc/released/progguide/index.html)
-* [READMEs for each version of AspectJ](docs/dist/doc)
-* [AspectJ Java version compatibility](docs/dist/doc/JavaVersionCompatibility.md)
+* [READMEs for each version of AspectJ](docs/release)
+* [AspectJ Java version compatibility](docs/release/JavaVersionCompatibility.adoc)
 
 ## Documentation for AspectJ developers
 
@@ -55,4 +55,4 @@ Ensure you run this with a JDK - the more recent the better since some tests wil
 
 ## Maven releases
 
-AspectJ is published to maven central under the `org.aspectj` groupID: https://search.maven.org/search?q=g:org.aspectj
+AspectJ is published to Maven Central under [group ID `org.aspectj`](https://search.maven.org/search?q=g:org.aspectj).

ajde/src/main/java/org/aspectj/ajde/ui/swing/ErrorDialog.java

@@ -51,7 +51,7 @@ public ErrorDialog(Frame owner, String title, Throwable throwable, String messag
             String exceptionName = "<unknown exception>";
             if (throwable != null) exceptionName = throwable.getClass().getName();
             this.error_label1.setText("Exception: " + exceptionName);
-            this.error_label2.setText("If you can't fix it, please submit a bug to http://dev.eclipse.org/bugs");
+            this.error_label2.setText("If you can't fix it, please submit a bug to https://dev.eclipse.org/bugs");
             this.stackTrace_textArea.setText("Message: " + message + '\n' + "Stack trace: " + details);
             this.setSize(420, 330);
             this.setLocationRelativeTo(owner);

ajde/src/main/java/org/aspectj/ajde/ui/swing/OptionsFrame.java

@@ -59,12 +59,12 @@ public class OptionsFrame extends JFrame {
         "conforming to the Open Source Definition.\n\n" +
         "For support or for more information about the AspectJ\n" +
         "project or the license, visit the project home page at\n" +
-        "    http://eclipse.org/aspectj\n\n" +
+        "    https://eclipse.org/aspectj\n\n" +
         "If you find a bug (not solved by the documentation in the\n" +
         "Development Environment Guide available with this release,\n" +
         "any release notes, or the bug database), please submit steps\n" +
         "to reproduce the bug (using the IDE component) at:\n" +
-        "    http://bugs.eclipse.org/bugs/enter_bug.cgi?product=AspectJ";
+        "    https://bugs.eclipse.org/bugs/enter_bug.cgi?product=AspectJ";
 
     private JTabbedPane main_tabbedPane = new JTabbedPane();
     private JPanel button_panel = new JPanel();

aspectjrt/pom.xml

@@ -205,6 +205,34 @@
 				</executions>
 			</plugin>
 
+			<plugin>
+				<groupId>org.apache.maven.plugins</groupId>
+				<artifactId>maven-resources-plugin</artifactId>
+				<executions>
+					<execution>
+						<id>copy-javadoc-to-dist</id>
+						<phase>package</phase>
+						<goals>
+							<goal>copy-resources</goal>
+						</goals>
+						<configuration>
+							<!--
+								Skip, if javadoc generation is also meant to be skipped, which is the default unless the 'release'
+								profile is active or the property is overridden manually to be false. See property definitions in parent
+								POM for default case and release profile.
+							-->
+							<skip>${maven.javadoc.skip}</skip>
+							<outputDirectory>${project.basedir}/../aj-build/dist/docs/doc/runtime-api</outputDirectory>
+							<resources>
+								<resource>
+									<directory>${project.build.directory}/apidocs</directory>
+								</resource>
+							</resources>
+						</configuration>
+					</execution>
+				</executions>
+			</plugin>
+
 			<!-- Caveat: Attaching the flattened POM needs packaging=jar, so do not use packaging=pom for this module -->
 			<plugin>
 				<groupId>org.codehaus.mojo</groupId>

aspectjweaver/pom.xml

@@ -286,6 +286,34 @@
 				</executions>
 			</plugin>
 
+			<plugin>
+				<groupId>org.apache.maven.plugins</groupId>
+				<artifactId>maven-resources-plugin</artifactId>
+				<executions>
+					<execution>
+						<id>copy-javadoc-to-dist</id>
+						<phase>package</phase>
+						<goals>
+							<goal>copy-resources</goal>
+						</goals>
+						<configuration>
+							<!--
+								Skip, if javadoc generation is also meant to be skipped, which is the default unless the 'release'
+								profile is active or the property is overridden manually to be false. See property definitions in parent
+								POM for default case and release profile.
+							-->
+							<skip>${maven.javadoc.skip}</skip>
+							<outputDirectory>${project.basedir}/../aj-build/dist/docs/doc/weaver-api</outputDirectory>
+							<resources>
+								<resource>
+									<directory>${project.build.directory}/apidocs</directory>
+								</resource>
+							</resources>
+						</configuration>
+					</execution>
+				</executions>
+			</plugin>
+
 			<!-- Caveat: Attaching the flattened POM needs packaging=jar, so do not use packaging=pom for this module -->
 			<plugin>
 				<groupId>org.codehaus.mojo</groupId>

build/products/aspectj/install/intro.html

@@ -6,12 +6,12 @@ <h2 align="center">Installer for AspectJ 9 Development Kit<sup><small>TM</small>
 <p align="center">Version ${build.version.long} built on ${build.date}</p>
 <p>This installs the complete AspectJ 9 Development Kit (AJDK) distribution, with
 the compiler, aspect libraries, structure browser, ant tasks,
-documentation, and examples.  
+documentation, and examples.
 This distribution is covered by the Eclipse Public License v 2.0 (see
 https://www.eclipse.org/org/documents/epl-2.0/EPL-2.0.txt).
 <p>
 For IDE integrations or source code, see the project home page at
-http://eclipse.org/aspectj</p>
+https://eclipse.org/aspectj</p>
 
 
 <p>${copyright.allRights.from1998}</p>

build/products/tools/install/intro.html

@@ -16,8 +16,8 @@ <h2 align="center">Installer for AspectJ(TM) Compiler and Core Tools</h2>
 <p>
 This is a binary only release of tools made available under
 the Eclipse Public License.
-For more information on the license or to download the source code, 
-see http://eclipse.org/aspectj</p>
+For more information on the license or to download the source code,
+see https://eclipse.org/aspectj</p>
 <p>${copyright.allRights.from1998}</p>
 <p></p>