This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author goodmami
Recipients docs@python, goodmami
Date 2021-10-21.22:53:54
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1634856834.17.0.487129969562.issue45528@roundup.psfhosted.org>
In-reply-to
Content
Also, the first sentences of third paragraph have some problems:

> For both the Unix and Windows versions of the constructor,
> access may be specified as an optional keyword
> parameter. access accepts one of four values: ACCESS_READ,
> ACCESS_WRITE, or ACCESS_COPY to specify read-only,
> write-through or copy-on-write memory respectively, or
> ACCESS_DEFAULT to defer to prot. access can be used on both
> Unix and Windows. If access is not specified, Windows mmap
> returns a write-through mapping.

1. It redundantly says that *access* may be used for Unix and Windows.
2. It says ACCESS_DEFAULT defers to *prot* but doesn't say this is only for Unix nor that *prot* is a parameter.
3. It doesn't say what happens on Unix if *access* is not specified except implicitly by the earlier statement about ACCESS_DEFAULT.

Proposed change:

    For both the Unix and Windows versions of the constructor,
    *access* may be specified as an optional keyword parameter.
    *access* accepts one of the four :ref:`ACCESS_* constants
    <access-constants>`: :const:`ACCESS_READ`,
    :const:`ACCESS_WRITE`, or :const:`ACCESS_COPY` to specify
    read-only, write-through or copy-on-write memory
    respectively, or :const:`ACCESS_DEFAULT` (the default value
    if *access* is not specified) to return a write-through
    mapping on Windows or defer to the value of the *prot*
    parameter on Unix.
History
Date User Action Args
2021-10-21 22:53:54goodmamisetrecipients: + goodmami, docs@python
2021-10-21 22:53:54goodmamisetmessageid: <1634856834.17.0.487129969562.issue45528@roundup.psfhosted.org>
2021-10-21 22:53:54goodmamilinkissue45528 messages
2021-10-21 22:53:54goodmamicreate