Re: what is perldoc local?

I guess this refers to the file perllocal.pod. A not-so-well-known feature of perldoc is that you can omit the prefix perl, so perldoc local will do the same as perldoc perllocal (unless you have a local.pod on your Perl path).

In my experience it returns a rather useless subset of installed modules - apparently only those I built myself using make install, i.e. where the module author used ExtUtils::MakeMaker. Modules I have installed with the package manager or with cpanm are not listed there.

The way how perllocal.pod is maintained explains why you won't find anything about it on https://perldoc.perl.org.

Comment on Re: what is perldoc local?

Replies are listed 'Best First'.
Re^2: what is perldoc local? by xiaoyafeng (Deacon) on Jan 11, 2024 at 07:10 UTC
very clear to me, many thanks! I am trying to improve my English skills, if you see a mistake please feel free to reply or /msg me a correction	[reply]
Re^2: what is perldoc local? by LanX (Saint) on Jan 11, 2024 at 15:24 UTC
> I guess this refers to the file perllocal.pod. Yes! `~ perldoc -l local /data/data/com.termux/files/usr/lib/perl5/5.36.0/aarch64-android/perll +ocal.pod` [download] Cheers Rolf _{(addicted to the Perl Programming Language :) see Wikisyntax for the Monastery}	[reply] [d/l]
Re^2: what is perldoc local? by Bod (Parson) on Jan 11, 2024 at 20:49 UTC
apparently only those I built myself Just for fun, I tried `perldoc local`. The first few modules it gave me are all core modules so not ones I've built myself... Archive::Tar and CPAN being the first two.	[reply] [d/l]
Re^3: what is perldoc local? by haj (Vicar) on Jan 13, 2024 at 09:09 UTC
That's ...interesting, given that `perllocal.pod` is an artifact of ExtUtils::MakeMaker. I wonder who wrote that on your machine for core modules? Or, maybe, not so interesting, but merely indicating that `perldoc local` can fail to be useful in different ways.	[reply]
Re^4: what is perldoc local? by hippo (Archbishop) on Jan 13, 2024 at 11:06 UTC
Some core modules (including Archive::Tar and CPAN) are dual-life. When those are upgraded they will be written to `perllocal.pod`. Note also that not all vendors install all core modules by default even though they should. FWIW, I have found `perllocal.pod` to be quite useful over the years. 🦛	[reply]