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

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 



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

[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]