Thanks Rob,

I agree.  Your suggestion is the better way.

Colin W.

On 19/07/2013 11:09 AM, numpy-discussion-request@scipy.org wrote:
1. Today's Topics: 1. Re: User Guide (Rob Clewley)

[snip]

 Message: 1 Date: Thu, 18 Jul 2013 18:21:24 -0400 From: Rob Clewley <rob.clewley@gmail.com> Subject: Re: [Numpy-discussion] User Guide To: Discussion of Numerical Python <numpy-discussion@scipy.org> Message-ID: <CA+7tCySr-Cf7yNMpBnj+bL69Q1+NXsjqrP2W6XhyoObg57c_-Q@mail.gmail.com> Content-Type: text/plain; charset=ISO-8859-1 Hi, I see the desire for stylistic improvement by removing the awkward parens but your correction has incorrect grammar. One cannot have "arrays of Python," nor are Numpy objects a subset of "Python" (because Python is not a set) -- both of which are what your sentence technically states. I.e., the commas are in the wrong place. You could say "The exception: one can have arrays of python objects (including those from numpy) thereby allowing for arrays of different sized elements." but I think it is even clear to just unpack this a bit more with "The exception: one can have arrays of python objects, including numpy objects, which allows arrays to contain different sized elements." In my experience, attempting to be extremely concise in technical writing is a common cause of awkward grammar problems like this. I do it all the time :)

 -Rob On Thu, Jul 18, 2013 at 9:18 AM, Colin J. Williams <cjwilliams43@gmail.com> wrote: 
Returning to numpy after a while away, I'm impressed with the style and
content of the User Guide and the Reference.  This is to offer a Guide
correction - I couldn't figure out how to offer the correction on-line.

What is Numpy?


Suggest:

"The exception: one can have arrays of (Python, including NumPy) objects,
thereby allowing for arrays of different sized elements."

to:

The exception: one can have arrays of Python, including NumPy objects,
thereby allowing for arrays of different sized elements.

Colin W.

_______________________________________________
NumPy-Discussion mailing list
NumPy-Discussion@scipy.org
http://mail.scipy.org/mailman/listinfo/numpy-discussion