POD in tarballs (was Re: Gtk2::Assistant and Button Access)

["Martin Schlemmer" <Martin Schlemmer nwu ac za>]

> > > On 2009/11/29 at 11:44 PM, Torsten Schoenfeld <kaffeetisch gmx de> wrote:
> On 11/26/2009 01:42 AM, Jeffrey Ray wrote:
> > I think the documentation should be included in the distribution. I
> > think most perl users expect to be able to say perldoc Gtk2::xxx and get
> > a response - and to be able find documentation for a >module on CPAN.
> > is that I think alot of the things you can find here
> > http://gtk2-perl.sourceforge.net/doc/pod/index.html should be made
> > included with the Gtk2-perl distribution so that I can perldoc
> > Gtk2::Assistant and get some documentation
> >
> > I'm willing to help make this happen if it is decided to include the pod
>
> Yes, I think it would be worth a try.  We used to take pride in the 
> small size of our tarballs, but with today's bandwidth availability, I'm 
> unsure whether tarball size still matters that much.
>
> To make this happen, you would need to find a way to hook the POD 
> generation into 'make dist'.  The Makefile code for the POD generation 
> is created in Glib::MakeHelper::postamble_docs_full().

If its on Windows, then there is a bug with later versions of MakeMaker if I remember correctly.  I usually 
just do before I install or make a ppm:

  dmake $(INST_LIB)/$(FULLEXT)/index.pod

So on Windows with ActivePerl I have both html and pod docs.  I can send my build scripts if anybody are 
interested.


Regards

Martin


Vrywaringsklousule / Disclaimer:  http://www.nwu.ac.za/it/gov-man/disclaimer.html