[issue6722] collections.namedtuple: confusing example

Raymond Hettinger added the comment: See r86650 -- resolution: -> fixed status: open -> closed versions: -Python 2.6, Python 2.7, Python 3.0, Python 3.1 ___ Python tracker ___

[issue6722] collections.namedtuple: confusing example

Changes by Éric Araujo : -- nosy: +d...@python ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.pytho

[issue6722] collections.namedtuple: confusing example

Vincent Borghi added the comment: In fact, thanks to the person (Alexey Shamrin) who created this issue (issue found while googling for "namedtuple"), I have understood the namedtuple example in the documentation. I think like him the verbose=True example that cames first is very confusing.

[issue6722] collections.namedtuple: confusing example

Changes by Raymond Hettinger : -- priority: -> low ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.

[issue6722] collections.namedtuple: confusing example

Alexey Shamrin added the comment: Roundup broke formatting... I've attached a text file with the proposed example. -- Added file: http://bugs.python.org/file14747/namedtuple_doc_example.txt ___ Python tracker _

[issue6722] collections.namedtuple: confusing example

Alexey Shamrin added the comment: Raymond, sorry if I wasn't clear. I'm fine with the API (haven't used it yet though, because I was stuck after skimming through its documentation). I suggest to make *first* example simple (without verbose=True) and to move an example with verbose=True little f

[issue6722] collections.namedtuple: confusing example

Raymond Hettinger added the comment: It seems that it is the API you don't like, not the example. What is your suggested improvement to the docs? -- assignee: georg.brandl -> rhettinger nosy: +rhettinger ___ Python tracker

[issue6722] collections.namedtuple: confusing example

New submission from Alexey Shamrin : Maybe it's just me, but it took me several attempts to understand namedtuple example in the documentation [1]. The problem is that the first example uses verbose=True. It's very unusual to get Python source as the output in Python shell. At first I thought th