Re: [Python-Dev] Documentation reorganization

2008-03-05 Thread Greg Ewing
Adam Olsen wrote: The term Displays is pretty obscure as well, Hmmm, I'd call them constructor expressions or some such. -- Greg ___ Python-Dev mailing list Python-Dev@python.org http://mail.python.org/mailman/listinfo/python-dev Unsubscribe:

Re: [Python-Dev] Documentation reorganization

2008-03-05 Thread Greg Ewing
Georg Brandl wrote: Adam Olsen schrieb: Another example is the use of BNF, which although dominant in its field, it provides a steep learning curve for most programmers. We could of course accompany each BNF-described item with an example. An alternative to BNF would be syntax diagrams.

[Python-Dev] Documentation reorganization [was: ... for ability to execute zipfiles directories]

2008-03-04 Thread Stephen J. Turnbull
Georg Brandl writes: You speak my mind. For ages I've wanted to put the builtins together with the language reference into a new document called Python Core Language. I've just never had the time to draft a serious proposal. I think that combination is reasonable, but I would like to see

Re: [Python-Dev] Documentation reorganization [was: ... for ability to execute zipfiles directories]

2008-03-04 Thread Adam Olsen
On Tue, Mar 4, 2008 at 3:13 PM, Stephen J. Turnbull [EMAIL PROTECTED] wrote: Georg Brandl writes: You speak my mind. For ages I've wanted to put the builtins together with the language reference into a new document called Python Core Language. I've just never had the time to draft a

Re: [Python-Dev] Documentation reorganization [was: ... for ability to execute zipfiles directories]

2008-03-04 Thread Greg Ewing
Adam Olsen wrote: Such a division would make it unnecessarily hard to find documentation on True, False, None, etc. They've become keywords for pragmatic purposes (to prevent accidental modification), not because we think they ideally should be syntax instead of builtins. Maybe the solution

Re: [Python-Dev] Documentation reorganization [was: ... for ability to execute zipfiles directories]

2008-03-04 Thread Steve Holden
Greg Ewing wrote: Adam Olsen wrote: Such a division would make it unnecessarily hard to find documentation on True, False, None, etc. They've become keywords for pragmatic purposes (to prevent accidental modification), not because we think they ideally should be syntax instead of builtins.

Re: [Python-Dev] Documentation reorganization [was: ... for ability to execute zipfiles directories]

2008-03-04 Thread Adam Olsen
On Tue, Mar 4, 2008 at 5:04 PM, Steve Holden [EMAIL PROTECTED] wrote: Greg Ewing wrote: Adam Olsen wrote: Such a division would make it unnecessarily hard to find documentation on True, False, None, etc. They've become keywords for pragmatic purposes (to prevent accidental

Re: [Python-Dev] Documentation reorganization

2008-03-04 Thread Stephen J. Turnbull
Adam Olsen writes: On Tue, Mar 4, 2008 at 3:13 PM, Stephen J. Turnbull [EMAIL PROTECTED] wrote: I would like to see the clear division between the language (ie, the syntax) and the built-in functionality maintained. I'm not sure I like the proposed title for that reason. Such

Re: [Python-Dev] Documentation reorganization

2008-03-04 Thread Adam Olsen
On Tue, Mar 4, 2008 at 8:03 PM, Stephen J. Turnbull [EMAIL PROTECTED] wrote: Adam Olsen writes: On Tue, Mar 4, 2008 at 3:13 PM, Stephen J. Turnbull [EMAIL PROTECTED] wrote: I would like to see the clear division between the language (ie, the syntax) and the built-in functionality

Re: [Python-Dev] Documentation reorganization

2008-03-04 Thread Georg Brandl
Adam Olsen schrieb: I don't pretend to be speaking for anyone else, but I'd be surprised if I were unique.wink Your experiences *shouldn't* be unique, but I'm afraid they might be. Another example is the use of BNF, which although dominant in its field, it provides a steep learning curve