[issue23984] Documentation error: Descriptors

Change by Raymond Hettinger : -- stage: patch review -> resolved status: open -> closed ___ Python tracker ___ ___ Python-bugs-list

[issue23984] Documentation error: Descriptors

Irit Katriel added the comment: This seems complete, can it be closed? -- nosy: +iritkatriel ___ Python tracker ___ ___

[issue23984] Documentation error: Descriptors

Raymond Hettinger added the comment: New changeset cb2d71b28e5cac04bbd59b8b6dbec220c4da7beb by Raymond Hettinger (Miss Islington (bot)) in branch '3.7': bpo-23984: Improve descriptor documentation (GH-1034) (GH-12459)

[issue23984] Documentation error: Descriptors

Change by miss-islington : -- pull_requests: +12412 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue23984] Documentation error: Descriptors

miss-islington added the comment: New changeset abbdd1fc5c2017683da8d2ed3e8843e8c159bc8c by Miss Islington (bot) (Shubham Aggarwal) in branch 'master': bpo-23984: Improve descriptor documentation (GH-1034) https://github.com/python/cpython/commit/abbdd1fc5c2017683da8d2ed3e8843e8c159bc8c

[issue23984] Documentation error: Descriptors

Raymond Hettinger added the comment: FWIW, I'm in the middle of a major update to this howto add will address this example there. -- resolution: -> postponed ___ Python tracker

[issue23984] Documentation error: Descriptors

Cheryl Sabella added the comment: @carlbordum, thank you for the PR, but the original PR already addresses the issues. In a code review message on that PR (https://github.com/python/cpython/pull/1034#pullrequestreview-32006381), @rhettinger commented on the removal of the print statement

[issue23984] Documentation error: Descriptors

Carl Bordum Hansen added the comment: I submitted a PR that addresses this and the next example, which also uses print unnecessarily. To answer your last comment rhettinger; the preceding text tells you /why/ one might want to use a staticmethod: """ Good candidates for static methods are

[issue23984] Documentation error: Descriptors

Change by Carl Bordum Hansen : -- keywords: +patch pull_requests: +12356 stage: -> patch review ___ Python tracker ___ ___

[issue23984] Documentation error: Descriptors

Changes by Roundup Robot : -- pull_requests: +1189 ___ Python tracker ___

[issue23984] Documentation error: Descriptors

Changes by Raymond Hettinger raymond.hettin...@gmail.com: -- assignee: docs@python - rhettinger ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue23984 ___

[issue23984] Documentation error: Descriptors

Raymond Hettinger added the comment: In addition to being broken, the code is a crummy example that gives no hint of why one might want to use a staticmethod. -- ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue23984

[issue23984] Documentation error: Descriptors

New submission from bjonnh: in https://docs.python.org/3.5/howto/descriptor.html#static-methods-and-class-methods (same problem in all python 3.x documentations) There is this example where the return of f function is printed and there is already a print in the function: class E(object):

[issue23984] Documentation error: Descriptors

Changes by Ned Deily n...@acm.org: -- nosy: +rhettinger versions: +Python 2.7 -Python 3.2, Python 3.3, Python 3.6 ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue23984 ___