Perl6::Doc - Perl 6 documentation
This distribution is documentation-only. It contains no code for you to run. Included are various Perl 5 Pod and Perl 6 Pod files describing the Perl 6 language. For a tool to read this documentation, see grok.
Currently included in this distribution:
Larry Wall started the Apocalypse (latin for revelation) series as a systematic way of answering the RFCs (Request For Comments) that started the design process for Perl 6. Each Apocalypse corresponds to a chapter in the book Programming Perl, 3rd edition, and addresses the features relating to that chapter in the book that are likely to change.
Larry addresses each relevant RFC, and gives reasons why he accepted or rejected various pieces of it. But each Apocalypse also goes beyond a simple "yes" and "no" response to attack the roots of the problems identified in the RFCs.
Note: These documents are outdated and and will not be updated to match the specification (see "Synopses").
Damian Conway's Exegeses (latin for explanation) are extensions of each Apocalypse. Each Exegesis is built around a practical code example that applies and explains the new ideas.
The Synopsis (latin for comparison) started as a fast to read diff between Perl 5 and 6. Because they are also easier to maintain, all changes of the language, that are evolving from the design process are written down here first. The Apocalypses and Exegeses are frozen as "historic documents".
In other words, these docs may change slightly or radically. But the expectation is that they are "very close" to the final shape of Perl 6.
The Synopsis documents are to be taken as the formal specification for Perl 6 implementations, while still being reference documentation for Perl 6, like Programming Perl is for Perl 5.
Note that while these documents still being subjected to the rigours of cross-examination through implementation.
These are Pod-ified versions of magazine articles about Perl 6 that have appeared in print during the design process. Take these with a grain of salt as they might not describe Perl 6 as it is now. They are mostly from http://www.perl.com and http://www.perl-magazin.de/.
A Pod-ified version of http://www.perlfoundation.org/perl6/index.cgi?perl_6_index_tablet is included.
Currently included are draft versions of perlintro and perlsyn.
As of version 0.40, this distribution has been overhauled and is no longer maintained by Herbert Breunung, who originally took it over from ingy and audreyt.
Hinrik Örn Sigurðsson, email@example.com
I'm not the author of the documentation in this distro, of course, I merely maintain this package.
All Apocalypses and Exegeses were taken from the official Perl development site: http://dev.perl.org/perl6/
All Synopese were taken from the Pugs repository: http://svn.pugscode.org/pugs/docs/Perl6/
The magazine articles are from perl.com: http://perl.com/pub/q/Article_Archive#Perl%206
This copyright applies only to the Perl6::Doc Perl software distribution, not the documents bundled within.
Copyright (c) 2009, Hinrik Örn Sigurðsson firstname.lastname@example.org.
grok is distributed under the terms of the Artistic License 2.0. For more details, see the full text of the license in the file LICENSE that came with this distribution.
These are the authors of the included docs, named in the order their work was added. This list is not exhaustive.
* Larry Wall email@example.com
* Damian Conway firstname.lastname@example.org
* Luke Palmer email@example.com
* Allison Randal firstname.lastname@example.org
* Audrey Tang email@example.com
* Ingy döt Net firstname.lastname@example.org
* Sam Vilain email@example.com
* Kirrily "Skud" Robert firstname.lastname@example.org
* Moritz Lenz email@example.com
* David Koenig firstname.lastname@example.org
* Jonathan Scott Duff email@example.com
* Phil Crow firstname.lastname@example.org
* chromatic email@example.com
* Mark-Jason Dominus firstname.lastname@example.org
* Shmarya email@example.com
* Pawel Murias firstname.lastname@example.org
* Herbert Breunung email@example.com
To install Perl6::Doc, copy and paste the appropriate command in to your terminal.
perl -MCPAN -e shell
For more information on module installation, please visit the detailed CPAN module installation guide.