[NumPy-Tickets] [NumPy] #1745: Documentation of ndarray.clip is misleading

[NumPy Trac]

#1745: Documentation of ndarray.clip is misleading
-------------------------+--------------------------------------------------
 Reporter:  rainwoodman  |       Owner:  somebody      
     Type:  defect       |      Status:  needs_decision
 Priority:  normal       |   Milestone:  Unscheduled   
Component:  numpy.core   |     Version:  1.5.1         
 Keywords:               |  
-------------------------+--------------------------------------------------

Comment(by rgommers):

 Not sure I follow you there. The signatures are
 {{{
 a.clip(min, max)
 np.clip(a, a_min, a_max)
 }}}
 so there is nothing to interchange. For the method the doc needs fixing,
 for the function the arguments need to be renamed. Although now that I
 think of it, maybe this was done on purpose because the function is
 written in Python and could clash with the builtins min/max. The method is
 written in C and therefore doesn't have this issue.

-- 
Ticket URL: <http://projects.scipy.org/numpy/ticket/1745#comment:5>
NumPy <http://projects.scipy.org/numpy>
My example project