Perl-Sensitive Sunglasses | |
PerlMonks |
comment on |
( [id://3333]=superdoc: print w/replies, xml ) | Need Help?? |
Comments on a portion of Chapter 6. I apologize for any formatting glitches. No need for acknowledgement. When do you hope to go to print - or, until when are you seeking feedback? 1. Which/ThatParaphrasing a styleguide I have on hand: "That" introduces a phrase that is essential to the meaning of the word it modifies, and the phrase is not set off with commas. "Which" introduces a non-essential phrase, and is set off with commas. You seem to use "which" exclusively. For example, in the following paragraph, both instances should be "that". Perl's powerful ability to manipulate text comes in part from its inclusion of a computing concept known as regular expressions. A regular expression (often shortened to regex or regexp) is a pattern which describes characteristics of a string of text. A regular expression engine interprets a pattern and applies it to strings of text to identify those which match. 2. Cross-ReferencingI would modify your cross-referencing convention slightly, by including "see" or "see also" in parens and linking to the corresponding heading (e.g. <h3>) wherever possible. Consider this text: You may use a string in other contexts, such as boolean or numeric; its contents will determine the resulting value (Coercion). Which links to this text: Unlike other languages, where a variable can hold only a particular type of value… I would prefer "(see Coercion)", linked to the <h3>Coercion heading. (Or perhaps this markup is only for print, and a moot point.) 3. FixityI suggest reorganizing this paragraph: The fixity of an operator is its position relative to its operands. The mathematic operators tend to be infix operators, where they appear between their operands. Other operators are prefix, where they appear before their operands; these tend to be unary operators, such as the prefix increment operator ++$x or the mathematical and boolean negation operators (-$x and !$x, respectively). Postfix operators appear after their operands (such as postfix increment $x++). Circumfix operators surround their operands, such as the anonymous hash and anonymous array creation operators or quoting operators ({ ... } and [ ... ] or qq{ ... }, for example). Postcircumfix operators surround some operands but follow others, as in the case of array or hash indices ($hash{ ... } and $array[ ... ], for example). To this: Fixity is an operator’s position relative to its operands: 4. First-Class?The following sentence leaves me wondering what is a "first-class entity"? Regexes are first-class entities in modern Perl when created with the qr// operator. 5. GreedinessI’d like to reorganize your Greediness section, by moving non-greedy quantifiers up; and creating a new heading for Regex Anchors.
In reply to Re: Modern Perl: The Book: The Draft
by hbm
|
|