Beefy Boxes and Bandwidth Generously Provided by pair Networks
Perl Monk, Perl Meditation
 
PerlMonks  

comment on

( [id://3333]=superdoc: print w/replies, xml ) Need Help??
Hi chromatic,
thanks for your work! Here are my review comments (caution: not from a native speaker):

Chapter 1:
3rd paragraph, 2nd sentence:
I find the wording (Its design goals ...) a bit complicated and hard to swallow.

4th paragraph, typo:
philsophies -> philosophies

5th paragraph in section 'Perldoc':
It describes each section of the documentation
instead of
It describes each section of documentation

1st paragraph, 2nd sentence of section 'Expressivity':
I do not understand the phrase
... inform Perl's design
I suggest
... influenced Perl's design

3rd paragraph, 1st sentence (yes, but please let this style be the absolute exception, thank you :-)

1st sentence of section 'Void, Scalar, and List Context'
The wording 'One of the axes' suggests orthogonality to me, as if there were (pure) arrays of strings as well as (pure) arrays of numbers. Since there are only arrays of scalars, I would phrase that as 'One of the aspects'.

Regarding the marked text 'Check how many other string functions this includes?' in section 'The Default Scalar Variable'; this question is answered in the book 'Effective Perl Programming', 2nd ed., on page 58

9th paragraph (Note that ...)
I suggest
must compare always two elements of its list
instead of
must process the elements of its list two at a time.

Chapter 3:
3rd sentence in section 'Variable Naming', typo
Variables
instead of
Varibles


In reply to Re: Modern Perl: The Book: The Draft by hexcoder
in thread Modern Perl: The Book: The Draft by chromatic

Title:
Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post; it's "PerlMonks-approved HTML":



  • Are you posting in the right place? Check out Where do I post X? to know for sure.
  • Posts may use any of the Perl Monks Approved HTML tags. Currently these include the following:
    <code> <a> <b> <big> <blockquote> <br /> <dd> <dl> <dt> <em> <font> <h1> <h2> <h3> <h4> <h5> <h6> <hr /> <i> <li> <nbsp> <ol> <p> <small> <strike> <strong> <sub> <sup> <table> <td> <th> <tr> <tt> <u> <ul>
  • Snippets of code should be wrapped in <code> tags not <pre> tags. In fact, <pre> tags should generally be avoided. If they must be used, extreme care should be taken to ensure that their contents do not have long lines (<70 chars), in order to prevent horizontal scrolling (and possible janitor intervention).
  • Want more info? How to link or How to display code and escape characters are good places to start.
Log In?
Username:
Password:

What's my password?
Create A New User
Domain Nodelet?
Chatterbox?
and the web crawler heard nothing...

How do I use this?Last hourOther CB clients
Other Users?
Others examining the Monastery: (6)
As of 2024-04-23 20:06 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found