id	summary	reporter	owner	description	type	status	milestone	component	version	severity	resolution	keywords	cc
4002	Only some _ArrayX functions have their Failure Return value documented	lwc		"The documentation of `_ArrayX` functions usually separates the return value to:
1. Success
1. Failure
1. @error

But in cases like [https://www.autoitscript.com/autoit3/docs/libfunctions/_ArrayFindAll.htm _ArrayFindAll] it separates the Return value to:
1. Success
1. Failure - which actually describes @error and not failure! I.e. '''it doesn't mention that it returns -1''' (which is the standard in `_ArrayX` functions)

I think it's important because checking for a general `not @error` should be a last resort, only after first directly checking if there was no failure.

`_ArrayX` functions which don't their Failure Return value documented - and the needed fix (which I've confirmed):
1. `_ArrayCombinations` - failure actually returns '''0'''
1. `_ArrayFindAll` - failure actually returns '''-1'''
1. `_ArrayFromString` - failure actually returns '''an empty array'''
1. `_ArrayMax` - failure actually returns '''blank'''
1. `_ArrayMin` - failure actually returns '''blank'''
1. `_ArrayPermute` - failure actually returns '''blank'''
1. `_ArrayPop` - failure actually returns '''blank'''
1. `_ArrayToString` - failure actually returns '''blank'''
1. `_ArrayUnique` - failure actually returns '''blank'''
1. `_Array1DToHistogram` - failure actually returns '''blank'''
1. `_Array2DCreate` - failure actually returns '''blank'''

That's more than a third of those functions (11 out of 32)."	Bug	closed		Documentation	3.3.16.1	None	No Bug	return-value