deprecate the current API for PDF::Reader
deprecate the current API for PDF::Reader

* This API has been around for over 5 years so it will remain for a
  long time yet (years?), it's just no longer the recommended way of
  doing things

alexdowad/pdf-reader,3jb/pdf-reader,eitoball/pdf-reader,gordonbisnor/pdf-reader,bernerdschaefer/pdf-reader,calebhaye/pdf-reader,tdenovan/pdf-reader,nmadura/pdf-reader,boutil/pdf-reader,nifarius/pdf-reader,posgen/pdf-reader,tardate/pdf-reader,yob/pdf-reader,yob/pdf-reader,yob/pdf-reader,2potatocakes/pdf-reader