From be7b8bac324f6ed77d7398080feafacf379934a0 Mon Sep 17 00:00:00 2001
From: Ben Fry <ben@fathom.info>
Date: Tue, 5 Oct 2021 21:13:17 -0400
Subject: [PATCH] notes about changes

---
 build/macosx/appbundler/README.md | 44 +++++++++++++++++--------------
 1 file changed, 24 insertions(+), 20 deletions(-)

diff --git a/build/macosx/appbundler/README.md b/build/macosx/appbundler/README.md
index 513ae385b..20fc50600 100644
--- a/build/macosx/appbundler/README.md
+++ b/build/macosx/appbundler/README.md
@@ -1,11 +1,15 @@
-This is a (minor) fork of <https://github.com/TheInfiniteKind/appbundler>. 
+This is a (minor) fork of <https://github.com/TheInfiniteKind/appbundler>. Changes include:
+
+* For consistency with earlier releases, there's no `appbundler` subfolder. Everything remains in this folder.
+* The output is `appbundler.jar` in the folder above this one, instead of `bin/appbundler-1.0ea`.
+* `build.properties` has been removed, because only two of the lines are actually used.
 
 The code should only be built on Mojave or earlier, otherwise exported OpenGL applications will crash. [Please help!](https://github.com/processing/processing4/issues/284)
 
 appbundler
 =============
 
-A fork of the [Java Application Bundler](https://svn.java.net/svn/appbundler~svn) 
+A fork of the [Java Application Bundler](https://svn.java.net/svn/appbundler~svn)
 with the following changes:
 
 - Fixes [icon not showing bug](http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=7159381) in `JavaAppLauncher`
@@ -13,7 +17,7 @@ with the following changes:
 - Allows to specify the name of the executable instead of using the default `"JavaAppLauncher"` **(contributed by Karl von Randow)**
 - Adds `classpathref` support to the `bundleapp` task
 - Adds support for `JVMArchs` and `LSArchitecturePriority` keys
-- Allows to specify a custom value for `CFBundleVersion` 
+- Allows to specify a custom value for `CFBundleVersion`
 - Allows specifying registered file extensions using `CFBundleDocumentTypes` and `UT[Ex|Im]portedTypeDeclarations`
 - Passes to the Java application a set of system properties with the paths of
   the OSX special folders, whether the application is running in the
@@ -61,11 +65,11 @@ For more details, please refer to the [task documentation](http://htmlpreview.gi
 Example 1:
 
     <target name="bundle">
-      <taskdef name="bundleapp" 
+      <taskdef name="bundleapp"
         classpath="appbundler-1.0ea.jar"
         classname="com.oracle.appbundler.AppBundlerTask"/>
 
-      <bundleapp 
+      <bundleapp
           classpathref="runclasspathref"
           outputdirectory="${dist}"
           name="${bundle.name}"
@@ -78,7 +82,7 @@ Example 1:
           mainclassname="Main"
           copyright="2012 Your Company"
           applicationCategory="public.app-category.finance">
-          
+
           <runtime dir="${runtime}/Contents/Home"/>
 
           <arch name="x86_64"/>
@@ -89,20 +93,20 @@ Example 1:
             name="Images"
             role="editor"
             handlerRank="owner">
-          </bundledocument> 
+          </bundledocument>
 
           <bundledocument contentTypes="com.adobe.pdf"
             name="PDF files"
             role="viewer"
             handlerRank="alternate">
           </bundledocument>
-          
+
           <bundledocument contentTypes="com.my.custom"
             name="Custom data"
             role="editor"
             exportableTypes="com.topografix.gpx">
           </bundledocument>
-          
+
           <typedeclaration
             identifier="com.my.custom"
             description="Custom data"
@@ -110,7 +114,7 @@ Example 1:
             conformsTo="com.apple.package"
             extensions="custom"
             mimeTypes="application/x-custom" />
-        
+
           <typedeclaration
       	   imported = "true"
             identifier="com.topografix.gpx"
@@ -119,8 +123,8 @@ Example 1:
             conformsTo="public.xml"
             extensions="gpx"
             mimeTypes="application/gpx+xml" />
-          
-          
+
+
           <!-- Define custom key-value pairs in Info.plist -->
           <plistentry key="ABCCustomKey" value="foobar"/>
           <plistentry key="ABCCustomBoolean" value="true" type="boolean"/>
@@ -142,10 +146,10 @@ Example 1:
 Example 2, use installed Java but require Java 8 (or later):
 
     <target name="bundle">
-      <taskdef name="bundleapp" 
+      <taskdef name="bundleapp"
         classpath="appbundler-1.0ea.jar"
         classname="com.oracle.appbundler.AppBundlerTask"/>
-      <bundleapp 
+      <bundleapp
           jvmrequired="1.8"
           classpathref="runclasspathref"
           outputdirectory="${dist}"
@@ -165,10 +169,10 @@ Example 2, use installed Java but require Java 8 (or later):
 Example 2, use installed Java but require Java 8 (or later) JRE and not a JDK:
 
     <target name="bundle">
-      <taskdef name="bundleapp" 
+      <taskdef name="bundleapp"
         classpath="appbundler-1.0ea.jar"
         classname="com.oracle.appbundler.AppBundlerTask"/>
-      <bundleapp 
+      <bundleapp
           jvmrequired="1.8"
           jrePreferred="true"
           classpathref="runclasspathref"
@@ -197,11 +201,11 @@ Example 3, bundle a stripped down JRE that only needs java.base and java.desktop
         <arg value="11"/>
       </exec>
 
-      <taskdef name="bundleapp" 
+      <taskdef name="bundleapp"
         classpath="appbundler-1.0ea.jar"
         classname="com.oracle.appbundler.AppBundlerTask"/>
 
-        <bundleapp 
+        <bundleapp
           classpathref="runclasspathref"
           outputdirectory="${dist}"
           name="${bundle.name}"
@@ -243,11 +247,11 @@ Example 4, bundle a stripped down JRE that only needs java.base and java.desktop
         <arg value="11"/>
       </exec>
 
-      <taskdef name="bundleapp" 
+      <taskdef name="bundleapp"
         classpath="appbundler-1.0ea.jar"
         classname="com.oracle.appbundler.AppBundlerTask"/>
 
-        <bundleapp 
+        <bundleapp
           classpathref="runclasspathref"
           outputdirectory="${dist}"
           name="${bundle.name}"