Fix docstring for methods that return an array and have a length (out) argument.

When assigning arguments to either the function or return type, also take into account the "(array length=)" attribute of the return type.

Fixes #352 (closed).