Re: Initial notes

Angel Faus wrote:

>>Should start small.  No tutorials until docs & tests are done.  No
>>working on A3 until A2 behaviors are *locked*, to whatever extent that
>>proves possible.
>>
>>Comments?
>>
>>    
>>
>
>I think that the best way would be to create an schema of a language manual,
>and fill the documents as we proceed reviewing the Apocalypses.
>
>Something like this:
>
>Section 1 - Language Reference
>     - Variables
>     - Operators
>     - Control flow
>     - Subroutines
>     - Modules
>     - Classes
>     - Exceptions
>     - Regular Expressions
>     - Extending the Perl Grammar
>
>Section 2 - Builtin Classes, Functions and Variables
>     - Built-in Classes
>     - Built-in Functions
>     - Built-in Variables
>
>Section 3 - Grammar Reference
>
>Although I am probably forgetting half a dozen language features.. Could
>someone with more taste propose a more sound structure?
>
>-angel
>
I think thats a good idea, and so, on a whim, I fleshed out your skeleton a
little bit, and tossed in a few more ideas:


Section 1 - Language Reference
     - Variables
         - Scoping
         - Default Attributes
         - Globals
         - Default Variables ($_,@_,$^a,etc)
     - Operators
         - Precedence
         - Superpositional
         - Vectorizing
     - Control flow
         - Loops
         - Continuations
         - Exceptions
     - Subroutines
         - Default Attributes
         - Default Arguments
         - Coroutines
         - Closures
         - Builtin Functions
     - Modules
         - Using Modules
         - Importing and Exporting
         - Symbol Table (%MY and %OUR)
     - Classes
         - Inheritance
         - Defining Attributes
         - Overloading Operators
         - User-Defined Operators
         - Builtin Classes
     - Regular Expressions
         - Grammars
         - perlre for Perl6
     - Possible Other Stuff I forgot.

Section 3 - Grammar Reference
     - Extending the Perl Grammar

Section 4 - Core Modules

Section 5 - Migrating from Perl 5

Section 6 - PerlFAQ

I'm sure I forgot all sorts of stuff, as this was just off the top of my 
head.