[issue5061] Inadequate documentation of the built-in function open

2009-04-27 Thread Georg Brandl
Georg Brandl ge...@python.org added the comment: I've now split the mode table in two tables, one describing base modes, and one the possible modifiers. See r72000. -- resolution: - fixed status: open - closed ___ Python tracker

[issue5061] Inadequate documentation of the built-in function open

2009-01-26 Thread David W. Lambert
David W. Lambert lamber...@corning.com added the comment: (prospective, not perspective programmer) Spelling out the possibilities as suggested in Message80563 makes better sense to me than writing in words the logic handling the mode argument of the io.open function. (Perhaps there is a

[issue5061] Inadequate documentation of the built-in function open

2009-01-25 Thread Mitchell Model
New submission from Mitchell Model m...@acm.org: Documentation of the mode parameter of the built-in function open is insufficient with respect to what values are acceptable. (1) Right after the mode table, it states For binary random access, the mode 'w+b' opens and truncates the file to 0

[issue5061] Inadequate documentation of the built-in function open

2009-01-25 Thread Mitchell Model
Mitchell Model m...@acm.org added the comment: In point (2) I should have written a plain 'b' or 't' and value not valuable. Neither 't' nor 'b' can appear without a r/w/a. ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue5061

[issue5061] Inadequate documentation of the built-in function open

2009-01-25 Thread David W. Lambert
David W. Lambert lamber...@corning.com added the comment: I disagree. You propose to examine the trees but ignore the forest. The perspective programmer needs to understand what is a file. -- nosy: +LambertDW ___ Python tracker

[issue5061] Inadequate documentation of the built-in function open

2009-01-25 Thread Mitchell Model
Mitchell Model m...@acm.org added the comment: David W. Lambert lamber...@corning.com added the comment: I disagree. You propose to examine the trees but ignore the forest. The perspective programmer needs to understand what is a file. Could you be more specific about what parts of my