Posted by Sven Gothel on Oct 19, 2011; 11:46am
URL: https://forum.jogamp.org/Please-fix-some-mistakes-in-the-main-JOGL-presentation-page-tp3433981p3434064.html

On Wednesday, October 19, 2011 01:03:02 PM gouessej [via jogamp] wrote:
Thank you for hinting to my sloppy English, fixed.
        jogl: 5e81cb163c00da18f0990411c22257b5533d7950

>
> English is not my mother tongue. It is already difficult to put up with the
> FUD campaigns of our competitors (some of them came on a French forum and
> pretended than JOGL does not support even OpenGL 3), we should not drive the
> situation harder by providing approximate information.

Let me dump the 'intro' text here:

Linked text is put in brackets <>.

+++

The JOGL project hosts the development version of the Java™ Binding for the OpenGL® API,
and is designed to provide hardware-supported 3D graphics to applications written in Java.

JOGL provides full access to the APIs in the OpenGL 1.3 - 3.0, 3.1 - 3.3, ≥ 4.0,
ES 1.x and ES 2.x specification as well as nearly all vendor extensions.
<OpenGL Evolution & JOGL> <(UML)> gives you a brief overview of OpenGL,
its profiles and how we map them to JOGL.

JOGL integrates with the AWT and Swing widget sets,
as well with custom windowing toolkits using the NativeWindow API.
<JOGL also provides its own native windowing toolkit, NEWT>.

+++

Doesn't the text clearly states that JOGL provides .. OpenGL .., 3.1-3.3, >= 4.0 ?
The UML links etc are mentioning this detail as well I guess.

I have to admit, I haven't added the few new OpenGL API entries of 4.2
into our GL4 headers yet.

I also think about mentioning the currently supported platforms somewhere
when we make the RC4 release w/ Linux, Android, Window, OSX and Solaris.
Maybe a nice table, OS/arch.

>
> The documentation should be updated too.

If you have ideas or more detailed information, let's discuss it.
I know that documentation always can be made better, sure,
but your statement is to vague.

Currently [and within the last yeat] I do put effort in proper API documentation
when I touch that code path, updated the Wiki documentation, etc.
Again - yes, it can be better - plus a one-stop tutorial.

At this point, I also love to thank Wade Walker for adding lots of Wiki docs,
beside his other efforts in stabilizing JOGL.

Well, the day has only 24 hours .. so my power is limited, sorry :)
[Still doing what I can do though]

Everybody is more than welcome to make our little world a bit better.
Go for it!

Cheers, Sven

>
> -----
> Julien Gouesse