Synchronize GlueGen documentation with current code, i.e. latest code changes as well as some of the JOGL_2_SANDBOX efforts back then.
I started producing a new document as of late covering these matters
Perhaps we want to make a choice to at least update
the GlueGen config options in
I personally prefer using Markdown document format over the html one.
Perhaps we can convert the html version automatically to markdown
and then merge to document?
Yes, synchronizing the manual is necessary, especially for the configuration options.
I also prefer the markdown format, which allows you to concentrate on the content rather than the form imho.
I'm putting all the documentation I've made on a branch by the end of the day or tomorrow at the latest.
Sorry for the delay, it's been a busy week :x, but here's a partial update of the manual I placed on this branch: 1449-manual-sync-configuration-entries of my branch (https://github.com/MathiusD/gluegen as always)
Merged index.html change 9b825a445c3d2646546306c1815f498406e2f8c3
of comment 2.
Thank you Mathieu!
Convert manual/index.html to `gfm` (GitHub-Flavored Markdown) using markdown
also adds conversion recipes + make/scripts/md2html_update.sh
Note: Additionally edited 'doc/misc/macos_nativelib_dependencies.md`
to include `Use explicit OpenJDK/Temurin JDK `java` executable path`
as a workaround to pass `DYLD_LIBRARY_PATH` to `/usr/bin/java`.
Conversion was done using:
pandoc index.html -t gfm -o index.md
(In reply to Sven Gothel from comment #4)
We convert markdown using pandoc using `gfm` (GitHub-Flavored Markdown) as source format
and `html5+smart` with a custom template as the target.
~/pandoc-buttondown-cgit/pandoc_md2html_local.sh GlueGen_Mapping.md > GlueGen_Mapping.html
Closing this portion of GlueGen documentation updates for 2.5.0,
further work will be done under Bug 1451