]> source.dussan.org Git - aspectj.git/commitdiff
Remove obsolete DocBook build config in favour of Asciidoctor
authorAlexander Kriegisch <Alexander@Kriegisch.name>
Sat, 6 Jan 2024 06:19:49 +0000 (13:19 +0700)
committerAlexander Kriegisch <Alexander@Kriegisch.name>
Sat, 6 Jan 2024 09:09:11 +0000 (10:09 +0100)
Along with the Ant and Maven build configs, downloads of
 - DocBook DTD,
 - DocBook XSL,
 - FOP,
 - Batik,
 - Saxon
also become obsolete.

Signed-off-by: Alexander Kriegisch <Alexander@Kriegisch.name>
.gitignore
docs/build.xml [deleted file]
docs/pom.xml
docs/readme-docs-module.adoc
docs/src/main/resources/local.properties [deleted file]
lib/pom.xml
lib/readme-lib-module.html

index a55fb960167e3eabd7df471bade804b8dc07f4f5..043448a8578f0e457ebe9030cd98dbb9f5b0a8bf 100644 (file)
@@ -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
diff --git a/docs/build.xml b/docs/build.xml
deleted file mode 100644 (file)
index e0083ec..0000000
+++ /dev/null
@@ -1,517 +0,0 @@
-<!-- -*- Mode: SGML; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- -->
-<!-- ========================================================================= -->
-<!-- Copyright (c) 2002 Palo Alto Research Center, Incorporated (PARC),        -->
-<!--               2004-2005 Contributors.                                     -->
-<!-- All rights reserved.                                                      -->
-<!-- This program and the accompanying materials are made available            -->
-<!-- under the terms of the Eclipse Public License v 2.0                       -->
-<!-- which accompanies this distribution and is available at                   -->
-<!-- https://www.eclipse.org/org/documents/epl-2.0/EPL-2.0.txt                 -->
-<!--                                                                           -->
-<!-- Contributors:                                                             -->
-<!--     Xerox/PARC     initial implementation                                 -->
-<!-- ========================================================================= -->
-
-<project name="docs" default="dist" basedir=".">
-
-    <property name="project.name" value="build-docs" />
-
-    <target name="product" depends="local-dist" />
-    <target name="clean"
-            depends="clean-doc-directories"
-    />
-
-    <!-- ===================================================================== -->
-    <!-- Init                                                                  -->
-    <!-- ===================================================================== -->
-
-    <import file="${basedir}/../build/build-properties.xml"/>
-
-    <target name="init" depends="init-properties,init-directories">
-
-        <property name="docs.src.pattern"
-                  value="**/*.xml,**/*.html,**/*.doc,**/*.gif,**/*.java,**/*.lst,**/*.pdf"
-        />
-        <property name="docs.src.dir"
-                  location="${aspectj.modules.docs.dir}"
-        />
-
-        <property name="docs.dist.dir"
-                  location="${aj.dist.dir}/docs"
-        />
-        <property name="docs.temp.dir"
-                  location="${aj.temp.dir}/doc"
-        />
-        <property name="web.doc.dir"
-                  location="${aj.webDeploy.dir}/documentation/dist"
-        />
-
-        <property name="docs.product.name"
-                  value="aspectj-docs-${build.version}"
-        />
-
-        <property name="docs.product.zip"
-                  location="${aj.dist.dir}/${docs.product.name}.zip"
-        />
-        <!-- must specify (not *.gif) to not delete other gifs during build-in-place -->
-        <!-- to find refs: gp ax imagedata | sed -n 's|.*\=\"\(..*\)\".*|\1|p' -->
-        <property name="devguide.icons.dir"
-                  location="${aspectj.modules.dir}/ajde/src/main/resources/org/aspectj/ajde/resources/actions"
-        />
-        <property name="include.devguide.icons"
-                  value="build.png,openConfig.png,browseroptions.png"
-        />
-
-        <!-- callers of xml-html use these by default -->
-        <property name="chunk.xsl.source"
-                  location="${aspectj.modules.lib.dir}/docbook/docbook-xsl/html/chunk.xsl"
-        />
-        <property name="nochunk.xsl.source"
-                  location="${aspectj.modules.lib.dir}/docbook/docbook-xsl/html/docbook.xsl"
-        />
-        <!-- default xml-html nochunking file (0-length dummy created when chunking) -->
-        <property name="xml-target-file"
-                  location="${docs.temp.dir}/xml-target-file.dummy"
-        />
-        <!-- default value for xml-html copying (copy all graphics) -->
-        <property name="xml-html-copy" value="*.gif,*.png" />
-        <property name="xml-html-stylesheet" value="aspectj-docs.css" />
-        <property name="binary.pattern"
-                  value="**/*.gif,**/*.png,**/*.doc,**/*.pdf,**/*.jpg,**/*.JPG,**/*.css"
-        />
-        <uptodate property="local.dist.uptodate"
-                  targetfile="${docs.dist.dir}/doc/faq.html"
-        >
-            <!-- use faq as tag file -->
-            <srcfiles dir="${docs.src.dir}"
-                      includes="${docs.src.pattern}"
-            />
-        </uptodate>
-        <uptodate property="dist.uptodate"
-                  targetfile="${docs.product.zip}"
-        >
-            <!-- use zip as tag file -->
-            <srcfiles dir="${docs.src.dir}"
-                      includes="${docs.src.pattern}"
-            />
-            <srcfiles dir="${docs.dist.dir}"
-                      includes="${docs.src.pattern}"
-            />
-        </uptodate>
-
-    </target>
-
-    <target name="clean-doc-directories"
-            depends="init"
-            description="clean build dirs (including local deploy dir)"
-    >
-        <delete quiet="on">
-            <fileset dir="${docs.dist.dir}" />
-            <fileset dir="${docs.jar.dir}" />
-            <fileset dir="${docs.temp.dir}" />
-        </delete>
-    </target>
-
-    <target name="dist"
-            depends="init,local-dist"
-            description="create unused doc zip - see ../build/build.xml for installer"
-            unless="dist.uptodate"
-    >
-        <delete file="${docs.product.zip}" />
-        <zip zipfile="${docs.product.zip}"
-             basedir="${docs.dist.dir}"
-        />
-
-        <echo message="find doc zip in ${docs.product.zip}" />
-    </target>
-
-    <target name="web.deploy.faqonly"
-            depends="init,faq"
-            description="deploy docs.dist.dir faq to web.doc.dir"
-    >
-        <copy todir="${web.doc.dir}" filtering="on">
-            <fileset dir="${docs.dist.dir}/doc" includes="faq.html" />
-        </copy>
-        <stripnonbodyhtml srcdir="${web.doc.dir}"
-                          includes="faq.html"
-        />
-        <echo message="do link check on index and faq before release"
-        />
-    </target>
-
-    <target name="web.deploy.faqindex"
-            depends="init,dist"
-            description="deploy built faq and index to web.doc.dir"
-    >
-        <copy todir="${web.doc.dir}" filtering="on">
-            <fileset dir="${docs.dist.dir}/doc"
-                     includes="faq.html,index.html"
-            />
-        </copy>
-        <stripnonbodyhtml srcdir="${web.doc.dir}"
-                          includes="faq.html,index.html"
-        />
-        <echo message="do link check on index and faq before release"
-        />
-    </target>
-
-    <target name="web.deploy" depends="web.deploy.README-1.1" />
-
-    <target name="web.deploy.README-1.1"
-            depends="init"
-            description="deploy README-1.1.html to the web site"
-    >
-        <property name="readme11.dir"
-                  location="${web.doc.dir}/documentation/readme11"
-        />
-        <mkdir dir="${readme11.dir}" />
-        <delete file="${readme11.dir}/index.html" />
-        <mkdir dir="${readme11.dir}" />
-        <copy tofile="${readme11.dir}/index.html"
-              file="${aspectj.products.dir}/tools/dist/README-1.1.html"
-              filtering="on"
-        />
-        <stripnonbodyhtml srcdir="${readme11.dir}"
-                          includes="index.html"
-        />
-    </target>
-
-    <target name="web.deploy.old"
-            depends="init"
-            description="deploy built docs to the web site"
-    >
-        <mkdir dir="${web.doc.dir}" />
-        <delete dir="${web.doc.dir}" />
-        <mkdir dir="${web.doc.dir}" />
-        <copy todir="${web.doc.dir}">
-            <fileset dir="${docs.dist.dir}/doc" />
-        </copy>
-        <stripnonbodyhtml srcdir="${web.doc.dir}"
-                          includes="**/*.html"
-        />
-    </target>
-
-    <!-- ============================================================ -->
-    <!-- build all doc products                                       -->
-    <!-- ============================================================ -->
-    <target name="local-dist"
-            depends="init"
-            unless="local.dist.uptodate"
-            description="avoid local-dist antecedants if uptodate"
-    >
-        <antcall target="do-local-dist" />
-    </target>
-
-    <target name="do-local-dist"
-            depends="init,init-filters,faq,devguide,progguide, adk15guide, pdguide"
-            description="finish products by copying dist files and library sources"
-    >
-<!--
-            depends="init,init-filters,api,faq,devguide,progguide, adk15guide, pdguide"
--->
-
-        <copy todir="${docs.dist.dir}" filtering="on">
-            <fileset dir="${docs.src.dir}/dist"
-                     excludes="${binary.pattern}"
-            />
-        </copy>
-        <copy todir="${docs.dist.dir}" filtering="off">
-            <fileset dir="${docs.src.dir}/dist"
-                     includes="${binary.pattern}"
-            />
-        </copy>
-        <available file="${docs.src.dir}/../org.aspectj.lib/build-aspectjlib.xml"
-                   property="org.aspectj.lib.available"
-        />
-        <!--fail unless="org.aspectj.lib.available"
-              message="unable to find org.aspectj.lib"
-        />
-        <mkdir dir="${docs.dist.dir}/doc/aspectjlib" />
-        <copy todir="${docs.dist.dir}/doc/aspectjlib" filtering="off">
-            <fileset dir="${docs.src.dir}/../org.aspectj.lib"
-                     includes="build-aspectjlib.xml,src/**"
-                       excludes="CVS"
-                  />
-        </copy>
-        -->
-    </target>
-
-    <target name="api"
-            depends="init"
-            description="javadoc for AspectJ runtime and weaver"
-    >
-        <property file="${docs.src.dir}/docs.build.properties" />
-        <delete quiet="on">
-            <fileset dir="${docs.dist.dir}/doc" includes="*api/*" />
-        </delete>
-        <aspectj-javadoc module="runtime" />
-        <aspectj-javadoc module="aspectj5rt"/>
-        <aspectj-javadoc module="weaver" />
-    </target>
-
-    <macrodef name="aspectj-javadoc">
-        <attribute name="module" />
-        <sequential>
-            <mkdir dir="${docs.dist.dir}/doc/@{module}-api" />
-            <javadoc sourcepath="${@{module}.sourcepath}"
-                     destdir="${docs.dist.dir}/doc/@{module}-api"
-                     windowtitle="AspectJ(tm) @{module} API"
-                     classpath="${@{module}.classpath}"
-                     packagenames="${@{module}.packagenames}"
-            >
-                <link offline="true"
-                      href="http://java.sun.com/j2se/1.5/docs/api"
-                      packagelistLoc="${docs.src.dir}/jdk15-packages.txt"
-                />
-            </javadoc>
-        </sequential>
-    </macrodef>
-
-    <target name="faq" depends="init">
-        <antcall target="xml-html">
-            <param name="xml-source-dir"
-                   value="${docs.src.dir}/faq"
-            />
-            <param name="xml-source-root" value="faq.xml" />
-            <param name="xsl-source-file"
-                   value="${nochunk.xsl.source}"
-            />
-            <param name="xml-target-dir" value="${docs.dist.dir}" />
-            <param name="xml-target-file"
-                   value="${docs.dist.dir}/doc/faq.html"
-            />
-            <param name="xml-html-stylesheet" value="aspectj-faq.css" />
-        </antcall>
-    </target>
-
-    <target name="progguide" depends="init">
-        <antcall target="build-guide">
-            <param name="guide.dir" value="progguide" />
-            <param name="guide.name" value="progguide" />
-            <param name="xml-html-copy"
-                           value="dd_arrow.png,aspects.png,figureUML.png,overview.png,telecom.png,aspectj-docs.css"/>
-        </antcall>
-    </target>
-
-    <target name="adk15guide" depends="init">
-        <antcall target="build-guide">
-            <param name="guide.dir" value="adk15notebook" />
-            <param name="guide.name" value="adk15notebook" />
-            <param name="xml-html-copy"
-                   value="dd_arrow.png,aspectj-docs.css"/>
-        </antcall>
-    </target>
-
-
-    <target name="devguide" depends="init">
-
-        <copy todir="${docs.src.dir}/devguide" filtering="off">
-            <fileset dir="${devguide.icons.dir}"
-                     includes="${include.devguide.icons}"
-            />
-        </copy>
-
-        <antcall target="build-guide">
-            <param name="xml-html-copy"
-                   value="dd_arrow.png,aspectj-docs.css,ajbrowser-building.png,ajbrowser-options.png,${include.devguide.icons}"
-            />
-            <param name="guide.dir" value="devguide" />
-            <param name="guide.name" value="devguide" />
-        </antcall>
-        <delete quiet="on">
-            <fileset dir="${docs.src.dir}/devguide"
-                     includes="${include.devguide.icons}"
-            />
-        </delete>
-    </target>
-
-    <target name="pdguide" depends="init">
-
-        <copy todir="${docs.src.dir}/pdguide" filtering="off">
-            <fileset dir="${devguide.icons.dir}"
-                     includes="${include.pdguide.icons}"
-            />
-        </copy>
-
-        <antcall target="build-guide">
-            <param name="xml-html-copy"
-                   value="dd_arrow.png,aspectj-docs.css,ajbrowser-building.png,ajbrowser-options.png,${include.pdguide.icons}"
-            />
-            <param name="guide.dir" value="pdguide" />
-            <param name="guide.name" value="pdguide" />
-        </antcall>
-        <delete quiet="on">
-            <fileset dir="${docs.src.dir}/pdguide"
-                     includes="${include.pdguide.icons}"
-            />
-        </delete>
-    </target>
-
-    <target name="build-guide"
-            depends="init"
-            description="build prog or dev guide, using guide.dir and guide.name"
-    >
-        <!-- chunked -->
-        <antcall target="xml-html">
-            <param name="xml-source-dir"
-                   value="${docs.src.dir}/${guide.dir}"
-            />
-            <param name="xml-source-root" value="${guide.name}.xml" />
-            <param name="xsl-source-file"
-                   value="${chunk.xsl.source}"
-            />
-            <param name="xml-target-dir"
-                   value="${docs.dist.dir}/doc/${guide.name}"
-            />
-        </antcall>
-        <!-- single -->
-        <antcall target="xml-html">
-            <param name="xml-source-dir"
-                   value="${docs.src.dir}/${guide.dir}"
-            />
-            <param name="xml-source-root" value="${guide.name}.xml" />
-            <param name="xsl-source-file"
-                   value="${nochunk.xsl.source}"
-            />
-            <param name="xml-target-dir"
-                   value="${docs.dist.dir}/doc/${guide.name}"
-            />
-            <param name="xml-target-file"
-                   value="${docs.dist.dir}/doc/${guide.name}/printable.html"
-            />
-        </antcall>
-        <!-- pdf TODO pdf rendering completes, result is awful
-               <antcall target="xml-pdf">
-                       <param name="xml-source-dir"
-                  value="${docs.src.dir}/${guide.dir}"/>
-                       <param name="xml-source-root" value="${guide.name}.xml"/>
-                       <param name="pdf-target-file"
-                  value="${docs.dist.dir}/doc/${guide.name}.pdf"/>
-               </antcall>
-               -->
-
-    </target>
-
-    <target name="test-pdf"
-            depends="init"
-            description="test pdf build of [prog|dev|adk]guide"
-    >
-        <!-- NPE in fop task when building programming guide.
-        see patch at https://bugs.eclipse.org/bugs/show_bug.cgi?id=81654
-        <antcall target="build-pdf">
-            <param name="guide.dir" value="progguide" />
-            <param name="guide.name" value="progguide" />
-        </antcall>
-               -->
-        <antcall target="build-pdf">
-            <param name="guide.dir" value="adk15notebook" />
-            <param name="guide.name" value="adk15notebook" />
-        </antcall>
-        <copy todir="${docs.src.dir}/devguide" filtering="off">
-            <fileset dir="${devguide.icons.dir}"
-                     includes="${include.devguide.icons}"
-            />
-        </copy>
-
-        <antcall target="build-pdf">
-            <param name="xml-html-copy"
-                   value="ajbrowser-building.png,ajbrowser-options.png,${include.devguide.icons}"
-            />
-            <param name="guide.dir" value="devguide" />
-            <param name="guide.name" value="devguide" />
-        </antcall>
-    </target>
-
-    <target name="build-pdf"
-            depends="init"
-            description="build prog or dev guide, using guide.dir and guide.name"
-    >
-        <antcall target="xml-pdf">
-            <param name="xml-source-dir"
-                   value="${docs.src.dir}/${guide.dir}"
-            />
-            <param name="xml-source-root" value="${guide.name}.xml" />
-            <param name="pdf-target-file"
-                   value="${docs.dist.dir}/doc/${guide.name}.pdf"
-            />
-        </antcall>
-    </target>
-
-    <!-- XML conversion stuff -->
-
-    <!-- xml-pdf -->
-    <target name="xml-pdf">
-        <delete file="${pdf-target-file}" />
-        <touch file="${pdf-target-file}" />
-        <delete file="${xml-source-dir}/index.fo" />
-
-        <!-- produce index.fo from docbook sources -->
-        <java classname="com.icl.saxon.StyleSheet" fork="yes">
-            <classpath>
-                <pathelement location="${aspectj.modules.lib.dir}/saxon/saxon.jar"
-                />
-            </classpath>
-            <arg value="-o" />
-            <arg value="${xml-source-dir}/index.fo" />
-            <arg value="${xml-source-dir}/${xml-source-root}" />
-            <arg value="${aspectj.modules.lib.dir}/docbook/docbook-xsl/fo/docbook.xsl"
-            />
-        </java>
-
-        <!-- index.fo to pdf (TODO if formatting fixed, to init-taskdefs) -->
-        <taskdef name="fop"
-                 classname="org.apache.fop.tools.anttasks.Fop"
-        >
-            <classpath>
-                <fileset dir="${aspectj.modules.lib.dir}/docbook">
-                    <include name="fop.jar" />
-                    <include name="batik.jar" />
-                </fileset>
-            </classpath>
-        </taskdef>
-        <!-- TODO messagelevel="info" -->
-        <fop format="application/pdf"
-             messagelevel="verbose"
-             basedir="${guide.dir}"
-             fofile="${guide.dir}/index.fo"
-             outfile="${pdf-target-file}"
-        >
-        </fop>
-        <delete quiet="on" file="${guide.dir}/index.fo" />
-    </target>
-
-    <target name="xml-html"
-            description="antcall(xml-source-dir, xml-source-root, xml-target-dir, xml-target-file)
-     convert xml to html using docbook. parameters:
-     xml-source-dir  # base directory of source
-     xml-source-root # base file of source (relative to xml-source-dir)
-     xsl-source-file # xsl transform to apply (use chunk.xsl.source by default)
-     xml-target-dir  # target directory for output (used as xsl param base.dir)
-     xml-target-file # full path to output file in xml-source-dir, ignored when chunking
-     xml-html-copy   # copy files to target (defaults to *.gif,*.png)
-     xml-html-stylesheet   # style sheet to use (defaults to ${xml-html-stylesheet})"
-    >
-
-        <mkdir dir="${xml-target-dir}" />
-        <copy todir="${xml-target-dir}">
-            <fileset dir="${xml-source-dir}"
-                     includes="${xml-html-copy}"
-            />
-        </copy>
-        <java classname="com.icl.saxon.StyleSheet"
-              classpath="${aspectj.modules.lib.dir}/saxon/saxon.jar"
-              fork="yes"
-              failonerror="yes"
-        >
-            <!-- todo: establish failure policy -->
-            <arg value="-o" />
-            <arg value="${xml-target-file}" />
-            <arg value="${xml-source-dir}/${xml-source-root}" />
-            <arg value="${xsl-source-file}" />
-            <arg value="base.dir=${xml-target-dir}/" />
-            <arg value="use.id.as.filename=1" />
-            <arg value="html.stylesheet=${xml-html-stylesheet}" />
-        </java>
-    </target>
-
-</project>
index c7cea87e5dd202eee4dc3b0f9d14357c13577251..1f76f17c652f0e6e0c6294f3c64718c688d69256 100644 (file)
         </plugins>
       </build>
     </profile>
