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.
msg23864/pgp00000.pgp
Description: PGP signature