further updates to pgm doc