Improved API docs of Array class

Found myself guessing whether 'identity' in Array.removeValue(T, boolean) stands for 'use equals()' or 'use ==', so decided to add explicit api docs just like other methods have. Useful.

Also added some to other methods. Not for all though (yet?).