[Tutor] 2.7.3 documentation gripe (feel free to ignore)

Steven D'Aprano steve at pearwood.info
Fri Sep 14 11:32:34 CEST 2012


On 14/09/12 17:29, Ray Jones wrote:
>
>      6.5. The del
>      <http://docs.python.org/reference/simple_stmts.html#del>  statement
[...]
> They call this DOCUMENTATION??? "it's similar to such and such - you
> figure it out....here are the hints"!
>
> Bah! I hope their code is better than the documentation. :-p


*shrug*

Look at the size of the documentation for assignments, two and a half
pages. Deletion is almost exactly the same except there is no target on
the left hand side of the "operator".

I'm honestly not sure that there would be any advantage to spelling out
in gory detail over a page and a half how del works, but if you think the
documentation is lacking, remember that Python is an open-source project
and community input is welcome and desired.


-- 
Steven


More information about the Tutor mailing list