I don't think I can even once claim to have used a programming language that was so well documented that 75% of all the information you would ever need could be found in it's documentation.
Before Blitz3D (before I had ever heard of it and used it) I programmed in VB 6.0 and found everything I currently know, inside the docs (MSDN).
I don't know any website where I have posted a single questions about VB.
It's not that I can program everything, but I can find my way around the docs (MSDN).
Mt first intro to VB was nothing more than my friend explaining how to draw a button, which routine was executed when it was clicked upon, how to set the Caption (in code) and that was basically it.
Now I'm even using custom types, classes and separate OCX-components (NTPort) in VB, without any help from anyone else.
I evenly created an almost complete (haven't finished it yet) interface program for controlling selfmade hardware, which is connected to the printerport.
Theoretically I can switch on/off about 4 billion lights individually.
Practically it wouldn't be possible, because it would require a very big PCB (printer circuit board).
But the software has the ability to do it.
It's slow (serial data transfer on the parallel port), but very stable.
And all this without help from anyone.
But that's not the point here.
But the docs for BMax don't really explain everything clearly (and especially for a newbie to programming).
BMax is a BASIC language and can be used by complete programming newbies, but I don't think they can find their way to start off quickly with these docs.
I know that BMax is quite new, and that the docs are not complete yet, but it cannot be that the docs are finished.
In my opinion, if a programming language has not sufficient documentation, and a beginner has to walk through tons of sourcecode to understand the functionality of a command (or even to find if a certain command or functionality exists), they will be scared off and find another language that has enough docs to get them started programming the game/app they want to create.
No offence Mark, but some commands definately need better docs, which explain not only the basic functionality, but also has samples which also explain more advanced functionality.
In the B3D docs, there's almost an entire A4-sized page, describing WHAT a user-defined type is and how to use it, with a practical example.
In the BMac docs, this stated what a user-defined type is:
User defined type allow you to group related data and program code together into a single entity known as an object.
And what follows, is the syntax, what stuff can be placed inside a type and what those things are that you can place there.
I doubt that will do for a newbie.