POD in tarballs (was Re: Gtk2::Assistant and Button Access)
On 2009/11/29 at 11:44 PM, Torsten Schoenfeld kaffeeti...@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 ___ gtk-perl-list mailing list gtk-perl-list@gnome.org http://mail.gnome.org/mailman/listinfo/gtk-perl-list
POD in tarballs (was Re: Gtk2::Assistant and Button Access)
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(). ___ gtk-perl-list mailing list gtk-perl-list@gnome.org http://mail.gnome.org/mailman/listinfo/gtk-perl-list
Re: Gtk2::Assistant and Button Access
I think the documentation should be included in the distribution. The Catalyst notion of packaging the main docs in a separate Catalyst::Manual distribution seems to work fairly well. CPAN can link between distributions. Just a thought, Dave ___ gtk-perl-list mailing list gtk-perl-list@gnome.org http://mail.gnome.org/mailman/listinfo/gtk-perl-list
Re: Gtk2::Assistant and Button Access
Jeff Hallock jhall...@wbanda.com writes: But never documented - http://gtk2-perl.sourceforge.net/doc/pod/Gtk2/Assistant.html That page looks a bit old, maybe it needs to be regenerated. ___ gtk-perl-list mailing list gtk-perl-list@gnome.org http://mail.gnome.org/mailman/listinfo/gtk-perl-list
Re: Gtk2::Assistant and Button Access
On Wed, Nov 25, 2009 at 2:24 PM, Kevin Ryde use...@zip.com.au wrote: Jeff Hallock jhall...@wbanda.com writes: But never documented - http://gtk2-perl.sourceforge.net/doc/pod/Gtk2/Assistant.html That page looks a bit old, maybe it needs to be regenerated. webmaster hatYes, the web docs need to be regenerated. I have the tools and the technology to do it, just not the time so far. Maybe this weekend./webmaster hat Thanks, Brian ___ gtk-perl-list mailing list gtk-perl-list@gnome.org http://mail.gnome.org/mailman/listinfo/gtk-perl-list
Re: Gtk2::Assistant and Button Access
webmaster hatYes, the web docs need to be regenerated. I have the tools and the technology to do it, just not the time so far. Maybe this weekend./webmaster hat Thanks, Would it be possible to have a tarball of all the documentation for offline viewing once they've been regenerated? I'm pretty sure it's been requested before, but I can't remember what the answer was... That would be very useful! Thanks, Dave ___ gtk-perl-list mailing list gtk-perl-list@gnome.org http://mail.gnome.org/mailman/listinfo/gtk-perl-list
Re: Gtk2::Assistant and Button Access
On Wed, Nov 25, 2009 at 2:41 PM, Dave M dave.n...@gmail.com wrote: Would it be possible to have a tarball of all the documentation for offline viewing once they've been regenerated? I'm pretty sure it's been requested before, but I can't remember what the answer was... That would be very useful! (Apologies to Dave for the double post) I can make that happen too. Thanks, Brian ___ gtk-perl-list mailing list gtk-perl-list@gnome.org http://mail.gnome.org/mailman/listinfo/gtk-perl-list
Re: Gtk2::Assistant and Button Access
Dave M dave.n...@gmail.com writes: Would it be possible to have a tarball of all the documentation for offline viewing once they've been regenerated? It all should be installed etc when building. (Debian and others might put it in a separate package which is fine though.) It'd be tempting to put .pod files in the main source dist so they show up on cpan.org. It'd badly bloat the dist but would make them visible to anyone just nosing around ... ___ gtk-perl-list mailing list gtk-perl-list@gnome.org http://mail.gnome.org/mailman/listinfo/gtk-perl-list
Re: Gtk2::Assistant and Button Access
Jeffrey Ray jeff...@jeffreyray.info writes: perldoc Gtk2::xxx Umm, I think that's supposed to work, once installed. find documentation for a module on CPAN. But yes, that's not there. ___ gtk-perl-list mailing list gtk-perl-list@gnome.org http://mail.gnome.org/mailman/listinfo/gtk-perl-list
Re: Gtk2::Assistant and Button Access
Kevin Ryde wrote: Jeffrey Ray jeff...@jeffreyray.info writes: perldoc Gtk2::xxx Umm, I think that's supposed to work, once installed. find documentation for a module on CPAN. But yes, that's not there. perldoc Gtk2::xxx Umm, I think that's supposed to work, once installed. Doesn't on my system - I'm running camelbox on vista. ___ gtk-perl-list mailing list gtk-perl-list@gnome.org http://mail.gnome.org/mailman/listinfo/gtk-perl-list
Re: Gtk2::Assistant and Button Access
On Wed, Nov 25, 2009 at 3:52 PM, Jeffrey Ray jeff...@jeffreyray.info wrote: perldoc Gtk2::xxx Doesn't on my system - I'm running camelbox on vista. http://camelbox.googlegroups.com/web/perldoc-gtk2-api.jpg?hl=engsc=6XQSUgsAAABz_T2L9K6tnZtih08cYtb0 Maybe there's something special about Vista and cmd.exe that's preventing this from working. perldoc is just a Perl script that has been batch-ified so it will run under Windows. Unfortunately, I don't have a Vista system to test on to see why it may or may not be working. Thanks, Brian ___ gtk-perl-list mailing list gtk-perl-list@gnome.org http://mail.gnome.org/mailman/listinfo/gtk-perl-list
Re: Gtk2::Assistant and Button Access
Brian Manning wrote: On Wed, Nov 25, 2009 at 3:52 PM, Jeffrey Ray jeff...@jeffreyray.info wrote: perldoc Gtk2::xxx Doesn't on my system - I'm running camelbox on vista. http://camelbox.googlegroups.com/web/perldoc-gtk2-api.jpg?hl=engsc=6XQSUgsAAABz_T2L9K6tnZtih08cYtb0 Maybe there's something special about Vista and cmd.exe that's preventing this from working. perldoc is just a Perl script that has been batch-ified so it will run under Windows. Unfortunately, I don't have a Vista system to test on to see why it may or may not be working. Thanks, Brian No virus found in this incoming message. Checked by AVG - www.avg.com Version: 9.0.709 / Virus Database: 270.14.83/2526 - Release Date: 11/25/09 14:43:00 Yes, I can do that too. In fact all of these ones http://search.cpan.org/~tsch/Gtk2-1.221/ as well. perldoc is working fine on my system. What I was saying here: 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 ___ gtk-perl-list mailing list gtk-perl-list@gnome.org http://mail.gnome.org/mailman/listinfo/gtk-perl-list
Gtk2::Assistant and Button Access
How to remove a button from the assistant: It took me a while - but I figured it out. I wanted to remove the 'Last' button from a Gtk2::Assistant - and couldn't figure out how to get access to the buttons. I found this http://old.nabble.com/Gtk2%3A%3AAssistant%3A-Access-to-Buttons-td11415772.html#a11415772 The accessors were added - http://cpansearch.perl.org/src/TSCH/Gtk2-1.180/NEWS But never documented - http://gtk2-perl.sourceforge.net/doc/pod/Gtk2/Assistant.html Is there someplace else I should be looking? The accessors are get_*button-name*_button So: $assistant-get_next_button $assistant-get_last_button $assistant-get_previous_button $assistant-get_close_button ... Hope this helps. -Jeff ___ gtk-perl-list mailing list gtk-perl-list@gnome.org http://mail.gnome.org/mailman/listinfo/gtk-perl-list