On Mon, Jul 18, 2011 at 9:31 AM, Chris Marshall <devel.chm...@gmail.com> wrote: > I recommend putting a link in the POD to the PDF on > a web site. A 4X increase in the size of the distribution > is a pretty expensive way to publish. How about a short > synopsis in the POD with the link for more detail if > needed---unless, of course, the Marpa::XS is not usable > without reading the PDF?
I concur -- particularly because in practice, there is no standard for how extra docs should be installed and made accessible to users. Yes, one could use File::ShareDir to install it, but then you still have the problem of getting the user to know where to find it. On the other hand, if it's in the tarball and not installed, then 99% of users will download the tarball, unpack it to temp space and then discard the build directory and tarball and all that extra size is for naught. A web link is the way to go. -- David
