1449 2023-08-09 15:18:02 +0200 Update GlueGen Documentation 2023-08-14 04:43:21 +0200 1 1 3 JogAmp Gluegen core 2.5.0 All all RESOLVED FIXED P4 normal --- 1451 1 sgothel sgothel mfery DEFECT 9b825a445c3d2646546306c1815f498406e2f8c3 fd623305d90a88fd01dea3dccf6b9fe76b19703f 9250960f107cebbb4e6d3a55009b330f101453ea 8850b3d7f82ca5f1f828192407574581abd82ef9 --- oldest_to_newest 6840 0 sgothel 2023-08-09 15:18:02 +0200 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 - https://jogamp.org/cgit/gluegen.git/tree/doc/GlueGen_Mapping.md Perhaps we want to make a choice to at least update the GlueGen config options in https://jogamp.org/gluegen/doc/manual/ 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? 6848 1 mfery 2023-08-10 12:17:07 +0200 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. 6849 2 mfery 2023-08-13 23:33:16 +0200 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) 6850 3 sgothel 2023-08-14 02:33:20 +0200 Merged index.html change 9b825a445c3d2646546306c1815f498406e2f8c3 of comment 2. Thank you Mathieu! 6851 4 sgothel 2023-08-14 04:30:56 +0200 commit fd623305d90a88fd01dea3dccf6b9fe76b19703f Convert manual/index.html to `gfm` (GitHub-Flavored Markdown) using markdown -> manual/index.md 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 6852 5 sgothel 2023-08-14 04:32:08 +0200 (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. Recipe: ``` ~/pandoc-buttondown-cgit/pandoc_md2html_local.sh GlueGen_Mapping.md > GlueGen_Mapping.html ``` Git repos: - https://jausoft.com/cgit/users/sgothel/pandoc-buttondown-cgit.git/about/ - https://github.com/sgothel/pandoc-buttondown-cgit 6854 6 sgothel 2023-08-14 04:43:21 +0200 Closing this portion of GlueGen documentation updates for 2.5.0, further work will be done under Bug 1451