NAME
Perl6::Bible - Perl 6 Design Documentations
VERSION
This document describes version 0.23 of Perl6::Biblr, released December 22, 2005.
SYNOPSIS
> p6bible -h # Show p6bible help
> p6bible -c # Show Table of Contents
> p6bible s05 # Browse Synopsis 05
> p6bible 5 # Same thingDESCRIPTION
This Perl module distribution contains all the latest Perl 6 documentation and a utility called p6bible for viewing it.
Below 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)
References
S09 Data Structures
S10 Packages
S11 Modules
S12 Objects (A12)
S13 Overloading
Tied Variables
Unicode
Interprocess Communication
S17* Threads
Compiling
The Command-Line Interface
The Perl Debugger (A20*)
Internals and Externals
S22* CPAN
Security
Common Practices
Portable Perl
S26* Perl Documentation
S27* Perl Culture
S28* Special Names
S29* Functions
The Standard Perl Library
Pragmatic Modules
Standard Modules
Diagnostic ModulesNOTES
Perl 6 developers are refactoring relevant introductions, tutorials, specifications into the Perl6::Doc namespace; expect to see this module subsumed by it in the near future.
If you are interested in helping out the documentation project, please contact us on irc.freenode.net #perl6 or perl6-compiler@perl.org.
Synopses
The document codes S01 - S33 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 _Programming Perl_ 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.
Apocalypses (outdated)
The document codes A01 - A33 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 _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.
Exegeses (outdated)
The document codes E01 - E33 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.
METHODS
Perl6::Bible provides a class method to get the raw text of a document:
my $text = Perl6::Bible->get_raw('s01');SCRIBES
* Brian Ingerson <ingy@cpan.org>
* Sam Vilain <samv@cpan.org>
* Audrey Tang <autrijus@cpan.org>
COPYRIGHT
This Copyright applies only to the Perl6::Bible Perl software distribution, not the documents bundled within.
A couple of paragraphs from _Perl 6 Essentials_ were used for the overview.
Copyright (c) 2005. Brian Ingerson. 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