pod/buildtoc - Generate table of contents
This program generates a table of contents for the documentation included in the Perl core distribution. This table of contents takes two forms:
A file in Perl's Plain Old Documentation (POD) format found in the pod/ directory in the core distribution. Once Perl is installed, this file becomes accessible system-wide via perldoc perltoc.
perldoc perltoc
A shell script originally written by Tom Christiansen and Raphael Manfredi, also found in the pod/ directory, which can be used to translate Perl documentation into man pages.
This program will typically not need to be called directly by a user. Rather, it is one of the last commands invoked during make test_prep:
make test_prep
./perl -Ilib -I. -f pod/buildtoc -q
The only command-line switch is -q|--quiet, which quiets some non-critical warnings.
-q|--quiet
This program requires Porting/pod_lib.pl and makes use of several subroutines found in that file: get_pod_metadata() and pods_to_install() in particular. Consequently, any warnings or exceptions you see when this program is running may be being passed through from those subroutines. You may have to (a) examine those subroutines and/or (b) run that program from the command-line to fully understand what is causing such warnings or exceptions.
require
get_pod_metadata()
pods_to_install()
This program was introduced into the Perl 5 core distribution by Andy Dougherty, based on earlier work by Tom Christiansen. It is maintained by the Perl 5 Porters.
To install utf8, copy and paste the appropriate command in to your terminal.
cpanm
cpanm utf8
CPAN shell
perl -MCPAN -e shell install utf8
For more information on module installation, please visit the detailed CPAN module installation guide.