[issue12195] Little documentation of annotations

2011-08-26 Thread Raymond Hettinger
Raymond Hettinger added the comment: > some simple examples showing the syntax would go a long way. Sorry, there as just too many ways to go and we are intentionally not stating which way is preferred. I've seen many variants a:[Integral] for a list of integers, a:(int,str) for a 2-tuple of

[issue12195] Little documentation of annotations

2011-08-26 Thread Éric Araujo
Changes by Éric Araujo : -- nosy: +eric.araujo ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.pyth

[issue12195] Little documentation of annotations

2011-08-12 Thread JJeffries
JJeffries added the comment: While I understand the reluctance to unintentionally push people along a particular path, but I think there is being open on how to use it and not mentioning it. I think that currently the current documentation is the latter and some simple examples showing the sy

[issue12195] Little documentation of annotations

2011-05-27 Thread Raymond Hettinger
Raymond Hettinger added the comment: We could beef this up a little bit, but it was intentional that we leave it completely open on how to use it. -- assignee: docs@python -> rhettinger nosy: +rhettinger ___ Python tracker

[issue12195] Little documentation of annotations

2011-05-27 Thread JJeffries
New submission from JJeffries : There are very few pages relating to annotations in the documentation. Making it very unclear how they work and what they could be used for other than the original PEP. -- assignee: docs@python components: Documentation messages: 137047 nosy: JJeffries,