[Python-Dev] feeble attempt at list comprehensions doc...

[Skip Montanaro]

--R/cQMyfgKa
Content-Type: text/plain; charset=us-ascii
Content-Description: message body and .signature
Content-Transfer-Encoding: 7bit


Attached to this message are two patches, one for Doc/ref/ref5.tex and one
for Doc/tut/tut.tex.  They provide minimal documentation for list
comprehensions.  I'm sure just about anyone else could do better.  Feel free 
to embellish.

The BNF used in the reference manual doesn't seem to match the BNF in the
Grammar file very well, so I'm not even certain I have the correct BNF or
have it in the correct place.  In particular, I'm pretty sure the
BNF for list_for and list_if are incorrect.

-- 
Skip Montanaro, skip@mojam.com, http://www.mojam.com/, http://www.musi-cal.com/
On June 24th at 8AM, live your life for an hour as Ricky Byrdsong always lived
his - run/walk in the Ricky Byrdsong Memorial 5K or just make a donation:
    https://www.SignmeupSports.com/Events/Index_Events.asp?EventID=1395


--R/cQMyfgKa
Content-Type: application/octet-stream
Content-Description: list comprehension diffs
Content-Disposition: attachment;
	filename="tut.diff"
Content-Transfer-Encoding: base64

KioqIC90bXAvdHV0LnRleC5+MS4xMDd+CVR1ZSBKdW4gMjAgMjM6MjY6MzggMjAwMAotLS0g
L3RtcC90dXQudGV4CVR1ZSBKdW4gMjAgMjM6MjY6MzggMjAwMAoqKioqKioqKioqKioqKioK
KioqIDE3NTIsMTc1NyAqKioqCi0tLSAxNzUyLDE3NzggLS0tLQogIDAKICBcZW5ke3ZlcmJh
dGltfQogIAorIFxzdWJzZWN0aW9ue0xpc3QgQ29tcHJlaGVuc2lvbnN9CisgCisgTGlzdCBj
b21wcmVoZW5zaW9ucyBwcm92aWRlIGEgY29uY2lzZSB3YXkgdG8gY3JlYXRlIGxpc3RzIHdp
dGhvdXQgcmVzb3J0aW5nCisgdG8gdXNlIG9mIHRoZSBcZnVuY3ttYXAoKX0gb3IgXGZ1bmN7
ZmlsdGVyKCl9IGZ1bmN0aW9ucy4gIFRoZSByZXN1bHRpbmcKKyBjb25zdHJ1Y3QgdGVuZHMg
b2Z0ZW4gdG8gYmUgY2xlYXJlciB0aGFuIHVzZSBvZiB0aG9zZSBmdW5jdGlvbnMuCisgCisg
XGJlZ2lue3ZlcmJhdGltfQorID4+PiBzcGNzID0gWyIgIEFwcGxlIiwgIiBCYW5hbmEgIiwg
IkNvY28gIG51dCAgIl0KKyA+Pj4gcHJpbnQgW3Muc3RyaXAoKSBmb3IgcyBpbiBzcGNzXQor
IFsnQXBwbGUnLCAnQmFuYW5hJywgJ0NvY28gIG51dCddCisgPj4+IHZlYyA9IFsyLCA0LCA2
XQorID4+PiBwcmludCBbMyp4IGZvciB4IGluIHZlY10KKyBbNiwgMTIsIDE4XQorID4+PiB2
ZWMxID0gWzIsIDQsIDZdCisgPj4+IHZlYzIgPSBbNCwgMywgLTldCisgPj4+IHByaW50IFt4
KnkgZm9yIHggaW4gdmVjMSBmb3IgeSBpbiB2ZWMyXQorIFs4LCA2LCAtMTgsIDE2LCAxMiwg
LTM2LCAyNCwgMTgsIC01NF0KKyA+Pj4gcHJpbnQgW3greSBmb3IgeCBpbiB2ZWMxIGZvciB5
IGluIHZlYzJdCisgWzYsIDUsIC03LCA4LCA3LCAtNSwgMTAsIDksIC0zXQorIFxlbmR7dmVy
YmF0aW19CisgCiAgXHNlY3Rpb257VGhlIFxrZXl3b3Jke2RlbH0gc3RhdGVtZW50IFxsYWJl
bHtkZWx9fQogIAogIFRoZXJlIGlzIGEgd2F5IHRvIHJlbW92ZSBhbiBpdGVtIGZyb20gYSBs
aXN0IGdpdmVuIGl0cyBpbmRleCBpbnN0ZWFkCg==

