public
Description: Modern Perl: the book
Homepage: http://www.modernperlbooks.com/
Clone URL: git://github.com/chromatic/modern_perl_book.git
chromatic (author)
Thu Nov 05 17:02:02 -0800 2009
commit  891539ec9e24ddd437252045999230edde50281f
tree    b2e35496116ce180521c31f5864888111f3d456f
parent  2cab6da9205f76cdf4b2da90d7ada07be602aada
name age message
file CREDITS Thu Nov 05 17:02:02 -0800 2009 Added Jeremiah Foster to CREDITS. [chromatic]
file README Fri Oct 09 00:54:42 -0700 2009 [build] Expanded instructions for building chap... [chromatic]
directory build/ Fri Oct 09 00:54:42 -0700 2009 [build] Expanded instructions for building chap... [chromatic]
file outline.pod Mon Oct 26 18:51:20 -0700 2009 Updated outline with recent changes. [chromatic]
directory sections/ Loading commit data...
README
What is Modern Perl?
--------------------

Perl is a popular, powerful, and widely used programming language.  Over its
twenty year lifespan, it's powered millions of systems worldwide, moving
trillions of dollars.  More importantly, it's helped countless people get their
work done effectively.

The Perl community has a reputation for clever solutions -- and a reputation
for institutional knowledge that isn't always clear to novices and neophytes.
Modern Perl, written with this knowledge, can be very clean, very maintainable,
and even more powerful than you imagine.

That knowledge should be available to everyone.  This book will teach you how
to program Perl, but it will also teach you how to *think* about Perl, so that
you can use it to your full advantage.

http://www.modernperlbooks.com/mt/2009/01/why-modern-perl.html


Building this Book
------------------

You need a modern version of Perl installed.  I recommend Perl 5.10.1, but
anything newer than 5.8.6 should work.

You should also have Pod::PseudoPod installed with its dependencies.

From the top level directory of a checkout, build the individual chapters with:

    $ perl build/tools/build_chapters.pl

The chapter sources are in the sections/ directory.  Each chapter has a
corresponding chapter_nn.pod file.  Each file contains multiple POD links which
refer to other files in the sections/ directory.  Each of those files contains
a PseudoPOD Z<> anchor.

The build_chapters.pl program weaves these sections into chapters and writes
them to POD files in build/chapters.

(This process makes it easy to rearrange sections within and between chapters
without generating huge textual diffs.)

To build HTML from these woven chapters:

    $ perl build/tools/build_html.pl

This will produce nicely-formatted HTML in the build/html/ directory.  If
anything looks wrong, it's a mistake on my part (or a CSS problem) and patches
are very welcome.


Contributing to Modern Perl
---------------------------

For now, this draft work is licensed under a Creative Commons
Attribution-Noncommercial-No Derivative Works 3.0 United States License.  For
more details, see:

    http://creativecommons.org/licenses/by-nc-nd/3.0/us/

Please feel free to point people to this repository.  Suggestions and
contributions are welcome.  Please do not redistribute with modifications
(forking with Git is fine, but I request that you send me patches or pull
requests).

This book will be available under a less restrictive license when it comes out
in print from Onyx Neon Press:

    http://www.onyxneon.com/