JOGL FAQ

OpenGL Development JOGL Development
#1

Fed up with the lack of FAQ for JOGL, and having had to spend today setting up a robust JOGL app, I’ve started a FAQ of my own.

http://grexengine.com/sections/externalgames/tech-page-JOGL-faq.html

This is also linked from the JOGL tech page on JGF, so you don’t have to remember the URL if you can’t be bothered ;).

So far, it’s populated with just a handful of questions answered on these forums which I had bookmarked. Any additional questions and answers gratefully received! Just send an email to ceo @ grexengine.com.

Don’t forget to include the name of the person who answered the question, and if there’s a URL which has more information, send me that too (the FAQ system auto-generates a “more info” link whenever it can).

Question text should be plain ASCII.

Answer text MUST BE HTML FORMATTED! Don’t forget to surround everything in

tags, and don’t forget to close every tag. If you don’t, the XSLT won’t compile, and that means it’ll take longer before I get around to trying to fix your HTML and include your question :frowning: :(. You can use any “normal” HTML, like P, I, B, FONT, TABLE, HR, etc (it reuses the standard filter used on JGF, if you’re interested).

EDIT: PS sorry about the incorrect value for the number of questions; I think it’s an XSLTPROC bug (in this case, it counts nodes that I believe should not be counted according to the XPATH spec, but I haven’t worked out a workaround yet).

#2

Thanks for taking the initiative on this. Could we include this document in the JOGL source base? Would you be willing to maintain it there? If so, please contact me directly and I’ll work with you on getting checkin access to the CVS repository. Thanks.

#3

[quote]Thanks for taking the initiative on this.
[/quote]
Not much help right now, I’m afraid, but perhaps it will nudge some other people into contributing some questions :wink:

With a plain link to the main version on JGF (as the source for the latest maintained copy - the URL supplied is permanent at least until JGF gets it’s own domain) and the names of the people who are compiling it (currently just me, but when JGF moves to it’s next version then several people will have equal access to edit it), and if you retain the names of the people who answered each question, then that would be great. (I just want to make sure that the people involved get fair credit :)).

You can either include the HTML as-is, or I can provide the raw XML dump, with everything cleanly split up into question, answer, answer-author, etc (since that’s how the source is stored - assuming anyone knows some XSLT you could MUCH more easily transform this to java.net-style HTML than the raw HTML).

I’ll continue to run a master copy on JGF mainly because I can guarantee my permanent easy access to it (and partially because I hate CVS ;)).

For java.net I’m afraid I’m only prepared to go as far as providing the data, and to maintain the raw XML - however that ought to be enough to do whatever you want. Anything else is going to be too time consuming/too much commitment for me (at the moment I’m almost entirely just applying generic XSLT functions that were written for other parts of JGF). If someone else wants to volunteer to set up an XSLT for you to generate a custom layout, I’ll help them (although my knowledge of XSLT is only basic), but won’t take on that responsibility myself.