Path: csiph.com!usenet.pasdenom.info!dedibox.gegeweb.org!gegeweb.eu!nntpfeed.proxad.net!proxad.net!feeder1-2.proxad.net!usenet-fr.net!nerim.net!novso.com!newsfeed.xs4all.nl!newsfeed3a.news.xs4all.nl!xs4all!newsgate.cistron.nl!newsgate.news.xs4all.nl!post.news.xs4all.nl!not-for-mail Return-Path: X-Original-To: python-list@python.org Delivered-To: python-list@mail.python.org X-Spam-Status: OK 0.046 X-Spam-Evidence: '*H*': 0.91; '*S*': 0.00; 'true,': 0.05; 'charles': 0.16; 'dict': 0.16; 'dynamic,': 0.16; 'message-id:@earthlink.net': 0.16; 'received:dsl.mindspring.com': 0.16; 'values?': 0.16; 'bit': 0.19; 'subject:request': 0.19; 'header:User-Agent:1': 0.23; 'documented': 0.24; 'pass': 0.26; 'returned': 0.30; 'such.': 0.31; 'could': 0.34; 'received:66': 0.35; 'agree': 0.35; 'but': 0.35; 'should': 0.36; 'changing': 0.37; '(i.e.,': 0.38; 'to:addr:python- list': 0.38; 'rather': 0.38; 'to:addr:python.org': 0.39; 'how': 0.40; 'read': 0.60; 'talking': 0.65; 'confusing': 0.84; 'p.s.:': 0.84 Date: Sun, 19 Jan 2014 13:26:03 -0800 From: Charles Hixson User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:17.0) Gecko/20131103 Icedove/17.0.10 MIME-Version: 1.0 To: python-list@python.org Subject: Documentation of dict views change request Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-BeenThere: python-list@python.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: General discussion list for the Python programming language List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Newsgroups: comp.lang.python Message-ID: Lines: 13 NNTP-Posting-Host: 2001:888:2000:d::a6 X-Trace: 1390166846 news.xs4all.nl 2948 [2001:888:2000:d::a6]:56586 X-Complaints-To: abuse@xs4all.nl Xref: csiph.com comp.lang.python:64326 Could it please be clearly documented that keys(), values(), and items() are not writeable. I agree that this is how they should be, but it would be still better if they were clearly documented as such. The labeling of them as dynamic, while true, was a bit confusing here. (I.e., it was talking about changing their value through other means of access rather than directly through the returned values.) P.S.: Is it reasonable to return the items() of a dict in order to pass a read only copy of the values? -- Charles Hixson