--R/cQMyfgKa
Content-Type: application/octet-stream
Content-Description: reference manual diff
Content-Disposition: attachment;
	filename="ref5.diff"
Content-Transfer-Encoding: base64

KioqIC90bXAvcmVmNS50ZXgufjEuMjl+CVR1ZSBKdW4gMjAgMjM6Mjc6MTQgMjAwMAotLS0g
L3RtcC9yZWY1LnRleAlUdWUgSnVuIDIwIDIzOjI3OjE0IDIwMDAKKioqKioqKioqKioqKioq
CioqKiAxNTIsMTY0ICoqKioKICBzcXVhcmUgYnJhY2tldHM6CiAgCiAgXGJlZ2lue3ZlcmJh
dGltfQohIGxpc3RfZGlzcGxheTogICAiWyIgW2V4cHJlc3Npb25fbGlzdF0gIl0iCiAgXGVu
ZHt2ZXJiYXRpbX0KICAKICBBIGxpc3QgZGlzcGxheSB5aWVsZHMgYSBuZXcgbGlzdCBvYmpl
Y3QuICBJZiBpdCBoYXMgbm8gZXhwcmVzc2lvbgogIGxpc3QsIHRoZSBsaXN0IG9iamVjdCBo
YXMgbm8gaXRlbXMuICBPdGhlcndpc2UsIHRoZSBlbGVtZW50cyBvZiB0aGUKICBleHByZXNz
aW9uIGxpc3QgYXJlIGV2YWx1YXRlZCBmcm9tIGxlZnQgdG8gcmlnaHQgYW5kIGluc2VydGVk
IGluIHRoZQohIGxpc3Qgb2JqZWN0IGluIHRoYXQgb3JkZXIuCiAgXG9iaW5kZXh7bGlzdH0K
ICBcaW5kZXhpaXtlbXB0eX17bGlzdH0KICAKLS0tIDE1MiwxNjkgLS0tLQogIHNxdWFyZSBi
cmFja2V0czoKICAKICBcYmVnaW57dmVyYmF0aW19CiEgbGlzdF9kaXNwbGF5OiAgICJbIiBb
ZXhwcmVzc2lvbl9saXN0IFtsaXN0X2l0ZXJdXSAiXSIKISBsaXN0X2l0ZXI6ICAgbGlzdF9m
b3IgfCBsaXN0X2lmCiEgbGlzdF9mb3I6ICAgICJmb3IiIGV4cHJlc3Npb25fbGlzdCAiaW4i
IHRlc3RsaXN0IFtsaXN0X2l0ZXJdCiEgbGlzdF9pZjogICAgICJpZiIgdGVzdCBbbGlzdF9p
dGVyXQogIFxlbmR7dmVyYmF0aW19CiAgCiAgQSBsaXN0IGRpc3BsYXkgeWllbGRzIGEgbmV3
IGxpc3Qgb2JqZWN0LiAgSWYgaXQgaGFzIG5vIGV4cHJlc3Npb24KICBsaXN0LCB0aGUgbGlz
dCBvYmplY3QgaGFzIG5vIGl0ZW1zLiAgT3RoZXJ3aXNlLCB0aGUgZWxlbWVudHMgb2YgdGhl
CiAgZXhwcmVzc2lvbiBsaXN0IGFyZSBldmFsdWF0ZWQgZnJvbSBsZWZ0IHRvIHJpZ2h0IGFu
ZCBpbnNlcnRlZCBpbiB0aGUKISBsaXN0IG9iamVjdCBpbiB0aGF0IG9yZGVyLiBMaXN0IGNv
bXByZWhlbnNpb25zIGRlZmluZSBjb25kaXRpb25hbAohIGV4cHJlc3Npb25zIHVzZWQgdG8g
ZGVmaW5lIGxpc3RzLgohIAogIFxvYmluZGV4e2xpc3R9CiAgXGluZGV4aWl7ZW1wdHl9e2xp
c3R9CiAgCg==

--R/cQMyfgKa--