Michael Lazzaro: # OK, let's start on the first section (calling them # "Sections", not "Chapters"). As our first experiment, we # will assume a treelike style (section 1 --> 1.1, 1.2, 1.2.1, # etc.); look at http://www.mysql.com/documentation/ for an # example of a good, detailed documentation tree.
I'm finding (as I write a perlvar/perldata-like document) that things are so interconnected that it's hard to come up with a fairly flat structure. Therefore, I'm suggesting this structure. (The first one is very fleshed-out because I've thought a lot about how to structure it.) Variables and Subroutines Basic Data Types Scalars Arrays Hashes Subroutines Variable Names Sigils The Rest Subscripting and Calling Retrieving Array Elements Individual Elements Slices Retrieving Hash Elements Individual Elements Slices Calling Subroutines Multi-Dimensional Arrays and Hashes MD Arrays MD Hashes References: Simulating Mixed MD Contexts List Contexts Array Context N-ary Context Hash Context Scalar Contexts String Context Numeric Context Boolean Context (whatever else) Context Void Context Creating A Context Implicit Ways scalar() and list() context() Detecting The Context Declaring Variables Global Lexical Declaring Subroutines Unprototyped Prototyped Typed Variables Reference Types Context Types Compact Types References Taking References Dereferencing References Testing References Why Use References? Autovivification Soft References Properties Names, Variables and Values Names Variables Values Variable and Value Properties Variable Properties Value Properties Tainting Reference: Reference Types Reference: Context Types Reference: Compact Types Reference: Variable Properties Subroutines Scalars, Arrays and Hashes Reference: Value Properties Operators and Built-In Functions Expressions and Statements Operators Unary Binary Hyper-Operators Built-In Functions Pattern Matching Modules and Classes Modules Classes Grammars Standard Library Pragmas IO ... --Brent Dax <[EMAIL PROTECTED]> @roles=map {"Parrot $_"} qw(embedding regexen Configure) Wire telegraph is a kind of a very, very long cat. You pull his tail in New York and his head is meowing in Los Angeles. And radio operates exactly the same way. The only difference is that there is no cat. --Albert Einstein (explaining radio)