NAME Perl6::Doc - all useful Perl 6 Docs in your command line SYNOPSIS > p6doc -h # Show p6doc help > p6doc -c # Show Table of Contents > p6doc s05 # Browse Synopsis 05 DESCRIPTION This Perl module distribution contains all the latest Perl 6 documentation and a utility called "p6doc" for viewing it. Apocalypses The document codes "A01 - A20" refer to the Perl 6 Apocalypses. Larry Wall started the Apocalypse 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 I, 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. Exegeses The document codes "E02 - E07" refer to the Perl 6 Exegeses. Damian Conway's Exegeses are extensions of each Apocalypse. Each Exegesis is built around a practical code example that applies and explains the new ideas. Synopses The document codes "S01 - S29" refer to the Perl 6 Synopses. The Synopsis documents are to be taken as the formal specification for Perl 6 implementations, while still being reference documentation for Perl 6, like I is for Perl 5. Note that while these documents are considered "formal specifications", they are still being subjected to the rigours of cross-examination through implementation. In other words, they may change slightly or radically. But the expectation is that they are "very close" to the final shape of Perl 6. Overview and FAQ These are shorter summaries about a smaller specific topic. They are written mostly by the crazy Pugs people and replacing some of the outdated Synopses that are still marked as [Draft]. Tutorial (building up) This is an community driven effort to translate the Perl 5 manpages into the shiny Perl 6 world. There are still are half way through the intro. Perl Tables Reference styled set of wiki pages made by myself. Magazine articles Helpful articles from perl.com (L) and $foo (L). See the authors name in the section L, right below. CONTENTS This is the list of documents that are currently available; a number in the column indicates the document is currently available. An asterisk next to a number means that the document is an unofficial draft written by a member of the Perl community but not approved by the Perl 6 Design Team. S01 The Ugly, the Bad, and the Good (A01) S02 Bits and Pieces (A02) (E02) S03 Operators (A03) (E03) S04 Syntax (A04) (E04) S05 Pattern Matching (A05) (E05) S06 Subroutines (A06) (E06) Formats (E07) S09 Data Structures S10 Packages S11 Modules S12 Objects (A12) S13 Overloading S16* IPC / IO / Signals S17* Concurrency Debugging (A20*) S22* CPAN Portable Perl S26 Documentation S27* Perl Culture S28* Special Names S29* Functions F01 FAQ::Captures F02 FAQ::FUD O03 Overview::Operator O04 Overview::Smartmatch O06 Overview::Subroutine O08 Overview::Variable O09 Overview::Data O12 Overview::Object O16 Overview::File T01 Tutorial perlintro M01 Report on the Perl 6 Announcement M02 What is Perl 6 ? M03 A Plan for Pugs M04 Everyday Perl 6 M05 The Beauty of Perl 6 Parameter Passing METHODS Perl6::Doc provides a class method to get the raw text of a document: my $text = Perl6::Doc->get_raw('s01'); SCRIBES These are the authors of the included docs, named in the order their work was added : * Ingy döt Net * Sam Vilain * Audrey Tang * Kirrily "Skud" Robert * Moritz Lenz * David Koenig * Jonathan Scott Duff * Phil Crow * chromatic * Mark-Jason Dominus * Herbert Breunung PACKAGING Collecting, cleaning and updating of the docs: Herbert Breunung SOURCES A couple of paragraphs from I were used for the overview. Most of the Bible docs (Apocalypses, Exegeses, Synopses) are from the official Perl development site. http://dev.perl.org/perl6/ All draft Synopses, Overview, FAQ and Tutorial pages were taken out of the Pugs SVN repository. http://svn.pugscode.org/pugs/docs/Perl6/ COPYRIGHT This Copyright applies only to the C Perl software distribution, not the documents bundled within. Copyright (c) 2007. Ingy döt Net, Herbert Breunung. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See http://www.perl.com/perl/misc/Artistic.html