-    <profile>
-      <id>create-docs-LEGACY</id>
-      <activation>
-        <property>
-          <name>createDocs_LEGACY</name>
-          <value>true</value>
-        </property>
-      </activation>
-
-      <build>
-        <resources>
-          <resource>
-            <directory>src/main/resources</directory>
-            <filtering>true</filtering>
-            <includes>
-              <include>**/local.properties</include>
-            </includes>
-          </resource>
-        </resources>
-
-        <pluginManagement>
-          <plugins>
-            <!--This plugin's configuration is used to store Eclipse m2e settings only. It has no influence on the Maven build itself.-->
-            <plugin>
-              <groupId>org.eclipse.m2e</groupId>
-              <artifactId>lifecycle-mapping</artifactId>
-              <version>1.0.0</version>
-              <configuration>
-                <lifecycleMappingMetadata>
-                  <pluginExecutions>
-                    <pluginExecution>
-                      <pluginExecutionFilter>
-                        <groupId>org.apache.maven.plugins</groupId>
-                        <artifactId>maven-antrun-plugin</artifactId>
-                        <versionRange>[1.7,)</versionRange>
-                        <goals>
-                          <goal>run</goal>
-                        </goals>
-                      </pluginExecutionFilter>
-                      <action>
-                        <ignore></ignore>
-                      </action>
-                    </pluginExecution>
-                  </pluginExecutions>
-                </lifecycleMappingMetadata>
-              </configuration>
-            </plugin>
-          </plugins>
-        </pluginManagement>
-
-        <plugins>
-          <plugin>
-            <artifactId>maven-antrun-plugin</artifactId>
-            <version>3.0.0</version>
-            <executions>
-              <execution>
-                <id>make-docs</id>
-                <phase>process-resources</phase>
-                <configuration>
-                  <target>
-                    <copy
-                      file="${project.build.outputDirectory}/local.properties"
-                      toFile="../build/local.properties"
-                      overwrite="true"
-                    />
-                    <ant antfile="build.xml">
-                      <target name="dist"/>
-                    </ant>
-                  </target>
-                </configuration>
-                <goals>
-                  <goal>run</goal>
-                </goals>
-              </execution>
-            </executions>
-          </plugin>
-        </plugins>
-
-      </build>
-
-      <dependencies>
-        <dependency>
-          <!-- All modules referencing files inside 'lib' need this dependency -->
-          <groupId>org.aspectj</groupId>
-          <artifactId>lib</artifactId>
-        </dependency>
-      </dependencies>
-
-    </profile>
   </profiles>
 
 </project>
