notes about changes due to workaround for #124

Author: benfry

build/shared/changes.md

@@ -1,15 +1,20 @@
 # Processing 4.0 alpha 2
 
-*Revision 1271 - 17 August 2020*
+*Revision 1271 - 15 September 2020*
 
 Several fixes for this round, plus working on the guts quite a bit to prepare for newer/faster/better rendering methods.
 
-The minimum system version for macOS (for the PDE and exported applications) is now set to 10.13.6 (the last update of High Sierra). Apple will likely be dropping support for High Sierra in late 2020, so we may make the minimum 10.14.x by the time 4.x ships.
+The minimum system version for macOS (for the PDE and exported applications) is now set to 10.13.6 (the last update of High Sierra). Apple will likely be dropping support for High Sierra in late 2020, so we may make Mojave (10.14) the minimum by the time Processing 4.x ships.
+
+
+### Known Issues
+
+* If you're using P2D or P3D on macOS, and have `surface.setResizable(true)` inside `setup()`, you'll need to (temporarily) move that into `draw()`. We had to do an ugly hack at release time due to issue [124](https://github.com/processing/processing4/issues/124). The ugly hack also involves the window flickering once when it first opens in this situation. We should have that fixed for the next release.
 
 
 ### Bug Fixes
 
-* Break buildMenu() into populateMenu() method to delay Debugger init [73](https://github.com/processing/processing4/issues/73)
+* Break `buildMenu()` into `populateMenu()` method to delay Debugger init [73](https://github.com/processing/processing4/issues/73)
 * Fix broken macOS build [83](https://github.com/processing/processing4/issues/83)
 * Bump JDK to 11.0.8, then rolled back to JDK 11.0.6 again [121](https://github.com/processing/processing4/issues/121), [123](https://github.com/processing/processing4/pull/123)
 * Make macOS notarization part of the build process [24](https://github.com/processing/processing4/issues/24)

core/todo.txt

@@ -33,11 +33,14 @@ critical
 X PImage save() mostly broken due to AWT refactor
 X Saving to PNG broken in anything but the default renderer
 X   https://github.com/processing/processing4/issues/80
-_ pixelDensity() throws error in setup()
-_   https://github.com/processing/processing4/issues/127
-_ JDK 11.0.7 not working with JOGL
+X Rendering broken with P2D/P3D, fixed with temporary hack
+X   https://github.com/processing/processing4/issues/124
+
+
+_ JDK 11.0.7+ workarounds/hacks in place, fix them
 _   https://github.com/processing/processing4/issues/124
 
+
 load/save image
 _ https://github.com/processing/processing4/wiki/Exorcising-AWT
 _ moving loadImage() into Surface
@@ -48,6 +51,8 @@ _   https://github.com/processing/processing4/pull/98
 
 
 noted by Casey
+_ pixelDensity() throws error in setup() (Sam couldn't reproduce)
+_   https://github.com/processing/processing4/issues/127
 _ Export Application broken in Processing 3.5.4 when using P2D or P3D renderers
 _   may be a JOGL bug, fixed by the 2.4 RC (therefore fixed in 4.x already?)
 _   https://github.com/processing/processing/issues/5983
@@ -56,6 +61,7 @@ _   https://github.com/processing/processing/issues/4894
 _   https://github.com/processing/processing/issues/4895
 _   https://github.com/processing/processing/issues/4897
 
+
 api changes
 _ static versions of selectInput/selectOutput/selectFolder in PApplet have been removed
 _ java.awt.Frame object "frame" removed from PApplet (been warning since 2015)

todo.txt

@@ -59,6 +59,9 @@ X Zoom dialog fonts based on user scale setting
 X   https://github.com/processing/processing4/issues/111
 X   https://github.com/processing/processing4/pull/125
 
+_ need to fix this text:
+_   /* autogenerated by Processing preprocessor v3.0.0 on 2020-09-15 */
+_ also need spaces in the size command, per our guidelines
 
 _ JSSC binaries for windows_32 and windows_64 appear to be macOS files
 _   https://github.com/processing/processing4/issues/119