Hello, First of all, the OP should install the 'perl-doc' package. It alone contains the basic perl documentation of over 1000 files (including 810 manpages here). On Tue, 17 Dec 2013, Anton Aylward wrote: [..]
There isn't a index of the man pages either, you have to build it. Its done every night -- it used to be done by mkwhatis, but we're in the 21st century now. Take a look in /etc/cron.daily/suse-do_mandb
Those dbs are what apropos/man -k use. And what would you call those but an "index" of man pages? And mandb and that cronjob are part of the man package ...
That way its all covered by the MAN command and you don't have to worry if some things are dealt by perlpod and some by man
I've been using SuSE since 5.3, many times with modules from CPAN or even self-written ones, a self-compiled and not rpm-packaged perl, and thanks to pod2man there was *always* a man Foo::Bar for any module "Foo::Bar". The only exception to that rule is: man -k perl | grep ^perl That even is valid for pragmas, see 'man 3pm strict' or 'man 3pm warnings'. And your "index" goes like this: man -k . -s 3pm for which I currently get a mere 6599 entries ... (BTW: option order matters in this case: $ man -k . -s 3pm | wc -l 6599 $ man -s 3pm -k . | wc -l 33192 the latter listing all manpages or so it seems at a first glance and $ rpm -qal | grep -c /usr/share/man 32640 seems to agree as I do have some (e.g. perl) stuff not packaged as an rpm installed). Lack of documentation? There are some perl-programs in section 1 (e.g. "frozen-bubble") and probably some modules in section 3 (instead of 3pm). And for the index the op searched, how about konqueror's "man:" io-slave, just enter 'man:(3p)' into konqueror's adress bar for the index of perl documentation (well, the konq from 3.5.10 and 4.7 are both broken and list all manpages in section 3 even if specifying 3pm). But well, it's a HTML-like index of manpages ;) And then there's e.g. tkman. But do NOT forget about perldoc. Its -q, -f and -v options are extremely useful, c.f. e.g.: perldoc -v '$/' even though you could read up on that stuff in man perlfaq* perlvar perlfunc, perldoc's function is much more pratical. But generally man is faster than perldoc. -dnh, documentation fetishist -- Memory fault -- core...uh...um...core... Oh dammit, I forget! -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse+owner@opensuse.org