txt: ## dist_zef-tony-o-Archive-Tar-PP.md
  # usage
  
  since i know this is all you care about
  
  ## new tar
  
  ```
  use Archive::Tar::PP;
  
  my $new-archive = new-tar('x.tar');
  
  $new-archive.push('some file'); #adds file data to buffer;
  
  $new-archive.write; #now you have some tarball
  
  ```
  
  ## crusty tar
  
  ```
  use Archive::Tar::PP;
  
  my $crusty = read-tar('x.tar');
  
  $crusty.ls; #returns files
  $crusty.peek('file-name to get contents of');
  #  returns Nil for dir, empty Buf for an empty file, and a Buf with the contents otherwise
  
  ```
  
  # limitations
  
  * doesn't keep user or group names
  * stores the buffers in memory so, beware
  * rewrites entire tar file every time you write, so use sparingly
  