Write partial ut_array documentation.

To do : ut_array_1d_sort_perm. ut_array_1d_sort_index_perm.
ut_array_1d_int_rotate, ut_array_1d_rotate, ut_array_1d_rotpos and end
of the file.
Merge branch 'doc' of https://github.com/rquey/ut into doc