index 523912921a05087d920f2dfa38747dcee54a6d72..d7d236749a875382111d00de4251c75950a6f4df 100644 (file)
@@ -17,101 +17,3 @@ works:
   guides `quickref/quick.pdf` and `quickref/quickA4.pdf`.
 * `build.xml`: Ant build script for the doc distribution
 * `developer`: Docs for AspectJ developers
-
-*Build*: `build.xml` assembles a local distribution which is gathered
-into the product distribution by the master build script,
-`../build/build.xml`. Dependencies outside this directory:
-
-* `.xml` files refer to their docbook dtds using relative path, for the
-  moment `../../lib/docbook/...`
-* When building docbook, uses `../lib/saxon` libraries.
-* When building installer, using `../lib/build/build.jar` and the
-  `../build/installer-resources`.
-* `quickref/quick.pdf` is generated manually from `quickref/quick.doc`.
-* `../org.aspectj.lib` provides library sources for
-  `{AspectJ}/doc/aspectjlib`.
-
-When editing the build script and XML files, try to make only
-substantive changes rather than reformatting, which produces illusory
-changes. If you do reformat, do so programmatically (e.g., using
-XMLBuddy plugin reformat command, with long lines wrapped and 80
-character lines).
-
-== Docbook notes
-
-#*TODO:* Remove this section after AsciiDoc conversion is complete#
-
-Documentation is written in docbook XML form, which is transformed to
-HTML (single-page and multi-page forms) and, potentially, PDF.
-Unfortunately, this means you need to use the tags which are not only
-legal, but which work when transformed into all output formats, even if
-it means working around bugs in the transform scripts. Following are
-some notes on traps to avoid.
-
-=== Authoring support
-
-XMLBuddy has a free eclipse plugin that displays errors using problem
-items and gutter annotations, but it gets confused by entity references.
-So for devguide.xml, create a new file foo.xml and do a manual merge,
-correct the files, and then scatter again (leo?).
-
-=== PDF transformation
-
-The transformation from docbook XML to formatting-objects (.fo)
-to pdf is fairly weak. If you run the build.xml `test-pdf` task,
-you'll see a number of debug messages, which unfortunately give no
-clue as to the location of the problem.  Problems noted in the output
-(where DE == docbook element)
-
-* tables broken.
-** DE `table` unsupported
-** DE `informaltable` autolayout is not supported
-* lineation/justification broken
-* need things like page header/footer titles, page number, copyright
-* Valid docbook elements not supported:
-** superscript in title
-* ...
-
-Sample debug messages:
-
-- `area contents overflows area in line`
-- `table-layout=auto is not supported, using fixed!`
-- `The element 'fo:table-and-caption' is not yet implemented.`
-   (So use docbook element (DE) `informaltable`, not DE `table`.)
-- `No spaces to justify text in line` many times
-
-== Older notes
-
-=== Misc info for writing and building docbook
-
-* link tag linkend attribute takes an id
-** xsl converts as needed during output
-** do NOT use `ulink`; this will be converted to `""`
-   (but see param `citerefentry-link`: might enable this)
-
-* to use sensible names for the files produced,
-** use an xsl wrapper to add/modify features
-** set flag to use the id of the top-level element in the output
-   file as the filename. +
-   `xsl:param name="use.id.as.filename" select="1"`
-** fyi, other related parameters: `html-ext`, `root-filename`
-** In this example, the top-level element in the output file
-   is the `refentry`, so set ids which become the basename of the file: +
-+
- refentry id="aspectj-mode"  # in aspectj-mode.xml, produces aspecj-mode.html
- refentry id="ajdee"         # in ajdee.xml, produces ajdee.html
-
-** related parameters: `html-ext`, `root-filename`
-** these tags did not work for me: `dbhtml filename="foo.htm"`, `dbhtml prefix="foo-"`
-
-== Resources
-
-- the dtd reference for docbook
-  http://www.oreilly.com/catalog/docbook/chapter/book/docbook.html
-- the stylesheet reference for docbook xsl
-  http://docbook.sourceforge.net/projects/dsssl/doc/html.html
-
-== To Do
-
-- fyi, generate.reference.titlepage appears not to be respected.
-  tried to add if statement to html/refentry.xsl, but file still gen'd
diff --git a/docs/src/main/resources/local.properties b/docs/src/main/resources/local.properties
deleted file mode 100644 (file)
index a3cd6d2..0000000
+++ /dev/null
@@ -1,12 +0,0 @@
-# for non-release builds, versions should all be DEVELOPMENT
-# except for build.version.base
-build.version=${project.version}
-build.version.base=1.5
-build.version.long=${project.version}
-build.version.short=${project.version}
-# Repo version is for maven (as built with 'ant repo')
-repo.version=1.6.4
-java11.home=c:/home/apps/jdk11
-java13.home=c:/home/apps/jdk13
-java14.home=c:/home/apps/jdk14
-java15.home=c:/home/apps/jdk15
index 6006a4843ba45b4eeaad5b62cfc2bd1c87a4d7ab..d52158235e53524015574db3d9c6e6f8fbed6637 100644 (file)
                   <sha1>c61a373f6d50ff8fcfba900934f7254d44f9735b</sha1>
                 </configuration>
               </execution>
