Download full perl documentation?

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

Replies are listed 'Best First'.
Re: Download full perl documentation? by haj (Vicar) on Nov 25, 2023 at 08:50 UTC
Debian and derived systems issue the message "`You need to install the perl-doc package`". On these systems, the package is called `perl-doc` and can be installed with `sudo apt install perl-doc`. This package includes the `perldoc` command, the POD files, and the manpages for Perl documentation. If you build your own Perl, for example with perlbrew, then the `perldoc` program will be available for you, but not the manpages. So `man perldoc` won't work unless you build the man pages yourself.	[reply]
Re: Download full perl documentation? by LanX (Saint) on Nov 25, 2023 at 03:48 UTC
Please tell us which OS + version you are using and type `perldoc perldoc` or `perldoc perlvar` ...and show us what you get Cheers Rolf _{(addicted to the Perl Programming Language :) see Wikisyntax for the Monastery}	[reply] [d/l] [select]
Re: Download full perl documentation? by hippo (Archbishop) on Nov 25, 2023 at 11:02 UTC
I used to be able to see essentially this page by typing, at the bash prompt, something like 'man perlvar'. Works for me: $ man perlvar \| head PERLVAR(1) Perl Programmers Reference Guide PE +RLVAR(1) NAME perlvar - Perl predefined variables DESCRIPTION The Syntax of Variable Names Variable names in Perl can have several formats. Usually, they + must begin with a letter or underscore, in which case they can be arbitrarily long (up to an internal limit of 251 characters) an +d may $ [download] I suspect that you have installed some subset of perl using your OS package manager. Please refer to your OS instructions for how to install the full perl distribution, including the docs. 🦛	[reply] [d/l]
Re: Download full perl documentation? by gnosti (Chaplain) on Nov 26, 2023 at 01:11 UTC
The perl-doc package has been part of the Debian ecosystem for many years, so if you're not seeing it with the commands you tried, you have some problem in your configuration. Make sure you have the correct settings in /etc/apt/sources.list or /etc/apt/sources.list.d, and update your package listings with apt-get update or similar. I would expect you to answer the questions about your OS flavor and version.	[reply]
Re: Download full perl documentation? by Polyglot (Chaplain) on Nov 26, 2023 at 12:35 UTC
Interestingly, I just installed perl-doc on my Ubuntu system a few weeks ago, and the process was rather straightforward, as seen copied from the terminal: # perldoc Test::More You need to install the perl-doc package to use this program. # apt install perl-doc Reading package lists... Done Building dependency tree... Done Reading state information... Done The following NEW packages will be installed: perl-doc 0 upgraded, 1 newly installed, 0 to remove and 91 not upgraded. Need to get 7,819 kB of archives. After this operation, 15.2 MB of additional disk space will be used. Get:1 http://th.archive.ubuntu.com/ubuntu jammy-updates/main amd64 per +l-doc all 5.34.0-3ubuntu1.2 [7,819 kB] Fetched 7,819 kB in 1s (6,704 kB/s) Selecting previously unselected package perl-doc. (Reading database ... 414805 files and directories currently installed +.) Preparing to unpack .../perl-doc_5.34.0-3ubuntu1.2_all.deb ... Adding 'diversion of /usr/bin/perldoc to /usr/bin/perldoc.stub by perl +-doc' Unpacking perl-doc (5.34.0-3ubuntu1.2) ... Setting up perl-doc (5.34.0-3ubuntu1.2) ... Processing triggers for man-db (2.10.2-1) ... Scanning processes... + + Scanning candidates... + + Scanning linux images... + + Restarting services... /etc/needrestart/restart.d/systemd-manager systemctl restart packagekit.service ssh.service systemd-journald.ser +vice systemd-networkd.service systemd-resolved.service systemd-timesy +ncd.service systemd-udevd.service udisks2.service upower.service Service restarts being deferred: /etc/needrestart/restart.d/dbus.service systemctl restart getty@tty1.service systemctl restart networkd-dispatcher.service systemctl restart systemd-logind.service systemctl restart unattended-upgrades.service systemctl restart user@1000.service No containers need to be restarted. No user sessions are running outdated binaries. No VM guests are running outdated hypervisor (qemu) binaries on this h +ost. [download] I would wonder, if you cannot find the perl-doc package, if perhaps your repositories are incorrectly setup and/or your network connection has some issues. What exactly did the error message say? You might also check if issuing a command like: `# apt-cache search perl-doc` [download] ...nets anything useful. It should show up in the list, e.g.: `# apt-cache search perl-doc perl-base - minimal Perl system perl-doc - Perl documentation libgdal-perl-doc - Documentation for the GDAL Perl bindings libhtml-mason-perl-doc - HTML::Mason examples libsbml5-perl-doc - System Biology Markup Language library -- Perl doc +umentation perl-doc-html - Perl documentation suitable for viewing with a web bro +wser w3m-el - simple Emacs interface of w3m w3m-el-snapshot - simple Emacs interface of w3m (development version)` [download] Blessings, ~Polyglot~	[reply] [d/l] [select]