Since you don't have a C compiler, you're doomed and your vendor
should be sacrificed to the Sun gods. But that doesn't help you.
-What you need to do is get a binary version of gcc for your system
+What you need to do is get a binary version of C<gcc> for your system
first. Consult the Usenet FAQs for your operating system for
information on where to get such a binary version.
approaches are doomed to failure.
One simple way to check that things are in the right place is to print out
-the hard-coded @INC that perl looks through for libraries:
+the hard-coded C<@INC> that perl looks through for libraries:
% perl -le 'print for @INC'
If this command lists any paths that don't exist on your system, then you
may need to move the appropriate libraries to these locations, or create
-symbolic links, aliases, or shortcuts appropriately. @INC is also printed as
+symbolic links, aliases, or shortcuts appropriately. C<@INC> is also printed as
part of the output of
% perl -V
Read the F<INSTALL> file, which is part of the source distribution.
It describes in detail how to cope with most idiosyncrasies that the
-Configure script can't work around for any given system or
+C<Configure> script can't work around for any given system or
architecture.
=head2 What modules and extensions are available for Perl? What is CPAN? What does CPAN/src/... mean?
to the most frequently asked questions about CPAN including how to
become a mirror.
-CPAN/path/... is a naming convention for files available on CPAN
+C<CPAN/path/...> is a naming convention for files available on CPAN
sites. CPAN indicates the base directory of a CPAN mirror, and the
rest of the path is the path from that directory to the file. For
instance, if you're using ftp://ftp.funet.fi/pub/languages/perl/CPAN
-as your CPAN site, the file CPAN/misc/japh is downloadable as
+as your CPAN site, the file C<CPAN/misc/japh> is downloadable as
ftp://ftp.funet.fi/pub/languages/perl/CPAN/misc/japh .
Considering that, as of 2006, there are over ten thousand existing
modules in the archive, one probably exists to do nearly anything you
-can think of. Current categories under CPAN/modules/by-category/
+can think of. Current categories under C<CPAN/modules/by-category/>
include Perl core modules; development support; operating system
interfaces; networking, devices, and interprocess communication; data
type utilities; database interfaces; user interfaces; interfaces to
If you have Perl installed locally, you probably have the documentation
installed as well: type C<man perl> if you're on a system resembling Unix.
This will lead you to other important man pages, including how to set your
-$MANPATH. If you're not on a Unix system, access to the documentation
+C<$MANPATH>. If you're not on a Unix system, access to the documentation
will be different; for example, documentation might only be in HTML format. All
proper perl installations have fully-accessible documentation.
You might also try C<perldoc perl> in case your system doesn't
-have a proper man command, or it's been misinstalled. If that doesn't
-work, try looking in /usr/local/lib/perl5/pod for documentation.
+have a proper C<man> command, or it's been misinstalled. If that doesn't
+work, try looking in C</usr/local/lib/perl5/pod> for documentation.
If all else fails, consult http://perldoc.perl.org/ which has the
complete documentation in HTML and PDF format.
Writing Perl Modules for CPAN
by Sam Tregar
- ISBN 1-59059-018-X [1st edition Aug 2002]
+ ISBN 1-59059-018-X [1st edition August 2002]
http://apress.com/book/bookDisplay.html?bID=14
The Perl Cookbook
http://www.awlonline.com/
Object Oriented Perl
- Damian Conway
+ by Damian Conway
with foreword by Randal L. Schwartz
ISBN 1-884777-79-1 [1st edition August 1999]
http://www.manning.com/conway/
Data Munging with Perl
- Dave Cross
+ by Dave Cross
ISBN 1-930110-00-6 [1st edition 2001]
http://www.manning.com/cross
another language). There's also I<$foo Magazin>, a german magazine
dedicated to Perl, at ( http://www.foo-magazin.de ).
+The I<Perl-Zeitung> is a German-speaking magazine for Perl beginners
+(see http://perl-zeitung.at.tf ).
+
Magazines that frequently carry quality articles on Perl include I<The
Perl Review> ( http://www.theperlreview.com ), I<Unix Review> (
http://www.unixreview.com/ ), I<Linux Magazine> (
http://www.linuxmagazine.com/ ), and Usenix's newsletter/magazine to
-its members, I<login:> ( http://www.usenix.org/ )
+its members, I<login:> ( http://www.usenix.org/ ).
The Perl columns of Randal L. Schwartz are available on the web at
http://www.stonehenge.com/merlyn/WebTechniques/ ,
studies, announcements, contests, and much more. I<TPJ> has columns
on web development, databases, Win32 Perl, graphical programming,
regular expressions, and networking, and sponsors the Obfuscated Perl
-Contest and the Perl Poetry Contests. Beginning in November 2002, TPJ
+Contest and the Perl Poetry Contests. Beginning in November 2002, I<TPJ>
moved to a reader-supported monthly e-zine format in which subscribers
-can download issues as PDF documents. In 2006, TPJ merged with Dr.
-Dobbs Journal (online edition). To read old TPJ articles, see
+can download issues as PDF documents. In 2006, I<TPJ> merged with Dr.
+Dobbs Journal (online edition). To read old I<TPJ> articles, see
http://www.ddj.com/ .
=head2 What mailing lists are there for Perl?
-Most of the major modules (Tk, CGI, libwww-perl) have their own
+Most of the major modules (C<Tk>, C<CGI>, C<libwww-perl>) have their own
mailing lists. Consult the documentation that came with the module for
subscription information.
use the C<Module::CoreList> module. It has the information about
the modules (with their versions) included with each release of Perl.
+If C<Module::CoreList> is not installed on your system, check out
+http://perlpunks.de/corelist .
+
Every CPAN module has a bug tracker set up in RT, http://rt.cpan.org .
You can submit bugs to RT either through its web interface or by
email. To email a bug report, send it to