AOApplicationToPetscPermuteInt() help needed

[Barry Smith]

  Will whoever wrote the manual pages for all the 
AOApplicationToPetscPermute*() routines please add more
documentation explaining what they do? Maybe some algebraic
formula or something: "Permutes an array of blocks of reals
in the PETSc ordering to the application-defined ordering."
means nothing to me. How long is "array[]", what does permute
mean in this context?

   Barry