-              <execution>
-                <id>download-docbook-dtd</id>
-                <phase>generate-resources</phase>
-                <goals>
-                  <goal>wget</goal>
-                </goals>
-                <configuration>
-                  <url>https://www.oasis-open.org/docbook/xml/4.1.2/docbkx412.zip</url>
-                  <outputDirectory>docbook</outputDirectory>
-                  <outputFileName>docbkx412.zip</outputFileName>
-                  <sha1>b9ae7a41056bfaf885581812d60651b7b5531519</sha1>
-                </configuration>
-              </execution>
-              <execution>
-                <id>download-docbook-xsl</id>
-                <phase>generate-resources</phase>
-                <goals>
-                  <goal>wget</goal>
-                </goals>
-                <configuration>
-                  <url>https://sourceforge.net/projects/docbook/files/OldFiles/docbook-xsl-1.44.zip/download</url>
-                  <outputDirectory>docbook</outputDirectory>
-                  <outputFileName>docbook-xsl-1.44.zip</outputFileName>
-                  <sha1>626e7bee806ea14812f6f95cc2d187ab6ba9114a</sha1>
-                </configuration>
-              </execution>
             </executions>
           </plugin>
 
                       <destFileName>junit-src.zip</destFileName>
                     </artifactItem>
 
-                    <!-- Jython does not seem to be used anywhere in AspectJ -->
-
-                    <artifactItem>
-                      <!-- Binary is a bit newer than committed version, but produces identical results in 'docs' -->
-                      <groupId>saxon</groupId>
-                      <artifactId>saxon</artifactId>
-                      <version>6.5.3</version>
-                      <type>jar</type>
-                      <overWrite>false</overWrite>
-                      <outputDirectory>saxon</outputDirectory>
-                      <destFileName>saxon.jar</destFileName>
-                    </artifactItem>
                     <artifactItem>
                       <!-- Binary is identical to committed version -->
                       <groupId>regexp</groupId>
                       <destFileName>commons-logging-${lib.commons.logging.version}.jar</destFileName>
                     </artifactItem>
 
