Path: csiph.com!usenet.pasdenom.info!news.albasani.net!newsreader4.netcologne.de!news.netcologne.de!feeds.phibee-telecom.net!newsfeed.xs4all.nl!newsfeed4a.news.xs4all.nl!xs4all!post.news.xs4all.nl!not-for-mail
Return-Path: <python-python-list@m.gmane.org>
X-Original-To: python-list@python.org
Delivered-To: python-list@mail.python.org
X-Spam-Status: OK 0.036
X-Spam-Evidence: '*H*': 0.93; '*S*': 0.00; 'received:80.91': 0.09; 'received:80.91.229': 0.09; 'received:gmane.org': 0.09; 'received:list': 0.09; 'subject:skip:c 10': 0.09; 'dict': 0.16; 'received:80.91.229.3': 0.16; 'received:plane.gmane.org': 0.16; 'types,': 0.16; 'library': 0.18; 'issue.': 0.22; 'header:X -Complaints-To:1': 0.27; 'raise': 0.29; 'location,': 0.31; 'url:python': 0.33; 'checking': 0.33; 'updated': 0.34; 'but': 0.35; 'explains': 0.36; 'format.': 0.36; 'shows': 0.36; 'subject:?': 0.36; 'url:org': 0.36; 'should': 0.36; 'turn': 0.37; 'mapping': 0.38; 'url:library': 0.38; 'to:addr:python-list': 0.38; 'to:addr:python.org': 0.39; 'received:org': 0.40; 'url:3': 0.61; 'first': 0.61; 'information': 0.63; 'here': 0.66; 'frank': 0.68; 'obvious': 0.74
X-Injected-Via-Gmane: http://gmane.org/
To: python-list@python.org
From: "Frank Millman" <frank@chagford.com>
Subject: Dict comprehensions - improvement to docs?
Date: Mon, 16 Mar 2015 07:25:40 +0200
X-Gmane-NNTP-Posting-Host: 197.89.15.108
X-MSMail-Priority: Normal
X-Newsreader: Microsoft Outlook Express 6.00.3790.4657
X-RFC2646: Format=Flowed; Original
X-MimeOLE: Produced By Microsoft MimeOLE V6.00.3790.4913
X-BeenThere: python-list@python.org
X-Mailman-Version: 2.1.19
Precedence: list
List-Id: General discussion list for the Python programming language <python-list.python.org>
List-Unsubscribe: <https://mail.python.org/mailman/options/python-list>, <mailto:python-list-request@python.org?subject=unsubscribe>
List-Archive: <http://mail.python.org/pipermail/python-list/>
List-Post: <mailto:python-list@python.org>
List-Help: <mailto:python-list-request@python.org?subject=help>
List-Subscribe: <https://mail.python.org/mailman/listinfo/python-list>, <mailto:python-list-request@python.org?subject=subscribe>
Newsgroups: comp.lang.python
Message-ID: <mailman.410.1426483550.21433.python-list@python.org>
Lines: 26
NNTP-Posting-Host: 2001:888:2000:d::a6
X-Trace: 1426483550 news.xs4all.nl 2830 [2001:888:2000:d::a6]:44652
X-Complaints-To: abuse@xs4all.nl
Xref: csiph.com comp.lang.python:87505

Hi all

I like dict comprehensions, but I don't use them very often, so when I do I 
need to look up the format.

I always struggle to find the information in the Library Reference. The 
obvious location, Mapping Types, shows various constructors, but not the 
comprehension.

https://docs.python.org/3/library/stdtypes.html#mapping-types-dict

So I turn to Google. It shows a couple of StackOverflow questions, and then 
a link to the Data Structures section of the Tutorial, which explains it 
succinctly.

https://docs.python.org/3/tutorial/datastructures.html#dictionaries

I feel that the Library Reference should be updated to include dict 
comprehensions.

Just checking here first before I raise a Documentation issue.

Frank Millman