Ptanal polishing

@kerneis: as promised - documentation updates