@@ -31,10 +31,12 @@ L<perldoc> * Evolution happens outside the core I<on purpose>. -L<cpan> x +L<cpan> * =head2 The Perl Community +L<perl_community> x + How and where to find other people to learn and to share. =head2 The Language Itself @@ -53,7 +55,7 @@ Mostly identifiers. How they work, what's valid, and what's not. =head3 Values -L<values> x +L<values> + Strings, numbers, everything without a sigil. @@ -64,6 +66,8 @@ difference between perlop and perlfunc?). =head3 Control Flow +L<control_flow> * + Loops, jumps, and labels. Defer calling functions? Exceptions?? =head3 Variables @@ -90,11 +94,15 @@ Containers; Perl's built-in data types. =head3 Scalars +L<scalars> * + Should be simple, provided that the reference part stays put. Should mention numerification/stringification, magical auto-increment. =head3 Arrays +L<arrays> * + Make it clear that arrays and lists are very different things. Discuss distinction between indexes and length? Avoid $# altogether? (Don't have to be comprehensive, just clear.) @@ -118,6 +126,8 @@ The types of things you find in C<perldoc -f>. =head3 Context +L<context_philosophy> + This is perhaps the most important insight into Perl on its own as a language, so it belongs in a position where everyone will read it. It might need its own short chapter. @@ -146,20 +156,28 @@ operators, it might be appropriate. Certainly return context is interesting. =head3 Scope +L<scope> x + May be more appropriate conceptually before discussing parameter handling, but seems to flow better here. Difference between global and lexical. =head3 Anonymous Functions +L<anonymous_functions> (x) + Must come after references and functions. Mention typeglobs? The name doesn't matter to Perl. Any CV is invokable. =head3 Closures +L<closures> + Combines scopes, lexicals, and functions. This is the time to talk about binding and closing over. Delayed computation. Encapsulation. Abstraction. -=head2 Regular Expressions (*) +=head2 Regular Expressions + +L<regular_expressions> * This won't be a fun chapter, but it's a necessary chapter. What's the minimal I can write to be effective? @@ -277,6 +295,8 @@ earlier. =head3 Perldoc and POD +L<perldoc> * + Documentation and using the documentation. =head3 CPAN @@ -341,10 +361,14 @@ almost impossible to get right. =head3 Dative Syntax +L<indirect_objects> * + Barewords plus parsing sugar = avoid. =head3 Method/Sub Equivalence +L<method_sub_equivalence> * + The best you can do is treat them differently. =head3 Tie @@ -353,6 +377,8 @@ You may run into this. You shouldn't have to. =head3 Prototypes +L<prototypes> * + They don't work the way you think they do. =head3 Typeglobs and Reflection outline.pod a586872108df18b5b65582fe87cf7f934ed85702 chromatic chromatic@wgz.org http://github.com/chromatic/modern_perl_book/commit/d9d7b3adbfe11cbb378a583dcb01180e0cf8a19e d9d7b3adbfe11cbb378a583dcb01180e0cf8a19e

2009-10-26T18:51:20-07:00

Updated outline with recent changes. d9422064a7f94060f401b69bab10f63d2d1f8f5a chromatic chromatic@wgz.org