Building netbeans 26 on macOS

[jerry-apl]

I have been downloading the source and building each release using the latest GraalVM.
Have not had any trouble till now. I commend every one who helps keep netbeans running. Building has been painless.
I downloaded netbeans 26 source built it.

ant build > a     # output in ../nbbuild/netbeans
ant build javadoc #  I had not ran that before, but it seemed to run fine.
ant tryme.  # runs netbeans
# I moved produced netbeans directory to where my startup script normally starts netbeans. All is good. 
ant -q clean  # removes build dir,  I just wanted to see what it cleaned up as the readme did not explicitly say.
# so I reran the build, no problem
# but on rebuilding javadoc gave me errors.
# issue on rebuild of javadoc after ant -q clean
# first error needed graalvm-jdk-24.0.1+9.1/Contents/Home/conf/jaxp.properties  values updated to allow 3 times the entities.
# then glass.png and x.png kept coming up missing in nbbuild/build/javadoc/??????/resource-files
# each javadoc/subdir would fail for that, so I gave up.

I suspect the correct person might know what went wrong.

[jerry-apl]

retried with a fresh down load, my first javadoc build must have failed and I did not notice.
ant build javadoc just fails......

[jerry-apl]

It appears the README.md is incorrect. The command to build javadoc should be:
"ant build-javadoc"

[mbien]

CI uses build-javadoc too so we probably should use the same target in the readme (esp if build javadoc doesn't work)

edit: some updates #8734

[mbien]

first error needed graalvm-jdk-24.0.1+9.1/Contents/Home/conf/jaxp.properties values updated to allow 3 times the entities.

yep, JDK reduced the default limits for some xml APIs (#8369), for building doc it has to be increased again:

netbeans/.github/workflows/main.yml

Lines 458 to 459 in 161fdcb

	export ANT_OPTS=-Djdk.xml.totalEntitySizeLimit=200000
	ant $OPTS -Djavadoc.fail.broken.links=true build-javadoc

then glass.png and x.png kept coming up missing

JDK doc switched from png to svg at some point. This was fixed for NB 27 (#8633).