☻ 唐鳳 ☺ > Perl6-Pugs > docs/Hierarchy.pod

Download:
Perl6-Pugs-6.2.13.tar.gz

Annotate this POD

CPAN RT

New  7
Open  0
View/Report Bugs
Source  

$$$ denotes the slot in which Perl 6 documents which Perl 5 did not have fit in

This tree should be cloned and then refactored/replaced/filled in for Perl 6's documentation tree.

TODO - add the =head1 NAME lines for each doc name to this tree so that everyone will know what perl{bot,othrtut,tooc} etc really means...

        perl.pod
        perldoc.pod # how to use the doc
        Toc - perltoc.pod # except different
        Deployment
                perlcompile.pod
        Tools
                perlrun.pod
                perlutil.pod
        History
                perlhist.pod
                Changes
                        perldelta.pod
                        perl5004delta.pod
                        perl5005delta.pod
                        perl561delta.pod
                        perl56delta.pod
                        perl570delta.pod
                        perl571delta.pod
                        perl572delta.pod
                        perl573delta.pod
                        perl581delta.pod
                        perl582delta.pod
                        perl583delta.pod
                        perl584delta.pod
                        perl585delta.pod
                        perl586delta.pod
                        perl58delta.pod
                Attic
                        $$$ RFCs
                        $$$ Apocalypses
                        $$$ Exegesis
        Portability
                perlport.pod
                perlebcdic.pod
                Platforms
                        perlaix.pod
                        perlamiga.pod
                        perlapollo.pod
                        perlbs2000.pod
                        perlbeos.pod
                        perlce.pod
                        perldos.pod
                        perlepoc.pod
                        perlfreebsd.pod
                        perldgux.pod
                        perlcygwin.pod
                        perlhpux.pod
                        perlhurd.pod
                        perlirix.pod
                        perlmachten.pod
                        perlmacos.pod
                        perlmacosx.pod
                        perlmint.pod
                        perlmpeix.pod
                        perlnetware.pod
                        perlos2.pod
                        perlos390.pod
                        perlos400.pod
                        perlqnx.pod
                        perlplan9.pod
                        perlsolaris.pod
                        perltru64.pod
                        perluts.pod
                        perlvmesa.pod
                        perlvms.pod
                        perlvos.pod
                        perlwin32.pod
        Internationalization
                perlcn.pod
                perljp.pod
                perlko.pod
                perltw.pod
                perllocale.pod
        API
                # these are the programmatic APIs - one layer under the language specification
                Historical
                        # these will actually be gone by Perl 6 time
                        perlapi.pod
                        perlapio.pod
                        perldebguts.pod
                        perlfilter.pod
                        perltie.pod
                        perliol.pod
                ### THE REST OF API IS A WORKING DRAFT ###
                Object Space
                        Prototype/MMD core calculus
                AST
                        The parse tree of the Perl 6 Grammar - optimized for data retention
                        The AST of Perl expressions ( the parse tree with no annotations and some simplifications - what you get from CODE { } - optimized for transformation (macro processing) )
                        The intermediate core calculus - optimized for simplicity
                The Perl 6 Grammar
                        Core rules
                                Grammatical categories & Magic Hash core defs
                                Structures and stuff (blockish things, etc)
                Prelude - Reference Implementations
                        The Standard Macros
                                Object Oriented
                                        The class metamodel, declarative syntax
                                        single method dispatch
                                Scaffolding
                                        use, etc
                                        ...
                                Misc Sugar
                                ...
                        The Standard Classes and Roles
                                Core Types ( Str, Num, Int etc )
                                Container Types ( Scalar, Array, Hash )
                                Range, etc
                                ...?
                        The Standard Functions
                                ... in modules?
                                Math
                                String
                                Data Structure Functor things
                        Control Flow Structures
                                (Gather/Take, etc)
                Resource Allocation and Reclaiming
                        Data Finalization Requirement Declarations
                        Hints # like: this will not need to be finalized until much later, or these are related, or blah blah blah - to help the GC be faster
                                Scope related
                                Data
                Debugging Hooks
                        # FIXME: model after Devel::ebug? We can get acme to do this part for us
                        Interfaces
                                http
                                command line
                                IDE hooks (the way every IDE in the world knows to talk to gdb?)
                        Programmatic Debugging & Profiling
                                Breakpoint annotations for ASTs
                                Tracing execution
                                Sandbox environments based on filters
                                ## note - try to provide enough hooks for an aspect oriented programming addon to be easy
                Rule Suppport
                        The DSL Grammar Extension
                                The grammar for the grammar sub language
                                AST
                                        The parse tree - data retention
                                        Expression tree - optimized for transformation
                                        Performance Optimized - An AST with some new node types, like Trie for alternative compilation, etc - performance only reordering/rewriting yields this
                        The Evaluator API
                                The Match object
                                Parse::Rules derived execution API
                Compiler
                        Parser
                        Linker
                        Generic Optimizers
                                Pre linktime
                                        Dead Code eliminator
                                        Constant Folder
                                        Type Annotation simplification
                                        Multimethod Specializer
                                        Lexical Scope Flattenner - express lexical storage as stack-allocation-oriented instead of heap-allocation-oriented - for values which can never leave a function
                                Post linktime
                                        Auto Closer - Analyze for oppertunistic closing of classes
                                        Type Annotation Specializer
                                        Multimethod Specializer
                                        Symbol Prebinder (lexical symbols, and closed packages)
                                        Inliner (assumes prebinding)
                        Backend Specific Optimizers
                                Parrot
                                        Branch Prediction Annotation/Guessing
                                        Code Simplificationperllexwarn.pod
        Licencing
                perlartistic.pod
                perlgpl.pod
        Tutorials
                ObjectOriented
                        perlboot.pod
                        perltooc.pod
                        perltoot.pod
                Debugging
                        perldebtut.pod
                DataStructures
                        perldsc.pod
                        perllol.pod
                Modules
                        perlmodinstall.pod # how to install
                        perlmod.pod # how to write
                        perlmodlib.pod # wtf are modules anyway
                        perlmodstyle.pod
                        perlnewmod.pod # end to end for writing
                Functions
                        perlpacktut.pod
                        perlopentut.pod
                PlatformSpecific
                        POSIX
                                perlipc.pod
                Concurrency
                        perlothrtut.pod
                        perlthrtut.pod
                Rules
                        perlre.pod
                        perlref.pod
                        perlreftut.pod
                        perlretut.pod
                Security
                        perlsec.pod
                Internationalization
                        perluniintro.pod
        Internals # this is just for the "parrot" backend
                perlembed.pod
                perlcall.pod
                perlguts.pod
                perlhack.pod
                perlintern.pod
                perlxs.pod

        FAQ
                perlfaq.pod
                perlfaq1.pod
                perlfaq2.pod
                perlfaq3.pod
                perlfaq4.pod
                perlfaq5.pod
                perlfaq6.pod
                perlfaq7.pod
                perlfaq8.pod
                perlfaq9.pod
        Overview
                perlcheat.pod
                perlintro.pod # is this really a tutorial
                System
                        POSIX
                                perlfork.pod
                ObjectOriented
                        perlbot.pod
                        perlobj.pod
                Extensibility/Internals
                        perlclib.pod
                Language
                        perlvar.pod
                        perlsub.pod
                        perldata.pod
                        perlnumber.pod
                        perlsyn.pod
                Debugging
                        perldebug.pod
                        perldiag.pod
                Builtins
                        perlop.pod
                        perlfunc.pod
                Rules
                        perlrequick.pod
                        perlreref.pod
                Misc
                        perlstyle.pod
                        perltrap.pod
        Spec
                $$$ Synopses...
                perlpod.pod
                perlpodspec.pod
                perlunicode.pod
                $$$ Type system
        Misc
                perltodo.pod
                perlbook.pod





        perldbmfilter.pod # GO AWAY!!!!!!!!!! This is incidentially an interface supported by all the storage backends of DB_File, SDBM_File, NDBM_File, GDBM_File, etc - but this is *NOT* the place
        perlform.pod # this is now a module
syntax highlighting: