Re: Initial notes

[Joseph F. Ryan]

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.