Kaydet (Commit) 0c880bd4 authored tarafından Georg Brandl's avatar Georg Brandl

#4441: improve doc for os.open() flags.

üst 5b5f2736
...@@ -681,10 +681,11 @@ by file descriptors. ...@@ -681,10 +681,11 @@ by file descriptors.
:func:`fdopen`, or :data:`sys.stdout` or :data:`sys.stderr`, use its :meth:`write` :func:`fdopen`, or :data:`sys.stdout` or :data:`sys.stderr`, use its :meth:`write`
method. method.
The following data items are available for use in constructing the *flags* The following constants are options for the *flags* parameter to the
parameter to the :func:`open` function. Some items will not be available on all :func:`open` function. They can be combined using the bitwise OR operator
platforms. For descriptions of their availability and use, consult ``|``. Some of them are not available on all platforms. For descriptions of
:manpage:`open(2)`. their availability and use, consult the :manpage:`open(2)` manual page or the
respective documentation for your operating system.
.. data:: O_RDONLY .. data:: O_RDONLY
...@@ -695,8 +696,7 @@ platforms. For descriptions of their availability and use, consult ...@@ -695,8 +696,7 @@ platforms. For descriptions of their availability and use, consult
O_EXCL O_EXCL
O_TRUNC O_TRUNC
Options for the *flag* argument to the :func:`open` function. These can be These constants are available on Unix and Windows.
combined using the bitwise OR operator ``|``. Availability: Unix, Windows.
.. data:: O_DSYNC .. data:: O_DSYNC
...@@ -708,8 +708,7 @@ platforms. For descriptions of their availability and use, consult ...@@ -708,8 +708,7 @@ platforms. For descriptions of their availability and use, consult
O_SHLOCK O_SHLOCK
O_EXLOCK O_EXLOCK
More options for the *flag* argument to the :func:`open` function. Availability: These constants are only available on Unix.
Unix.
.. data:: O_BINARY .. data:: O_BINARY
...@@ -720,8 +719,7 @@ platforms. For descriptions of their availability and use, consult ...@@ -720,8 +719,7 @@ platforms. For descriptions of their availability and use, consult
O_SEQUENTIAL O_SEQUENTIAL
O_TEXT O_TEXT
Options for the *flag* argument to the :func:`open` function. These can be These constants are only available on Windows.
combined using the bitwise OR operator ``|``. Availability: Windows.
.. data:: O_ASYNC .. data:: O_ASYNC
...@@ -730,8 +728,8 @@ platforms. For descriptions of their availability and use, consult ...@@ -730,8 +728,8 @@ platforms. For descriptions of their availability and use, consult
O_NOFOLLOW O_NOFOLLOW
O_NOATIME O_NOATIME
Options for the *flag* argument to the :func:`open` function. These are These constants are GNU extensions and not present if they are not defined by
GNU extensions and not present if they are not defined by the C library. the C library.
.. data:: SEEK_SET .. data:: SEEK_SET
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment