Also in agreement, \@array is far more meaningful than $arrayref or confusing []. If you are concerned about confusion (and particularly if more than one person is writing POD) - the first POD you write should be a style guide. Sounds redundant to some, but - Document how you Document, beforehand.