* perlcritic clean up. the for() loop was causing the filehandle to read
  in list context and sucked the entire file into memory, i knew this
  but duh forgot. just switching to while() saves a ton of memory.
  also unpacked @_ to make things cleaner.
* wrote up all the POD