[issue7545] IO buffering behaviour not properly documented

Antoine Pitrou added the comment: Thank you, fixed in a lot of revisions. -- resolution: -> fixed status: open -> closed ___ Python tracker ___ _

[issue7545] IO buffering behaviour not properly documented

Pascal Chambon added the comment: Yep, I knew "full buffering" didn't mean "fill my RAM until crash" :p The only visible problem was the interpretation of positive/negative buffering value, which wasn't the same in doc and in code. But the patch seems to fix up the plot prettily well B-) Thanks

[issue7545] IO buffering behaviour not properly documented

Antoine Pitrou added the comment: Here is a possible patch for the Doc. I suppose the docstrings need updating too? -- keywords: +patch Added file: http://bugs.python.org/file15611/io-open-doc.patch ___ Python tracker

[issue7545] IO buffering behaviour not properly documented

Antoine Pitrou added the comment: > But now the question remains what the default is -- "full buffering" is > only meaningful with a specified buffer size. The implementation seems > to default to line buffering. "full" buffering actually uses a default or custom buffer size when you don't spe

[issue7545] IO buffering behaviour not properly documented

Georg Brandl added the comment: The docs have a different wording, which I suggest copying to the docstring: *buffering* is an optional integer used to set the buffering policy. By default full buffering is on. Pass 0 to switch buffering off (only allowed in binary mode), 1 to set li

[issue7545] IO buffering behaviour not properly documented

Antoine Pitrou added the comment: "Full buffering" means exactly what you discovered it means - enable a buffer of a given number of bytes (3, 4096 or anything else). I'm not sure what you thought it meant? That the file was buffered in its entirety, regardless of its size? -- nosy: +pi

[issue7545] IO buffering behaviour not properly documented

New submission from Pascal Chambon : Hello, It seems there is an important difference between the doc of the IO module, and its implementation so far (until todcay trunk revision 76805) "buffering is an optional integer used to set the buffering policy. By default full buffering is on. Pass 0 to