70 Commits

Author	SHA1	Message	Date
R David Murray	9f0c9401d3	#15694: Link discussion of file objects to glossary entry. ... This is analogous to the link for `flie objects` in the description of 'open' that exists in the 2.7 docs, and adds a similar link to the io docs. Patch by Chris Jerdonek.	2012-08-17 20:33:54 -04:00
R David Murray	ee0a945ae4	#15543: reflow paragraphs.	2012-08-15 11:05:36 -04:00
R David Murray	1b00f25bf9	#15543: glossary entry for and 'universal newlines', and links to it. ... Patch by Chris Jerdonek.	2012-08-15 10:43:58 -04:00
Georg Brandl	296d1bea6a	Restore original line lengths.	2012-08-14 09:39:07 +02:00
Andrew Svetlov	ecd78feb78	Issue #15624: clarify newline documentation for open and io.TextIOWrapper ... Thanks to Chris Jerdonek	2012-08-13 12:58:02 +03:00
Victor Stinner	401e17d0f0	open() / TextIOWrapper doc: make it explicit than newline='\n' doesn't ... translate newlines on output.	2012-08-04 01:18:56 +02:00
Antoine Pitrou	0c1c0d42dc	Make TextIOWrapper's documentation clearer by copying the newline argument's description from open().	2012-08-04 00:55:38 +02:00
Antoine Pitrou	707bd4e385	Mention the *limit* argument of TextIO.readline().	2012-07-25 22:38:33 +02:00
Antoine Pitrou	f49d152ab2	Issue #12922: fix the TextIOBase documentation to include a description of seek() and tell() methods.	2012-01-21 20:20:49 +01:00
Meador Inge	777bebb0ef	Issue #13513: IOBase docs incorrectly link to the readline module	2011-12-03 12:29:54 -06:00
Antoine Pitrou	13d2895dbf	Issue #12213: make it clear that BufferedRWPair shouldn't be called with the ... same object as reader and writer, and deemphasize it in document order.	2011-08-20 19:48:43 +02:00
Senthil Kumaran	a6bac95a3c	issue10403 - Let's not use members anymore. Use 'attribute' where it denotes attribute and 'methods' where it denotes methods. Context should clarify usage.	2011-07-04 11:28:30 -07:00
Benjamin Peterson	edf5132dfe	Merged revisions 88540-88541 via svnmerge from ... svn+ssh://pythondev@svn.python.org/python/branches/py3k ........ r88540 | benjamin.peterson | 2011-02-23 20:46:00 -0600 (Wed, 23 Feb 2011) | 1 line this seems to be pointlessly nested ........ r88541 | benjamin.peterson | 2011-02-23 20:53:05 -0600 (Wed, 23 Feb 2011) | 1 line rewrite ........	2011-02-24 03:03:46 +00:00
Antoine Pitrou	eefb97cb57	Mention that seek and tell over a TextIOWrapper can be very slow.	2011-02-04 20:11:11 +00:00
Antoine Pitrou	bed81c882b	Add an "advanced topics" section to the io doc.	2010-12-03 19:14:17 +00:00
Daniel Stutzbach	d01df46848	Fix typo: "ofbytes" should be "of bytes"	2010-11-30 17:49:53 +00:00
Georg Brandl	682d7e0e07	Fix errors found by "make suspicious".	2010-10-06 10:26:05 +00:00
Antoine Pitrou	328ec7455f	Issue #9854: The default read() implementation in io.RawIOBase now ... handles non-blocking readinto() returning None correctly.	2010-09-14 18:37:24 +00:00
Antoine Pitrou	972ee13e03	Issue #5506: BytesIO objects now have a getbuffer() method exporting a ... view of their contents without duplicating them. The view is both readable and writable.	2010-09-06 18:48:21 +00:00
Benjamin Peterson	6b4fa776ac	rewrite and move open() docs only to functions.rst	2010-08-30 13:19:53 +00:00
Antoine Pitrou	b530e1438b	Issue #9715: improve documentation of the io module	2010-08-30 12:41:00 +00:00
Georg Brandl	67b21b7547	Consistency check for versionadded/changed directives.	2010-08-17 15:07:14 +00:00
Georg Brandl	7cb1319688	Terminology fix: exceptions are raised, except in generator.throw().	2010-08-03 12:06:29 +00:00
Georg Brandl	70f355d13e	Clarify.	2010-07-19 06:52:35 +00:00
Antoine Pitrou	2016dc9ab2	Merged revisions 81594 via svnmerge from ... svn+ssh://pythondev@svn.python.org/python/trunk ........ r81594 | antoine.pitrou | 2010-05-29 14:06:13 +0200 (sam., 29 mai 2010) | 3 lines Issue #8840: Make documentation for truncate() clearer ........	2010-05-29 12:08:25 +00:00
Georg Brandl	8569e582f8	Merged revisions 80030,80067,80069,80080-80081,80084,80432-80433,80465-80470,81059,81065-81067 via svnmerge from ... svn+ssh://pythondev@svn.python.org/python/trunk ........ r80030 | georg.brandl | 2010-04-13 08:43:54 +0200 (Di, 13 Apr 2010) | 1 line Get rid of multi-row cells. ........ r80067 | georg.brandl | 2010-04-14 10:53:38 +0200 (Mi, 14 Apr 2010) | 1 line #5341: typo. ........ r80069 | georg.brandl | 2010-04-14 15:50:31 +0200 (Mi, 14 Apr 2010) | 1 line Add an x-ref to where the O_ constants are documented and move the SEEK_ constants after lseek(). ........ r80080 | georg.brandl | 2010-04-14 21:16:38 +0200 (Mi, 14 Apr 2010) | 1 line #8399: add note about Windows and O_BINARY. ........ r80081 | georg.brandl | 2010-04-14 23:34:44 +0200 (Mi, 14 Apr 2010) | 1 line #5250: document __instancecheck__ and __subclasscheck__. I hope the part about the class/metaclass distinction is understandable. ........ r80084 | georg.brandl | 2010-04-14 23:46:45 +0200 (Mi, 14 Apr 2010) | 1 line Fix missing. ........ r80432 | georg.brandl | 2010-04-24 10:56:58 +0200 (Sa, 24 Apr 2010) | 1 line Markup fixes. ........ r80433 | georg.brandl | 2010-04-24 11:08:10 +0200 (Sa, 24 Apr 2010) | 1 line #7507: quote "!" in pipes.quote(); it is a special character for some shells. ........ r80465 | georg.brandl | 2010-04-25 12:29:17 +0200 (So, 25 Apr 2010) | 1 line Remove LaTeXy index entry syntax. ........ r80466 | georg.brandl | 2010-04-25 12:54:42 +0200 (So, 25 Apr 2010) | 1 line Patch from Tim Hatch: Better cross-referencing in socket and winreg docs. ........ r80467 | georg.brandl | 2010-04-25 12:55:16 +0200 (So, 25 Apr 2010) | 1 line Patch from Tim Hatch: Remove reference to winreg being the fabled high-level registry interface. ........ r80468 | georg.brandl | 2010-04-25 12:55:58 +0200 (So, 25 Apr 2010) | 1 line Patch from Tim Hatch: Minor spelling changes to _winreg docs. ........ r80469 | georg.brandl | 2010-04-25 12:56:41 +0200 (So, 25 Apr 2010) | 1 line Fix code example to have valid syntax so that it can be highlighted. ........ r80470 | georg.brandl | 2010-04-25 12:57:15 +0200 (So, 25 Apr 2010) | 1 line Patch from Tim Hatch: Make socket setblocking <-> settimeout examples symmetric. ........ r81059 | georg.brandl | 2010-05-10 23:02:51 +0200 (Mo, 10 Mai 2010) | 1 line #8642: fix wrong function name. ........ r81065 | georg.brandl | 2010-05-10 23:46:50 +0200 (Mo, 10 Mai 2010) | 1 line Fix reference direction. ........ r81066 | georg.brandl | 2010-05-10 23:50:57 +0200 (Mo, 10 Mai 2010) | 1 line Consolidate deprecation messages. ........ r81067 | georg.brandl | 2010-05-10 23:51:33 +0200 (Mo, 10 Mai 2010) | 1 line Fix typo. ........	2010-05-19 20:57:08 +00:00
Antoine Pitrou	f9fc08f9f3	Merged revisions 80591-80592 via svnmerge from ... svn+ssh://pythondev@svn.python.org/python/trunk ........ r80591 | antoine.pitrou | 2010-04-28 21:53:35 +0200 (mer., 28 avril 2010) | 4 lines State clearly that truncate() doesn't move the file position, and remove a duplicate of its specification. ........ r80592 | antoine.pitrou | 2010-04-28 21:57:33 +0200 (mer., 28 avril 2010) | 3 lines Clarify and fix the documentation for IOBase.close() ........	2010-04-28 19:59:32 +00:00
Benjamin Peterson	95e392c111	Merged revisions 80544 via svnmerge from ... svn+ssh://pythondev@svn.python.org/python/trunk ........ r80544 | benjamin.peterson | 2010-04-27 16:01:54 -0500 (Tue, 27 Apr 2010) | 1 line reject None as the buffering argument like the C implementation does #8546 ........	2010-04-27 21:07:21 +00:00
Benjamin Peterson	2c2dc37e58	lower case	2010-02-19 01:05:32 +00:00
Benjamin Peterson	cc12e1b651	add a link to sys.std* in io docs	2010-02-19 00:58:13 +00:00
Antoine Pitrou	d5587bc474	Merged revisions 76896,76898 via svnmerge from ... svn+ssh://pythondev@svn.python.org/python/trunk ........ r76896 | antoine.pitrou | 2009-12-19 22:01:10 +0100 (sam., 19 déc. 2009) | 3 lines Issue #7545: improve documentation of the `buffering` argument in io.open(). ........ r76898 | antoine.pitrou | 2009-12-19 22:06:36 +0100 (sam., 19 déc. 2009) | 3 lines Remove superfetatory paragraph (left there by mistake). ........	2009-12-19 21:08:31 +00:00
Benjamin Peterson	a0dfa82eca	Merged revisions 75149,75260-75263,75265-75267,75292,75300,75376,75405,75429-75433,75437,75445,75501,75551,75572,75589-75591,75657,75742,75868,75952-75957,76057,76105,76139,76143,76162,76223 via svnmerge from ... svn+ssh://pythondev@svn.python.org/python/trunk ........ r75149 | gregory.p.smith | 2009-09-29 16:56:31 -0500 (Tue, 29 Sep 2009) | 3 lines Mention issue6972 in extractall docs about overwriting things outside of the supplied path. ........ r75260 | andrew.kuchling | 2009-10-05 16:24:20 -0500 (Mon, 05 Oct 2009) | 1 line Wording fix ........ r75261 | andrew.kuchling | 2009-10-05 16:24:35 -0500 (Mon, 05 Oct 2009) | 1 line Fix narkup ........ r75262 | andrew.kuchling | 2009-10-05 16:25:03 -0500 (Mon, 05 Oct 2009) | 1 line Document 'skip' parameter to constructor ........ r75263 | andrew.kuchling | 2009-10-05 16:25:35 -0500 (Mon, 05 Oct 2009) | 1 line Note side benefit of socket.create_connection() ........ r75265 | andrew.kuchling | 2009-10-05 17:31:11 -0500 (Mon, 05 Oct 2009) | 1 line Reword sentence ........ r75266 | andrew.kuchling | 2009-10-05 17:32:48 -0500 (Mon, 05 Oct 2009) | 1 line Use standard comma punctuation; reword some sentences in the docs ........ r75267 | andrew.kuchling | 2009-10-05 17:42:56 -0500 (Mon, 05 Oct 2009) | 1 line Backport r73983: Document the thousands separator. ........ r75292 | benjamin.peterson | 2009-10-08 22:11:36 -0500 (Thu, 08 Oct 2009) | 1 line death to old CVS keyword ........ r75300 | benjamin.peterson | 2009-10-09 16:48:14 -0500 (Fri, 09 Oct 2009) | 1 line fix some coding style ........ r75376 | benjamin.peterson | 2009-10-11 20:26:07 -0500 (Sun, 11 Oct 2009) | 1 line platform we don't care about ........ r75405 | neil.schemenauer | 2009-10-14 12:17:14 -0500 (Wed, 14 Oct 2009) | 4 lines Issue #1754094: Improve the stack depth calculation in the compiler. There should be no other effect than a small decrease in memory use. Patch by Christopher Tur Lesniewski-Laas. ........ r75429 | benjamin.peterson | 2009-10-14 20:47:28 -0500 (Wed, 14 Oct 2009) | 1 line pep8ify if blocks ........ r75430 | benjamin.peterson | 2009-10-14 20:49:37 -0500 (Wed, 14 Oct 2009) | 1 line use floor division and add a test that exercises the tabsize codepath ........ r75431 | benjamin.peterson | 2009-10-14 20:56:25 -0500 (Wed, 14 Oct 2009) | 1 line change test to what I intended ........ r75432 | benjamin.peterson | 2009-10-14 22:05:39 -0500 (Wed, 14 Oct 2009) | 1 line some cleanups ........ r75433 | benjamin.peterson | 2009-10-14 22:06:55 -0500 (Wed, 14 Oct 2009) | 1 line make inspect.isabstract() always return a boolean; add a test for it, too #7069 ........ r75437 | benjamin.peterson | 2009-10-15 10:44:46 -0500 (Thu, 15 Oct 2009) | 1 line only clear a module's __dict__ if the module is the only one with a reference to it #7140 ........ r75445 | vinay.sajip | 2009-10-16 09:06:44 -0500 (Fri, 16 Oct 2009) | 1 line Issue #7120: logging: Removed import of multiprocessing which is causing crash in GAE. ........ r75501 | antoine.pitrou | 2009-10-18 13:37:11 -0500 (Sun, 18 Oct 2009) | 3 lines Add a comment about unreachable code, and fix a typo ........ r75551 | benjamin.peterson | 2009-10-19 22:14:10 -0500 (Mon, 19 Oct 2009) | 1 line use property api ........ r75572 | benjamin.peterson | 2009-10-20 16:55:17 -0500 (Tue, 20 Oct 2009) | 1 line clarify buffer arg #7178 ........ r75589 | benjamin.peterson | 2009-10-21 21:26:47 -0500 (Wed, 21 Oct 2009) | 1 line whitespace ........ r75590 | benjamin.peterson | 2009-10-21 21:36:47 -0500 (Wed, 21 Oct 2009) | 1 line rewrite to be nice to other implementations ........ r75591 | benjamin.peterson | 2009-10-21 21:50:38 -0500 (Wed, 21 Oct 2009) | 4 lines rewrite for style, clarify, and comments Also, use the hasattr() like scheme of allowing BaseException exceptions through. ........ r75657 | antoine.pitrou | 2009-10-24 07:41:27 -0500 (Sat, 24 Oct 2009) | 3 lines Fix compilation error in debug mode. ........ r75742 | benjamin.peterson | 2009-10-26 17:51:16 -0500 (Mon, 26 Oct 2009) | 1 line use 'is' instead of id() ........ r75868 | benjamin.peterson | 2009-10-27 15:59:18 -0500 (Tue, 27 Oct 2009) | 1 line test expect base classes ........ r75952 | georg.brandl | 2009-10-29 15:38:32 -0500 (Thu, 29 Oct 2009) | 1 line Use the correct function name in docstring. ........ r75953 | georg.brandl | 2009-10-29 15:39:50 -0500 (Thu, 29 Oct 2009) | 1 line Remove mention of the old -X command line switch. ........ r75954 | georg.brandl | 2009-10-29 15:53:00 -0500 (Thu, 29 Oct 2009) | 1 line Use constants instead of magic integers for test result. Do not re-run with --verbose3 for environment changing tests. ........ r75955 | georg.brandl | 2009-10-29 15:54:03 -0500 (Thu, 29 Oct 2009) | 1 line Use a single style for all the docstrings in the math module. ........ r75956 | georg.brandl | 2009-10-29 16:16:34 -0500 (Thu, 29 Oct 2009) | 1 line I do not think the "railroad" program mentioned is still available. ........ r75957 | georg.brandl | 2009-10-29 16:44:56 -0500 (Thu, 29 Oct 2009) | 1 line Fix constant name. ........ r76057 | benjamin.peterson | 2009-11-02 09:06:45 -0600 (Mon, 02 Nov 2009) | 1 line prevent a rather unlikely segfault ........ r76105 | georg.brandl | 2009-11-04 01:38:12 -0600 (Wed, 04 Nov 2009) | 1 line #7259: show correct equivalent for operator.i* operations in docstring; fix minor issues in operator docs. ........ r76139 | benjamin.peterson | 2009-11-06 19:04:38 -0600 (Fri, 06 Nov 2009) | 1 line spelling ........ r76143 | georg.brandl | 2009-11-07 02:26:07 -0600 (Sat, 07 Nov 2009) | 1 line #7271: fix typo. ........ r76162 | benjamin.peterson | 2009-11-08 22:10:53 -0600 (Sun, 08 Nov 2009) | 1 line discuss how to use -p ........ r76223 | georg.brandl | 2009-11-12 02:29:46 -0600 (Thu, 12 Nov 2009) | 1 line Give the profile module a module directive. ........	2009-11-13 02:25:08 +00:00
Antoine Pitrou	78ddbe69af	Issue #7022: clarification of RawIOBase.read(), suggested by Pascal Chambon.	2009-10-01 16:24:45 +00:00
Antoine Pitrou	497a767c59	Issue #6929: fix a couple of statements and clarify a lot of things in the IO docs.	2009-09-17 17:18:01 +00:00
Georg Brandl	502d9a5c2c	Merged revisions 74207 via svnmerge from ... svn+ssh://pythondev@svn.python.org/python/trunk ........ r74207 | georg.brandl | 2009-07-26 16:19:57 +0200 (So, 26 Jul 2009) | 1 line #6577: fix (hopefully) all links to builtin instead of module/class-specific objects. ........	2009-07-26 15:02:41 +00:00
Georg Brandl	22b3431426	Merged revisions 74209 via svnmerge from ... svn+ssh://pythondev@svn.python.org/python/trunk ........ r74209 | georg.brandl | 2009-07-26 16:37:28 +0200 (So, 26 Jul 2009) | 1 line builtin -> built-in. ........	2009-07-26 14:54:51 +00:00
Benjamin Peterson	c609b6b04b	document BufferedIOBase.raw and TextIOBase.buffer	2009-06-28 17:32:20 +00:00
Benjamin Peterson	c43a26da13	rephrase for clarity	2009-06-16 23:09:24 +00:00
Benjamin Peterson	2a8b54d29c	update peek documentation to implementation	2009-06-14 14:37:23 +00:00
Benjamin Peterson	0926ad1f05	give the C implementation of TextIOWrapper the errors property #6217	2009-06-06 18:02:12 +00:00
Georg Brandl	3dd3388229	Convert all "i" docs to new style optional args.	2009-06-01 17:35:27 +00:00
Benjamin Peterson	edc364717e	versionadded	2009-05-01 20:48:14 +00:00
Benjamin Peterson	ef9f2bde37	add myself	2009-05-01 20:45:43 +00:00
Benjamin Peterson	d2e0c7955f	implement a detach() method for BufferedIOBase and TextIOBase #5883	2009-05-01 20:40:59 +00:00
Raymond Hettinger	35a88363a5	Update whatsnew based on doc search.	2009-04-09 00:08:24 +00:00
Benjamin Peterson	0e4caf4bd2	Merged revisions 70992,70995 via svnmerge from ... svn+ssh://pythondev@svn.python.org/python/trunk ........ r70992 | georg.brandl | 2009-04-01 16:00:55 -0500 (Wed, 01 Apr 2009) | 1 line #4572: add SEEK_* values as constants in io.py. ........ r70995 | benjamin.peterson | 2009-04-01 16:12:54 -0500 (Wed, 01 Apr 2009) | 1 line add seek constants to __all__ ........	2009-04-01 21:22:20 +00:00
Benjamin Peterson	52c3bf1aa5	sync open() docs more	2009-03-23 02:44:58 +00:00
Benjamin Peterson	8cad9c777b	fix docs about open's return value #5539 ... (how annoying to have the same docs in two places) (three if you count the docstring...)	2009-03-23 02:38:01 +00:00
Benjamin Peterson	aa1c8d8899	fix StringIO constructor docs #5452	2009-03-09 02:02:23 +00:00
Benjamin Peterson	394ee00993	remove usage of the deprecated max_buffer_size	2009-03-05 22:33:59 +00:00