Gtk2-Perl POD

ait has asked for the wisdom of the Perl Monks concerning the following question:

Hello,
After an unfruitful super search on PM, google and cpan, I am obligated to ask if someone knows if there exists a CPAN module to install the POD info shown here:
Thanks,
Alejandro Imass

Update March 22nd, 2010
Thank you very much for offering your replies! Here is the mystery resolved:

First I must start by stating that I had installed the Gtk2 from the binary Debian package distribution:

libgtk2-perl - Perl interface to the 2.x series of the Gimp Toolkit library

It seems that the Debian folks decided to strip the documentation into a separate package called:

ibgtk2-perl-doc - Perl interface to the Gtk 2.x series (documentation files)

This of course I got from almut's take on the subject (see below). It also seems to me that this is a Debian decision based on the perl policy descibed here: http://www.debian.org/doc/packaging-manuals/perl-policy/ch-perl.html#s-docs

So the final answer here is that if I had installed from the CPAN shell I would have gotten the docs -no mystery there-, and that Debian's perl policy allows to separate code and docs when it comes to Perl. I guess in this case it make sense anyway because the POD source (my original question) is in the XS files, not the pm modules - duh!. Finally I want to point out that I just installed Gtk2 on FreeBSD using the CPAN shell, and the docs were installed perfectly.

Thanks again,
Alejandro Imass

Comment on Gtk2-Perl POD

Replies are listed 'Best First'.
Re: Gtk2-Perl POD by almut (Canon) on Mar 16, 2010 at 21:49 UTC
If all else fails, there's a debian package libgtk2-perl-doc which contains the `.pod` files (see filelist, if you want to check before downloading). In case you're not on a Debian based system, you can unpack `.deb` packages as follows: `# step 1 $ ar x libgtk2-perl-doc_1.221-4_all.deb` [download] This extracts 3 files, among which there is `data.tar.gz`, which you can then untar: `# step 2 $ tar xzf data.tar.gz` [download] ( `ar` and `tar` should be available on any Unix system, and even for Windows (I think) )	[reply] [d/l] [select]
Re^2: Gtk2-Perl POD by ait (Hermit) on Mar 22, 2010 at 02:19 UTC
Thank you almut. This is precisely what I was looking for! Do you know by any chance where the actual source of this doc resides? Thankfully I use Debian and FreeBSD, but how about people developing on other systems that don't want to alienate a package from another sys? I think that this POD should be available on the CPAN, the same way they are as a deb package. Do you know is there is any reason this is not so?	[reply]
Re: Gtk2-Perl POD by Khen1950fx (Canon) on Mar 16, 2010 at 19:18 UTC
If I understand your question correctly, then you should already have it. Try: `perldoc Gtk2::index` [download]	[reply] [d/l]
Re^2: Gtk2-Perl POD by ait (Hermit) on Mar 16, 2010 at 20:21 UTC
Nop. The POD is not included with the installation of Gtk2. That is precisely why I ask. I cannot find any module on CPAN or reference to this documentation and it does not seem to be included in the CPAN codo itself. So where is this POD?	[reply]
Re: Gtk2-Perl POD by ww (Archbishop) on Mar 16, 2010 at 19:20 UTC
If that's what you want, why don't you just save it to an html file? No, it wont' be well-formatted pod, though you can make it so... ... and, yes, that will make all the info in the TOC itself and in the links readily available.	[reply]
Re: Gtk2-Perl POD by Anonymous Monk on Mar 16, 2010 at 21:40 UTC
http://gtk2-perl.sourceforge.net/doc/ Updated documentation * Online Gtk2-Perl Documentation generated with Marek::Pod::HTML, using Gtk2 1.221/Glib 1.222/Pango 1.221/Cairo 1.061 checked out from the GIT repo. o Tarball of the Gtk2-Perl Documentation generated with Marek::Pod::HTML (.tar.bz2, 560k, generated 17Dec2009) * Online Gtk2-Perl Documentation generated with Pod::ProjectDocs, using Gtk2 1.221/Glib 1.222/Pango 1.221/Cairo 1.061 checked out from the GIT repo. o Tarball of the Gtk2-Perl Documentation generated with Pod::ProjectDocs (.tar.bz2, 691k, generated 17Dec2009)	[reply]
Re^2: Gtk2-Perl POD by ait (Hermit) on Mar 22, 2010 at 02:09 UTC
Yep. I saw this, but it still doesn't answer if the POD is in the CPAN. From this paragraph is one supposed to inferr where the sources of "Gtk2-Perl Documentation" is?	[reply]
Re^3: Gtk2-Perl POD by Anonymous Monk on Mar 22, 2010 at 06:41 UTC
Yep. I saw this, but it still doesn't answer if the POD is in the CPAN. From this paragraph is one supposed to inferr where the sources of "Gtk2-Perl Documentation" is? Huh? The source probably knows http://gtk2-perl.sourceforge.net/doc/Gtk2-Perl-MarekPodHTML.17Dec2009.tar.bz2 http://gtk2-perl.sourceforge.net/doc/Gtk2-Perl-PodProjDocs.17Dec2009.tar.bz2	[reply]
Re^3: Gtk2-Perl POD by Anonymous Monk on Mar 22, 2010 at 06:47 UTC
http://gtk2-perl.sourceforge.net/ Updated Gtk2-Perl docs available Sat, 19 Dec 2009 by Brian Manning Updated Gtk2-Perl documentation is now available at http://gtk2-perl.sourceforge.net/doc/. Note that there are now two different sets of documentation posted, a set generated with Marek::Pod::HTML (what's been posted on the website previously, but with some stylesheet tweaks) and another set created with Pod::ProjectDocs. Both sets can be viewed online or downloaded by browsing the Gtk2-Perl documentation page (http://gtk2-perl.sourceforge.net/doc/). Going forward, the plan is to keep the Marek::Pod::HTML-style documentation as the "official" documentation, and then move towards making all of the documentation available via the CPAN website instead of on the Gtk2-Perl website.	[reply]