Please fix some mistakes in the main JOGL presentation page

Hi

Please fix some mistakes in this page:
http://jogamp.org/jogl/www/

Some newbies on several forums and on StackOverflow still believe JOGL does not support OpenGL 3.x, some others believe that JOGL does not support OpenGL 4.2.

Please fix these spelling mistakes:
"OpenGL Evolution & JOGL (UML) gives you a brief overview of OpenGL, it's profiles"

"JOGL also provides it's own native windowing toolkit"

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.

The documentation should be updated too.

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

The latest additions in the public API (confinePointer() and setPointerVisible()) do not appear in the documentation.

Does the addition of the few new OpenGL API entries of 4.2 require a "big" effort? It would be nice to fix that and to update the main JOGL page. People should understand "≥ 4.0".

My English is sloppy too.

I wrote only a small tutorial in French and English to explain how to use my JOGL 2 renderer but only English Wordpress blogs using the tag "java-opengl" appear in the "Blogs" section, maybe the same could be done for the tag "jogl" and for French Wordpress blogs using those:
http://fr.wordpress.com/tag/jogl/

On Wednesday, October 19, 2011 03:58:12 PM gouessej [via jogamp] wrote:
>
> The latest additions in the public API (confinePointer() and
> setPointerVisible()) do not appear in the documentation.
>
Yup, these latest additions are not yet promoted to jogamp-next yet.
But you can attach the source zip file to the JAR (you know it),
then you shall see the API doc in your IDE.

> Does the addition of the few new OpenGL API entries of 4.2 require a "big"
> effort? It would be nice to fix that and to update the main JOGL page.
Not big .. will do for RC4, you know .. 24/7 :)

I thought I should make OSX/Android usable first before adding new features,
ie. widen the supported platforms to address more users then adding
support to features (GL 4.2) people currently hardly use or stable drivers even
exist.

Need another round of OSX fixes here, plus validate Android's use case.

> People should understand "≥ 4.0".
yup.

>
> My English is sloppy too.
na - we are all doing just fine :)

>
> I wrote only a small tutorial in French and English to explain how to use my
> JOGL 2 renderer but only English Wordpress blogs using the tag "java-opengl"
> appear in the "Blogs" section, maybe the same could be done for the tag
> "jogl" and for French Wordpress blogs using those:
> http://fr.wordpress.com/tag/jogl/ http://fr.wordpress.com/tag/jogl/ 
uh .. sure. err, I guess Dominik is the man for that right now.
I earmark this, pls remind me in a PM to do so, thx.

~Sven

Hi

There is no hurry and I can live without an updated documentation, it is only sometimes problematic for beginners.

I agree with you, stabilizing the current release candidate on Android and Mac OS X has to be done before adding new features and some people who asks for 4.2 support won't often use 4.2 features...

> I wrote only a small tutorial in French and English to explain how to use my
> JOGL 2 renderer but only English Wordpress blogs using the tag "java-opengl"
> appear in the "Blogs" section, maybe the same could be done for the tag
> "jogl" and for French Wordpress blogs using those:
> http://fr.wordpress.com/tag/jogl/ http://fr.wordpress.com/tag/jogl/ 
>
>uh .. sure. err, I guess Dominik is the man for that right now.
>I earmark this, pls remind me in a PM to do so, thx.

Michael is the guy for HungryHarry . Maybe u should directly send him a pull request with the adjusted config files.

But my personal opinion is that we should not integrate "foreign languages" other than english in any part of jogamp.org. My feeling is that it generally repells people if they can't understand a thing. Better stick with english ... just my 5 cents :)

On Thursday, October 20, 2011 01:46:45 PM Demoscene Passivist [via jogamp] wrote:
I agree.

~Sven

Almost all my articles concerning JOGL are available both in French and in English but if you have something against non native English speakers and writers, just let me know. It is the same with Technorati, etc... This service and Wordpress refuse to officially support blogs using several languages, it is just silly, I won't copy all my contents onto a second blog just to please Wordpress and I won't drop French.

I have spent a lot of time in translating them, I'm very exaspered by such reactions :(

On Thursday, October 20, 2011 04:37:03 PM gouessej [via jogamp] wrote:
Sorry Julien, I don't mean it this way
and for sure Dominik neither.

I guess our point is not to confuse people with another language than the
'official' project language, which is 'some form of' English :)

If you add a 'french' button to your blog entries we aggregate on JogAmp,
that is great - and I am sure your audience highly appreciates your efforts.
The point is not to confuse readers on the aggregation page
w/ another language, thats all.

I for myself am just too lazy to translate everything in German, my mother tongue,
especially since I believe that our audience is capable of reading my little English.
But thats my personal choice.

So again: Ofc you/we can make a 'french' FR link button on your blog link.
I am sure thats all great.
But pls do not insist that we fill in the french language into our blog aggregation page,
you know .. this one: http://jogamp.org/blog/

But I will add your blog link on the 'Feeds' site to the right with an EN/FR 'button',
if thats ok w/ you. Again: Maybe just add to each of your english posts a link to the french version,
I guess then we are all cool.

Cheers, Sven

On Thursday, October 20, 2011 04:37:03 PM gouessej [via jogamp] wrote:
I see .. right, your pages *are* dual language.
So IMHO it's fine, as long it's not pure french, see my last email.

Maybe let's figure out a proper solution in a PM,
but hey - we are friends and figure it out.

~Sven

On Thursday, October 20, 2011 05:10:17 PM Sven Gothel wrote:
Ok .. reading our aggregated blog section and your blogs abit
in regars to layout .. this reminds me of the one feature I would
love to have all the time:
  Teaser Mode: Showing only the first few lines or paragraphs of each blog entry
  as a teaser.

This teaser mode would allow to show more blogs as an overview
which may provoke the reader to click on the link to read the whole post.

Right now, our lengthly blogs actually 'spam' the whole page ..

The result should look like this IMHO: http://jausoft.com/blog/

Well, I use the 'wordpress' tag <more> to make split the teaser,
maybe we can add it's detection as well .. and if none is there
we would need to split in a heuristic way.

Anybody willing to add this feature to hungry harry ?

Cheers, Sven

Yes my pages use both languages including English, I wouldn't have bothered anyone if they were only in pure French. When Ardor3D uses officially JOGL 2, I will write a tutorial explaining how to use it and maybe a link pointing to it would be fine in the section of the wiki dedicated to JOGL tutorials. I don't want to confuse users. I wanted to add a system allowing to select a language on my blog but it is only possible on Wordpress.org, not on Wordpress.com because on some restrictions on JavaScript and HTML usages.