document a few array functions