Issue #12102: Document that buffered files must be flushed before being used

with mmap. Patch by Steffen Daode Nurpmeso.
This commit is contained in:
Ross Lagerwall 2011-07-25 07:12:43 +02:00
parent 749400a94d
commit 59c01edcaa
3 changed files with 10 additions and 0 deletions

View File

@ -144,6 +144,7 @@ docs@python.org), and we'll be glad to correct the problem.
* Sjoerd Mullender
* Dale Nagata
* Michal Nowikowski
* Steffen Daode Nurpmeso
* Ng Pheng Siong
* Koray Oner
* Tomas Oppelstrup

View File

@ -21,6 +21,12 @@ file object, use its :meth:`fileno` method to obtain the correct value for the
:func:`os.open` function, which returns a file descriptor directly (the file
still needs to be closed when done).
.. note::
If you want to create a memory-mapping for a writable, buffered file, you
should :func:`~io.IOBase.flush` the file first. This is necessary to ensure
that local modifications to the buffers are actually available to the
mapping.
For both the Unix and Windows versions of the constructor, *access* may be
specified as an optional keyword parameter. *access* accepts one of three
values: :const:`ACCESS_READ`, :const:`ACCESS_WRITE`, or :const:`ACCESS_COPY`

View File

@ -37,6 +37,9 @@ Core and Builtins
Library
-------
- Issue #12102: Document that buffered files must be flushed before being used
with mmap. Patch by Steffen Daode Nurpmeso.
- Issue #12560: Build libpython.so on OpenBSD. Patch by Stefan Sperling.
- Issue #1813: Fix codec lookup under Turkish locales.