information (4 KiB pages are common; using multiples of 4096 for the stack size is
the suggested approach in the absence of more specific information).
- .. availability:: Windows, systems with POSIX threads.
+ .. availability:: Windows, pthreads.
+
+ Unix platforms with POSIX threads support.
.. data:: TIMEOUT_MAX
This module implements the ANSI codepage (CP_ACP).
-.. availability:: Windows only.
+.. availability:: Windows.
.. versionchanged:: 3.3
Support any error handler.
extensions available on the current implementation will also be available on
this module.
-.. availability:: Unix. Not available on VxWorks.
+.. availability:: Unix, not VxWorks.
Hashing Methods
---------------
* If not separately noted, all functions that claim "Availability: Unix" are
supported on macOS, which builds on a Unix core.
+* If an availability note contains both a minimum Kernel version and a minimum
+ libc version, then both conditions must hold. For example a feature with note
+ *Availability: Linux >= 3.17 with glibc >= 2.27* requires both Linux 3.17 or
+ newer and glibc 2.27 or newer.
and ``'surrogateescape'`` error handler. Use :func:`os.getenvb` if you
would like to use a different encoding.
- .. availability:: most flavors of Unix, Windows.
+ .. availability:: Unix, Windows.
.. function:: getenvb(key, default=None)
:func:`getenvb` is only available if :data:`supports_bytes_environ`
is ``True``.
- .. availability:: most flavors of Unix.
+ .. availability:: Unix.
.. versionadded:: 3.2
:func:`socket.gethostname` or even
``socket.gethostbyaddr(socket.gethostname())``.
- .. availability:: recent flavors of Unix.
+ .. availability:: Unix.
.. versionchanged:: 3.3
Return type changed from a tuple to a tuple-like object
The return value is the amount of bytes copied. This could be less than the
amount requested.
- .. availability:: Linux kernel >= 4.5 or glibc >= 2.27.
+ .. availability:: Linux >= 4.5 with glibc >= 2.27.
.. versionadded:: 3.8
descriptors are :ref:`non-inheritable <fd_inheritance>`. For a (slightly) more
portable approach, use the :mod:`pty` module.
- .. availability:: some flavors of Unix.
+ .. availability:: Unix.
.. versionchanged:: 3.4
The new file descriptors are now non-inheritable.
Return a pair of file descriptors ``(r, w)`` usable for reading and writing,
respectively.
- .. availability:: some flavors of Unix.
+ .. availability:: Unix.
.. versionadded:: 3.3
Combine the functionality of :func:`os.readv` and :func:`os.pread`.
- .. availability:: Linux 2.6.30 and newer, FreeBSD 6.0 and newer,
- OpenBSD 2.7 and newer, AIX 7.1 and newer. Using flags requires
- Linux 4.6 or newer.
+ .. availability:: Linux >= 2.6.30, FreeBSD >= 6.0, OpenBSD >= 2.7, AIX >= 7.1.
+
+ Using flags requires Linux >= 4.6.
.. versionadded:: 3.7
If no bytes were read, it will return ``-1`` and set errno to
:data:`errno.EAGAIN`.
- .. availability:: Linux 4.14 and newer.
+ .. availability:: Linux >= 4.14.
.. versionadded:: 3.7
Currently, on Linux, this feature is usable only on a file descriptor opened
using the :data:`O_DIRECT` flag.
- .. availability:: Linux 4.6 and newer.
+ .. availability:: Linux >= 4.6.
.. versionadded:: 3.7
Combine the functionality of :func:`os.writev` and :func:`os.pwrite`.
- .. availability:: Linux 2.6.30 and newer, FreeBSD 6.0 and newer,
- OpenBSD 2.7 and newer, AIX 7.1 and newer. Using flags requires
- Linux 4.7 or newer.
+ .. availability:: Linux >= 2.6.30, FreeBSD >= 6.0, OpenBSD >= 2.7, AIX >= 7.1.
+
+ Using flags requires Linux >= 4.6.
.. versionadded:: 3.7
Provide a per-write equivalent of the :data:`O_DSYNC` :func:`os.open` flag.
This flag effect applies only to the data range written by the system call.
- .. availability:: Linux 4.7 and newer.
+ .. availability:: Linux >= 4.7.
.. versionadded:: 3.7
Provide a per-write equivalent of the :data:`O_SYNC` :func:`os.open` flag.
This flag effect applies only to the data range written by the system call.
- .. availability:: Linux 4.7 and newer.
+ .. availability:: Linux >= 4.7.
.. versionadded:: 3.7
appended to the end of the file. However, if the *offset* argument is
``-1``, the current file *offset* is updated.
- .. availability:: Linux 4.16 and newer.
+ .. availability:: Linux >= 4.16.
.. versionadded:: 3.10
make sense to block because there are no writers connected to the write end
of the pipe.
- .. availability:: Linux kernel >= 2.6.17 and glibc >= 2.5
+ .. availability:: Linux >= 2.6.17 with glibc >= 2.5
.. versionadded:: 3.10
the file descriptor, and as such multiple files can have the same name
without any side effects.
- .. availability:: Linux 3.17 or newer with glibc 2.27 or newer.
+ .. availability:: Linux >= 3.17 with glibc >= 2.27.
.. versionadded:: 3.8
These flags can be passed to :func:`memfd_create`.
- .. availability:: Linux 3.17 or newer with glibc 2.27 or newer. The
- ``MFD_HUGE*`` flags are only available since Linux 4.14.
+ .. availability:: Linux >= 3.17 with glibc >= 2.27
+
+ The ``MFD_HUGE*`` flags are only available since Linux 4.14.
.. versionadded:: 3.8
finally:
os.close(fd)
- .. availability:: Linux 2.6.27 or newer with glibc 2.8 or newer.
+ .. availability:: Linux >= 2.6.27 with glibc >= 2.8
.. versionadded:: 3.10
Read value from an :func:`eventfd` file descriptor and return a 64 bit
unsigned int. The function does not verify that *fd* is an :func:`eventfd`.
- .. availability:: See :func:`eventfd`
+ .. availability:: Linux >= 2.6.27
.. versionadded:: 3.10
Add value to an :func:`eventfd` file descriptor. *value* must be a 64 bit
unsigned int. The function does not verify that *fd* is an :func:`eventfd`.
- .. availability:: See :func:`eventfd`
+ .. availability:: Linux >= 2.6.27
.. versionadded:: 3.10
Set close-on-exec flag for new :func:`eventfd` file descriptor.
- .. availability:: See :func:`eventfd`
+ .. availability:: Linux >= 2.6.27
.. versionadded:: 3.10
Set :const:`O_NONBLOCK` status flag for new :func:`eventfd` file
descriptor.
- .. availability:: See :func:`eventfd`
+ .. availability:: Linux >= 2.6.27
.. versionadded:: 3.10
Provide semaphore-like semantics for reads from a :func:`eventfd` file
descriptor. On read the internal counter is decremented by one.
- .. availability:: Linux 2.6.30 or newer with glibc 2.8 or newer.
+ .. availability:: Linux >= 2.6.30
.. versionadded:: 3.10
Calling ``forkpty()`` in a subinterpreter is no longer supported
(:exc:`RuntimeError` is raised).
- .. availability:: some flavors of Unix.
+ .. availability:: Unix.
.. function:: kill(pid, sig)
See the :manpage:`pidfd_open(2)` man page for more details.
- .. availability:: Linux 5.3+
+ .. availability:: Linux >= 5.3
.. versionadded:: 3.9
.. versionadded:: 3.8
- .. availability:: See :func:`posix_spawn` documentation.
+ .. availability:: POSIX
+
+ See :func:`posix_spawn` documentation.
.. function:: register_at_fork(*, before=None, after_in_parent=None, \
.. audit-event:: os.spawn mode,path,args,env os.spawnl
- .. availability:: Unix, Windows. :func:`spawnlp`, :func:`spawnlpe`, :func:`spawnvp`
+ .. availability:: Unix, Windows.
+
+ :func:`spawnlp`, :func:`spawnlpe`, :func:`spawnvp`
and :func:`spawnvpe` are not available on Windows. :func:`spawnle` and
:func:`spawnve` are not thread-safe on Windows; we advise you to use the
:mod:`subprocess` module instead.
This is a Linux-specific *idtype* that indicates that *id* is a file
descriptor that refers to a process.
- .. availability:: Linux 5.4+
+ .. availability:: Linux >= 5.4
.. versionadded:: 3.9
This option causes child processes to be reported if they have been continued
from a job control stop since their status was last reported.
- .. availability:: some Unix systems.
+ .. availability:: Unix.
+
+ Some Unix systems.
.. data:: WUNTRACED
See also the `Linux getrandom() manual page
<http://man7.org/linux/man-pages/man2/getrandom.2.html>`_.
- .. availability:: Linux 3.17 and newer.
+ .. availability:: Linux >= 3.17.
.. versionadded:: 3.6
Because the module uses :program:`/bin/sh` command lines, a POSIX or compatible
shell for :func:`os.system` and :func:`os.popen` is required.
-.. availability:: Unix. Not available on VxWorks.
+.. availability:: Unix, not VxWorks.
The :mod:`pipes` module defines the following class:
.. audit-event:: resource.prlimit pid,resource,limits resource.prlimit
- .. availability:: Linux 2.6.36 or later with glibc 2.13 or later.
+ .. availability:: Linux >= 2.6.36 with glibc >= 2.13.
.. versionadded:: 3.4
The number of bytes that can be allocated for POSIX message queues.
- .. availability:: Linux 2.6.8 or later.
+ .. availability:: Linux >= 2.6.8.
.. versionadded:: 3.4
The ceiling for the process's nice level (calculated as 20 - rlim_cur).
- .. availability:: Linux 2.6.12 or later.
+ .. availability:: Linux >= 2.6.12.
.. versionadded:: 3.4
The ceiling of the real-time priority.
- .. availability:: Linux 2.6.12 or later.
+ .. availability:: Linux >= 2.6.12.
.. versionadded:: 3.4
The time limit (in microseconds) on CPU time that a process can spend
under real-time scheduling without making a blocking syscall.
- .. availability:: Linux 2.6.25 or later.
+ .. availability:: Linux >= 2.6.25.
.. versionadded:: 3.4
The number of signals which the process may queue.
- .. availability:: Linux 2.6.8 or later.
+ .. availability:: Linux >= 2.6.8.
.. versionadded:: 3.4
This limits the amount of network memory, and hence the amount of mbufs,
that this user may hold at any time.
- .. availability:: FreeBSD 9 or later.
+ .. availability:: FreeBSD.
.. versionadded:: 3.4
`tuning(7) <https://www.freebsd.org/cgi/man.cgi?query=tuning&sektion=7>`__
for a complete description of this sysctl.
- .. availability:: FreeBSD 9 or later.
+ .. availability:: FreeBSD.
.. versionadded:: 3.4
The maximum number of pseudo-terminals created by this user id.
- .. availability:: FreeBSD 9 or later.
+ .. availability:: FreeBSD.
.. versionadded:: 3.4
The maximum number of kqueues this user id is allowed to create.
- .. availability:: FreeBSD 11 or later.
+ .. availability:: FreeBSD >= 11.
.. versionadded:: 3.10
:class:`enum.IntEnum` collection the constants :const:`SIG_BLOCK`, :const:`SIG_UNBLOCK` and :const:`SIG_SETMASK`.
- Availability: Unix. See the man page :manpage:`sigprocmask(2)` and
- :manpage:`pthread_sigmask(3)` for further information.
+ .. availability:: Unix.
+
+ See the man page :manpage:`sigprocmask(2)` and
+ :manpage:`pthread_sigmask(3)` for further information.
.. versionadded:: 3.5
Stack fault on coprocessor. The Linux kernel does not raise this signal: it
can only be raised in user space.
- .. availability:: Linux, on architectures where the signal is available. See
+ .. availability:: Linux.
+
+ On architectures where the signal is available. See
the man page :manpage:`signal(7)` for further information.
.. versionadded:: 3.11
delivered. If *time* is zero, no alarm is scheduled, and any scheduled alarm is
canceled. If the return value is zero, no alarm is currently scheduled.
- .. availability:: Unix. See the man page :manpage:`alarm(2)` for further
- information.
+ .. availability:: Unix.
+
+ See the man page :manpage:`alarm(2)` for further information.
.. function:: getsignal(signalnum)
Cause the process to sleep until a signal is received; the appropriate handler
will then be called. Returns nothing.
- .. availability:: Unix. See the man page :manpage:`signal(2)` for further
- information.
+ .. availability:: Unix.
+
+ See the man page :manpage:`signal(2)` for further information.
See also :func:`sigwait`, :func:`sigwaitinfo`, :func:`sigtimedwait` and
:func:`sigpending`.
See the :manpage:`pidfd_send_signal(2)` man page for more information.
- .. availability:: Linux 5.1+
+ .. availability:: Linux >= 5.1
.. versionadded:: 3.9
.. audit-event:: signal.pthread_kill thread_id,signalnum signal.pthread_kill
- .. availability:: Unix. See the man page :manpage:`pthread_kill(3)` for further
- information.
+ .. availability:: Unix.
+
+ See the man page :manpage:`pthread_kill(3)` for further information.
See also :func:`os.kill`.
:data:`SIGKILL` and :data:`SIGSTOP` cannot be blocked.
- .. availability:: Unix. See the man page :manpage:`sigprocmask(2)` and
+ .. availability:: Unix.
+
+ See the man page :manpage:`sigprocmask(2)` and
:manpage:`pthread_sigmask(3)` for further information.
See also :func:`pause`, :func:`sigpending` and :func:`sigwait`.
calls will be restarted when interrupted by signal *signalnum*, otherwise
system calls will be interrupted. Returns nothing.
- .. availability:: Unix. See the man page :manpage:`siginterrupt(3)`
- for further information.
+ .. availability:: Unix.
+
+ See the man page :manpage:`siginterrupt(3)` for further information.
Note that installing a signal handler with :func:`signal` will reset the
restart behaviour to interruptible by implicitly calling
thread (i.e., the signals which have been raised while blocked). Return the
set of the pending signals.
- .. availability:: Unix. See the man page :manpage:`sigpending(2)` for further
- information.
+ .. availability:: Unix.
+
+ See the man page :manpage:`sigpending(2)` for further information.
See also :func:`pause`, :func:`pthread_sigmask` and :func:`sigwait`.
signals specified in the signal set *sigset*. The function accepts the signal
(removes it from the pending list of signals), and returns the signal number.
- .. availability:: Unix. See the man page :manpage:`sigwait(3)` for further
- information.
+ .. availability:: Unix.
+
+ See the man page :manpage:`sigwait(3)` for further information.
See also :func:`pause`, :func:`pthread_sigmask`, :func:`sigpending`,
:func:`sigwaitinfo` and :func:`sigtimedwait`.
:attr:`si_errno`, :attr:`si_pid`, :attr:`si_uid`, :attr:`si_status`,
:attr:`si_band`.
- .. availability:: Unix. See the man page :manpage:`sigwaitinfo(2)` for further
- information.
+ .. availability:: Unix.
+
+ See the man page :manpage:`sigwaitinfo(2)` for further information.
See also :func:`pause`, :func:`sigwait` and :func:`sigtimedwait`.
specifying a timeout. If *timeout* is specified as :const:`0`, a poll is
performed. Returns :const:`None` if a timeout occurs.
- .. availability:: Unix. See the man page :manpage:`sigtimedwait(2)` for further
- information.
+ .. availability:: Unix.
+
+ See the man page :manpage:`sigtimedwait(2)` for further information.
See also :func:`pause`, :func:`sigwait` and :func:`sigwaitinfo`.
- *feat* and *mask* are unsigned 32bit integers.
- .. availability:: Linux 2.6.38, some algorithm types require more recent Kernels.
+ .. availability:: Linux >= 2.6.38.
+
+ Some algorithm types require more recent Kernels.
.. versionadded:: 3.6
their hosts. The sockets are represented as a ``(CID, port)`` tuple
where the context ID or CID and port are integers.
- .. availability:: Linux >= 4.8 QEMU >= 2.8 ESX >= 4.0 ESX Workstation >= 6.5.
+ .. availability:: Linux >= 3.9
+
+ See :manpage:`vsock(7)`
.. versionadded:: 3.7
``socket(AF_INET, SOCK_DGRAM, IPPROTO_UDPLITE)`` for IPv4 or
``socket(AF_INET6, SOCK_DGRAM, IPPROTO_UDPLITE)`` for IPv6.
- .. availability:: Linux >= 2.6.20, FreeBSD >= 10.1-RELEASE
+ .. availability:: Linux >= 2.6.20, FreeBSD >= 10.1
.. versionadded:: 3.9
both the value of *address_family* and the underlying implementation of
:c:func:`inet_pton`.
- .. availability:: Unix (maybe not all platforms), Windows.
+ .. availability:: Unix, Windows.
.. versionchanged:: 3.4
Windows support added
length for the specified address family, :exc:`ValueError` will be raised.
:exc:`OSError` is raised for errors from the call to :func:`inet_ntop`.
- .. availability:: Unix (maybe not all platforms), Windows.
+ .. availability:: Unix, Windows.
.. versionchanged:: 3.4
Windows support added
buffer. Raises :exc:`OverflowError` if *length* is outside the
permissible range of values.
- .. availability:: most Unix platforms, possibly others.
+ .. availability:: Unix.
+
+ Most Unix platforms.
.. versionadded:: 3.3
amount of ancillary data that can be received, since additional
data may be able to fit into the padding area.
- .. availability:: most Unix platforms, possibly others.
+ .. availability:: Unix.
+
+ most Unix platforms.
.. versionadded:: 3.3
The *fds* parameter is a sequence of file descriptors.
Consult :meth:`sendmsg` for the documentation of these parameters.
- .. availability:: Unix supporting :meth:`~socket.sendmsg` and :const:`SCM_RIGHTS` mechanism.
+ .. availability:: Unix.
+
+ Unix platforms supporting :meth:`~socket.sendmsg`
+ and :const:`SCM_RIGHTS` mechanism.
.. versionadded:: 3.9
Return ``(msg, list(fds), flags, addr)``.
Consult :meth:`recvmsg` for the documentation of these parameters.
- .. availability:: Unix supporting :meth:`~socket.recvmsg` and :const:`SCM_RIGHTS` mechanism.
+ .. availability:: Unix.
+
+ Unix platforms supporting :meth:`~socket.sendmsg`
+ and :const:`SCM_RIGHTS` mechanism.
.. versionadded:: 3.9
fds.frombytes(cmsg_data[:len(cmsg_data) - (len(cmsg_data) % fds.itemsize)])
return msg, list(fds)
- .. availability:: most Unix platforms, possibly others.
+ .. availability:: Unix.
+
+ Most Unix platforms.
.. versionadded:: 3.3
>>> [b1, b2, b3]
[bytearray(b'Mary'), bytearray(b'01 had a 9'), bytearray(b'little lamb---')]
- .. availability:: most Unix platforms, possibly others.
+ .. availability:: Unix.
+
+ Most Unix platforms.
.. versionadded:: 3.3
def send_fds(sock, msg, fds):
return sock.sendmsg([msg], [(socket.SOL_SOCKET, socket.SCM_RIGHTS, array.array("i", fds))])
- .. availability:: most Unix platforms, possibly others.
+ .. availability:: Unix.
+
+ Most Unix platforms.
.. audit-event:: socket.sendmsg self,address socket.socket.sendmsg
* :attr:`openssl_capath_env` - OpenSSL's environment key that points to a capath,
* :attr:`openssl_capath` - hard coded path to a capath directory
- .. availability:: LibreSSL ignores the environment vars
- :attr:`openssl_cafile_env` and :attr:`openssl_capath_env`.
-
.. versionadded:: 3.4
.. function:: enum_certificates(store_name)
>>> subprocess.getstatusoutput('/bin/kill $$')
(-15, '')
- .. availability:: POSIX & Windows.
+ .. availability:: Unix, Windows.
.. versionchanged:: 3.3.4
Windows support was added.
>>> subprocess.getoutput('ls /bin/ls')
'/bin/ls'
- .. availability:: POSIX & Windows.
+ .. availability:: Unix, Windows.
.. versionchanged:: 3.3.4
Windows support added
| | memory support. |
+-----------------------------+----------------------------------------------+
- .. availability:: WebAssembly Emscripten platform (*wasm32-emscripten*).
+ .. availability:: Emscripten.
.. versionadded:: 3.11
information (4 KiB pages are common; using multiples of 4096 for the stack size is
the suggested approach in the absence of more specific information).
- .. availability:: Windows, systems with POSIX threads.
+ .. availability:: Windows, pthreads.
+
+ Unix platforms with POSIX threads support.
This module also defines the following constant:
system-wide) from the time the thread is created until the thread
has been terminated.
- .. availability:: Requires :func:`get_native_id` function.
+ .. availability:: Windows, FreeBSD, Linux, macOS, OpenBSD, NetBSD, AIX, DragonFlyBSD.
.. versionadded:: 3.8
Passing an invalid or expired *thread_id* may result in
undefined behavior, such as segmentation fault.
- .. availability:: Unix (see the man page for :manpage:`pthread_getcpuclockid(3)` for
- further information).
+ .. availability:: Unix
+
+ See the man page for :manpage:`pthread_getcpuclockid(3)` for
+ further information.
.. versionadded:: 3.7
Use :func:`thread_time_ns` to avoid the precision loss caused by the
:class:`float` type.
- .. availability:: Windows, Linux, Unix systems supporting
- ``CLOCK_THREAD_CPUTIME_ID``.
+ .. availability:: Linux, Unix, Windows.
+
+ Unix systems supporting ``CLOCK_THREAD_CPUTIME_ID``.
.. versionadded:: 3.7
have discontinuities if the time is changed using ``settimeofday()`` or
similar.
- .. availability:: Linux 2.6.39 or later.
+ .. availability:: Linux >= 2.6.39.
.. versionadded:: 3.7
Similar to :data:`CLOCK_MONOTONIC`, but provides access to a raw
hardware-based time that is not subject to NTP adjustments.
- .. availability:: Linux 2.6.28 and newer, macOS 10.12 and newer.
+ .. availability:: Linux >= 2.6.28, macOS >= 10.12.
.. versionadded:: 3.3
High-resolution per-process timer from the CPU.
- .. availability:: FreeBSD, NetBSD 7 or later, OpenBSD.
+ .. availability:: FreeBSD, NetBSD >= 7, OpenBSD.
.. versionadded:: 3.7
suspended, providing accurate uptime measurement, both absolute and
interval.
- .. availability:: FreeBSD, OpenBSD 5.5 or later.
+ .. availability:: FreeBSD, OpenBSD >= 5.5.
.. versionadded:: 3.7
point, unaffected by frequency or time adjustments and not incremented while
the system is asleep.
- .. availability:: macOS 10.12 and newer.
+ .. availability:: macOS >= 10.12.
.. versionadded:: 3.8
class Availability(Directive):
- has_content = False
+ has_content = True
required_arguments = 1
optional_arguments = 0
final_argument_whitespace = True
+ # known platform, libc, and threading implementations
+ known_platforms = frozenset({
+ "AIX", "Android", "BSD", "DragonFlyBSD", "Emscripten", "FreeBSD",
+ "Linux", "NetBSD", "OpenBSD", "POSIX", "Solaris", "Unix", "VxWorks",
+ "WASI", "Windows", "macOS",
+ # libc
+ "BSD libc", "glibc", "musl",
+ # POSIX platforms with pthreads
+ "pthreads",
+ })
+
def run(self):
availability_ref = ':ref:`Availability <availability>`: '
pnode = nodes.paragraph(availability_ref + self.arguments[0],
pnode.extend(n + m)
n, m = self.state.inline_text(self.arguments[0], self.lineno)
pnode.extend(n + m)
+ if self.content:
+ content = " " + " ".join(self.content)
+ n, m = self.state.inline_text(content, self.content_offset)
+ pnode.extend(n + m)
+
+ self.parse_platforms()
+
return [pnode]
+ def parse_platforms(self):
+ """Parse platform information from arguments
+
+ Arguments is a comma-separated string of platforms. A platform may
+ be prefixed with "not " to indicate that a feature is not available.
+
+ Example::
+
+ .. availability:: Windows, Linux >= 4.2, not Emscripten, not WASI
+
+ Arguments like "Linux >= 3.17 with glibc >= 2.27" are currently not
+ parsed into separate tokens.
+ """
+ platforms = {}
+ for arg in self.arguments[0].rstrip(".").split(","):
+ arg = arg.strip()
+ platform, _, version = arg.partition(" >= ")
+ if platform.startswith("not "):
+ version = False
+ platform = platform[4:]
+ elif not version:
+ version = True
+ platforms[platform] = version
+
+ unknown = set(platforms).difference(self.known_platforms)
+ if unknown:
+ cls = type(self)
+ logger = logging.getLogger(cls.__qualname__)
+ logger.warn(
+ f"Unknown platform(s) or syntax '{' '.join(sorted(unknown))}' "
+ f"in '.. availability:: {self.arguments[0]}', see "
+ f"{__file__}:{cls.__qualname__}.known_platforms for a set "
+ "known platforms."
+ )
+
+ return platforms
+
+
# Support for documenting audit event
order to force the interpreter to use ``ASCII`` instead of ``UTF-8`` for
system interfaces.
- .. availability:: \*nix.
+ .. availability:: Unix.
.. versionadded:: 3.7
See :pep:`538` for more details.
--- /dev/null
+Use consistent syntax for platform availability. The directive now supports
+a content body and emits a warning when it encounters an unknown platform.
projects / thirdparty / Python / cpython.git / commitdiff
