Re: Initial notes

On Sat, Nov 09, 2002 at 04:49:42PM -0500, Joseph F. Ryan wrote:
> Angel Faus wrote:
>> 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)

Topic needs to go somewhere but can we talk about it here without
mentioning anything that sets up a topic?  We need to talk about
references and dereferencing.  perl 6 will do a lot of dereferencing
automatically but we still need to explain what's going on. 

>     - Operators
>         - Precedence
>         - Superpositional

These are now called Junks (From Junctions)

>         - Vectorizing

Smart match (not sure if it belongs here we really need to have
mentioned Regexps before we cover it in depth).

>     - Control flow
>         - Loops
>         - Continuations
>         - Exceptions

if, unless, given, when, try, and all the new BLOCK thingies (PRE, POST,
LAST etc.)  

>     - 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.

Input/Output
Filehandles
Dirhandles
IPC (threads & forks)

> 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.

andrew
-- 
Cancer: (June 22 - July 22)
Someday, you'll look back on all of this and laugh very, very bitterly.

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.6 (GNU/Linux)
Comment: For info see http://www.gnupg.org

iD8DBQE9zYsU4x3z39L355MRAkYKAKCmxq0ff1YMiPjBdH+AYK2XExKA5QCfaJkU
4UnEzeOMeyf6cm31mfFVLFg=
=D3bf
-----END PGP SIGNATURE-----