I think it's about time that OpenGL commands are documented in the IDE documentation, and that these commands all show as hilighted tokens within the IDE. Has anyone taken steps towards achieving this? As a starter, I at least went through and put a bbdoc line before each Const and each Function so that these are now a) listed in the documentation, b) show the function parameters when you press F1 in the IDE, and c) show as hilighted in the IDE. I much prefer this to the guesswork involved in trying to remember what the functions are and what their parameters require. The ideal thing of course would be to get all of the `blue book` into bbdoc documentation so that it is available within the IDE for all commands, but having taken a look at it that is quite a lot of work. Anyway, here is my OpenGL.bmx file which you can put in the Public/OpenGL module folder, then run the Bin/Docmods program. Abracadabra.
You don't need to rebuild the module as no code has change. It's just a documentaton change. It's at least a first step, you might find it useful. It doesn't give any info on what the functions do or what the parameters can
|