Though I find it amusing that you who often argue eloquently for the value of technical language are taking exception to the word "commutative", I completely agree with you that that is an awful sentence.

It is terribly overwritten, substituting rare and complex terms where simple speech would do nicely. Why not use the word "scalar" alone? Or if emphasis was desired, why not use ordinary scalar or even plain old scalar rather than the obscure word "vulgar"? Why turn the relatively clear clause ~~ is no longer commutative into a convoluted noun phrase commutivity breakage? Due to the fact that ~~ is no longer commutative... is far more specific about what has changed and avoids the awkward noun phrase entirely.

Perhaps all this seems to some like stylistic quibbling. However, programming language documentation is hard enough to read even when it is clearly and simply written. In the Perl community we are fortunate to have a fairly large number of people with right brained tendencies and strong verbal skills, more perhaps than other programming communities. Taking advantage of their insights to improve documentation can only be good for Perl.

Best, beth


In reply to Re^2: Perl 5.11.0 now available by ELISHEVA
in thread Perl 5.11.0 now available by Anonymous Monk

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



  • Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  • Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  • Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  • Please read these before you post! —
  • Posts may use any of the Perl Monks Approved HTML tags:
    a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, details, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, summary, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
  • You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
            For:     Use:
    & &amp;
    < &lt;
    > &gt;
    [ &#91;
    ] &#93;
  • Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  • See Writeup Formatting Tips and other pages linked from there for more info.