jj2007: again - if the other languages are so much better, if you don't like FB, why are you here?
This should be a discussion about the docs.
The programming of the syntax is what it is.
The docs as they were was not so bad.
An addition that basically a pointer is passed around would help some others
for clarity, perhaps.
Some language explanations will always present difficulty for some people at different times. I have had this problem. That doesn't make the current docs terrible. They are simply not perfect.
That's OK. No one else gets to be perfect because I am not perfect.
@fxm:
I prefer mine which is more compact and precise IMHO.
Anyone can disagree with that. Then they make suggestions.
Otherwise, I agree with you, mostly.
In this case, I see no problem. I am not everyone.
Generally, I think too much effort is given to that "compact" and "precise".
BUT
Generally, I appreciate your efforts and work you obviously give to support FB. I respect your deep insights you have worked so hard to get.
And unless someone else is saying they will do a more thorough and complete job, I much prefer you continue.
Just, sometimes, remember that you are a person like anyone else and not always right. And you don't need to be a defender of the Bible of FreeBASIC.