-                    <!-- Libraries used to create HTML docs from XML DocBook files -->
-                    <artifactItem>
-                      <!-- Binary is identical to committed version -->
-                      <groupId>fop</groupId>
-                      <artifactId>fop</artifactId>
-                      <version>0.20.5</version>
-                      <type>jar</type>
-                      <overWrite>false</overWrite>
-                      <outputDirectory>docbook</outputDirectory>
-                      <destFileName>fop.jar</destFileName>
-                    </artifactItem>
-                    <artifactItem>
-                      <!-- Binary is identical to committed version -->
-                      <groupId>batik</groupId>
-                      <artifactId>batik-1.5-fop</artifactId>
-                      <version>0.20-5</version>
-                      <type>jar</type>
-                      <overWrite>false</overWrite>
-                      <outputDirectory>docbook</outputDirectory>
-                      <destFileName>batik.jar</destFileName>
-                    </artifactItem>
-
                   </artifactItems>
                 </configuration>
               </execution>
                   </fileset>
                 </configuration>
               </execution>
-              <execution>
-                <id>unzip-docbook-dtd</id>
-                <phase>process-resources</phase>
-                <goals>
-                  <goal>copy</goal>
-                </goals>
-                <configuration>
-                  <verbose>true</verbose>
-                  <fileset>
-                    <directory>docbook/docbkx412.zip</directory>
-                    <outputDirectory>docbook/docbook-dtd</outputDirectory>
-                  </fileset>
-                </configuration>
-              </execution>
-              <execution>
-                <id>unzip-docbook-xsl</id>
-                <phase>process-resources</phase>
-                <goals>
-                  <goal>copy</goal>
-                </goals>
-                <configuration>
-                  <verbose>true</verbose>
-                  <fileset>
-                    <directory>docbook/docbook-xsl-1.44.zip/docbook-xsl-1.44</directory>
-                    <outputDirectory>docbook/docbook-xsl</outputDirectory>
-                  </fileset>
-                </configuration>
-              </execution>
             </executions>
           </plugin>
 
                         <include>${lib.provisioned.marker}</include>
                         <include>ant/**</include>
                         <include>commons/**</include>
-                        <include>docbook/**</include>
                         <include>jarjar/**</include>
                         <include>jdtcore-aj/**</include>
                         <include>junit/**</include>
                         <include>regexp/**</include>
-                        <include>saxon/**</include>
                       </includes>
                       <followSymlinks>false</followSymlinks>
                     </fileset>
                     <file>ant/bin/ant.bat</file>
                     <file>ant/lib/junit.jar</file>
                     <file>commons/commons.jar</file>
-                    <file>docbook/docbook-dtd/docbookx.dtd</file>
-                    <file>docbook/docbook-xsl/html/chunk.xsl</file>
-                    <file>docbook/fop.jar</file>
-                    <file>docbook/batik.jar</file>
                     <file>jarjar/jarjar-1.3.jar</file>
                     <file>jdtcore-aj/jdtcore-for-aspectj.jar</file>
                     <file>junit/junit.jar</file>
                     <file>regexp/jakarta-regexp-1.2.jar</file>
-                    <file>saxon/saxon.jar</file>
                   </files>
                 </requireFilesExist>
               </rules>
index fe4f03c4d256b9620bdd17b8ec50f0d50530f8bc..6d1acd43f7cbd4dbf814e210df023ded3d9443bd 100644 (file)
@@ -3,15 +3,15 @@
 <body>
 <h2>AspectJ library module</h2>
 
-This module primarily contains binary libraries from open-source projects, 
-some of which are subject to licenses other than the Eclipse Public License (EPL).  
+This module primarily contains binary libraries from open-source projects,
+some of which are subject to licenses other than the Eclipse Public License (EPL).
 Those not subject to EPL are not distributed in source or binary form with
-AspectJ (except for Apache's BCEL), but are used in the development of AspectJ.  
+AspectJ (except for Apache's BCEL), but are used in the development of AspectJ.
 This module also contains some bootstrap libraries and test sources.
 
 <ul>
    <li><a href="ant">ant</a>:
-       Ant 1.6.3 from 
+       Ant 1.6.3 from
        <a href="http:jakarta.apache.org/ant">http:jakarta.apache.org/ant</a>.
           This is a normal binary distribution, with junit.jar in the lib dir.
        Ant is available under the Apache Software License.
@@ -21,29 +21,26 @@ This module also contains some bootstrap libraries and test sources.
           modules built with AspectJ.  Likely to be replaced with bootstrapping.
           </li>
    <li><a href="bcel">bcel</a>:
-       The Bytecode Engineering Library from 
+       The Bytecode Engineering Library from
        <a href="http:jakarta.apache.org/bcel">http:jakarta.apache.org/bcel</a>,
        available under the Apache Software License.
        </li>
    <li><a href="build">build</a>: bootstrap libraries for the build process.
        </li>
    <li><a href="commons">commons</a>:
-       Commons 1.0 from 
+       Commons 1.0 from
        <a href="http:jakarta.apache.org/commons">http:jakarta.apache.org/commons</a>.
        This is used only by the testing module.
        </li>
    <li><a href="junit">junit</a>:
-       JUnit 3.7 test libraries, available from 
+       JUnit 3.7 test libraries, available from
        <a href="http:junit.org">junit.org</a> and under the CPL.
        </li>
    <li><a href="regexp">regexp</a>:
-       Regular expressions from 
+       Regular expressions from
        <a href="http:jakarta.apache.org">http:jakarta.apache.org</a>.
        This is used only by the testing module.
        </li>
-   <li><a href="saxon">saxon</a>:
-       For building docbook.
-       </li>
    <li><a href="test">test</a>: bootstrap libraries for the test process.
        These could be replaced with build products, to avoid the checked-in
        versions being out of date, but these build products change rarely
@@ -51,4 +48,4 @@ This module also contains some bootstrap libraries and test sources.
        </li>
 </ul>
 </body>
-</html>
\ No newline at end of file
+</html>