Is it just the indices parameter that's unclear, or the entire description?


On Tue, Jul 23, 2013 at 12:10 PM, seberg <notifications@github.com> wrote:

> In numpy/add_newdocs.py:
>
> > +    Performs operation in place on array for items specified by indices.
> > +    For addition ufunc, this method is equivalent to a[indices] += b,
> > +    except that results are accumulated for indices listed more than once.
> > +    This solves the problem with a[indices] += b where each time a duplicate
> > +    index is encounted, the increment is performed on the original element.
> > +    As a result, an element that appears three times in the fancy indexing
> > +    list will only be incremented once in the final result, whereas with the
> > +    new 'at' method the original element will be incremented by three in the
> > +    final result.
> > +
> > +    Parameters
> > +    ----------
> > +    a : array_like
> > +        The array to act on.
> > +    indices : array_like
> > +        Paired indices, comma separated (not colon), specifying slices to
>
> I am not sure what to write, but I honestly don't understand anything of
> this right now. It should probably say indices : array_like or tuple of
> indexing objects or even just indexing object? And maybe then just refer
> to indexing in the longer description?
>
> —
> Reply to this email directly or view it on GitHub<https://github.com/numpy/numpy/pull/2821/files#r5350518>
> .
>