[documentation] FILES does not just 'extend' arrays.

Documentation bug. From the built-in help text for "FILES": String array to store the listed file names - For one-dimensional arrays, the array will be automatically extended according to the number of files obtained This is misleading wording. The array is extended or truncated in order to make it just the right size to hold the list.

I'm not sure that I would consider it a documentation BUG, more of an error, but I personally wouldn't count anything in documentation as a BUG. Though I am surprised that they did not document that. It should be easy to workaround though. With LEN working with arrays, should be simple.

Consider the following code:

DEF F(X,Y)
RETURN X+Y
END

Does it have a bug? Consider the following system, consisting of two components, the first component being the code:

DEF F(X,Y)
RETURN X+Y
END

and the second component being the documentation: The function F takes two numerical parameters and returns the one with the greater value. Is there a bug in the code? It is impossible to say there is 'a bug in the code' without knowing what the specification of the code is. As such, bugs exists not in the code per se, but in the combination of code-and-specification. Once you realize that bugs exist in the world of code-and-specification, it is natural to speak of bugs in the documentation.

Listen, I'm going to be blunt and a bit rude. Documentation errors are not bugs, they are much more likely to be translation errors. If you find something that doesn't match the English docs, then the docs are mistaken, but you can't call it a bug. If you find something that doesn't match the JAPANESE docs, then I'd be surprised. The contact form on SmileBASIC's website has a "translation error" option for message type. Use it.

If we're going that way, I'll be blunt and rude as well. You do not define language. It is common among more experienced developers to refer to errors in specification as 'bugs'.

If you find something that doesn't match the JAPANESE docs, then I'd be surprised.

Regrettably this documentation bug exists in the Japanese documentation as well. Another documentation bug that SquareFingers pointed out, in this thread: http://smilebasicsource.com/forum?ftid=28&page=1 ...is also present in the Japanese docs. The Japanese docs used to have very scant information, and were updated around the time of the the 3.2.0 and 3.2.1 updates last summer. I get the impression that SmileBoom didn't have the personpower to create full documentation at launch, and are continuing to improve it as they go.

So the array will be automatically RESIZED according to the number of files obtained. All it requires is changing a word.