basedpyright 1.15.2 → 1.16.0

package/dist/typeshed-fallback/stdlib/cmath.pyi

@@ -73,7 +73,7 @@ def log(x: _C, base: _C = ..., /) -> complex:
     """
     log(z[, base]) -> the logarithm of z to the given base.
 
-    If the base not specified, returns the natural logarithm (base e) of z.
+    If the base is not specified, returns the natural logarithm (base e) of z.
     """
     ...
 def log10(z: _C, /) -> complex:

package/dist/typeshed-fallback/stdlib/collections/__init__.pyi

@@ -253,7 +253,7 @@ class deque(MutableSequence[_T]):
         """Return a shallow copy of a deque."""
         ...
     def count(self, x: _T, /) -> int:
-        """D.count(value) -> integer -- return number of occurrences of value"""
+        """D.count(value) -- return number of occurrences of value"""
         ...
     def extend(self, iterable: Iterable[_T], /) -> None:
         """Extend the right side of the deque with elements from the iterable"""
@@ -266,7 +266,7 @@ class deque(MutableSequence[_T]):
         ...
     def index(self, x: _T, start: int = 0, stop: int = ..., /) -> int:
         """
-        D.index(value, [start, [stop]]) -> integer -- return first index of value.
+        D.index(value, [start, [stop]]) -- return first index of value.
         Raises ValueError if the value is not present.
         """
         ...
@@ -299,7 +299,7 @@ class deque(MutableSequence[_T]):
         """Delete self[key]."""
         ...
     def __contains__(self, key: object, /) -> bool:
-        """Return key in self."""
+        """Return bool(key in self)."""
         ...
     def __reduce__(self) -> tuple[type[Self], tuple[()], None, Iterator[_T]]:
         """Return state information for pickling."""
@@ -477,25 +477,28 @@ class OrderedDict(dict[_KT, _VT], Reversible[_KT], Generic[_KT, _VT]):
     @overload
     def pop(self, key: _KT) -> _VT:
         """
-        od.pop(k[,d]) -> v, remove specified key and return the corresponding
-        value.  If key is not found, d is returned if given, otherwise KeyError
-        is raised.
+        od.pop(key[,default]) -> v, remove specified key and return the corresponding value.
+
+        If the key is not found, return the default if given; otherwise,
+        raise a KeyError.
         """
         ...
     @overload
     def pop(self, key: _KT, default: _VT) -> _VT:
         """
-        od.pop(k[,d]) -> v, remove specified key and return the corresponding
-        value.  If key is not found, d is returned if given, otherwise KeyError
-        is raised.
+        od.pop(key[,default]) -> v, remove specified key and return the corresponding value.
+
+        If the key is not found, return the default if given; otherwise,
+        raise a KeyError.
         """
         ...
     @overload
     def pop(self, key: _KT, default: _T) -> _VT | _T:
         """
-        od.pop(k[,d]) -> v, remove specified key and return the corresponding
-        value.  If key is not found, d is returned if given, otherwise KeyError
-        is raised.
+        od.pop(key[,default]) -> v, remove specified key and return the corresponding value.
+
+        If the key is not found, return the default if given; otherwise,
+        raise a KeyError.
         """
         ...
     def __eq__(self, value: object, /) -> bool:

package/dist/typeshed-fallback/stdlib/datetime.pyi

@@ -87,7 +87,7 @@ class date:
         ...
     @classmethod
     def fromisoformat(cls, date_string: str, /) -> Self:
-        """str -> Construct a date from the output of date.isoformat()"""
+        """str -> Construct a date from a string in ISO 8601 format."""
         ...
     @classmethod
     def fromisocalendar(cls, year: int, week: int, day: int) -> Self:
@@ -248,7 +248,7 @@ class time:
         ...
     @classmethod
     def fromisoformat(cls, time_string: str, /) -> Self:
-        """string -> time from time.isoformat() output"""
+        """string -> time from a string in ISO 8601 format"""
         ...
     # On <3.12, the name of the parameter in the pure-Python implementation
     # didn't match the name in the C implementation,
@@ -397,7 +397,7 @@ class timedelta:
         """Return self==value."""
         ...
     def __bool__(self) -> bool:
-        """self != 0"""
+        """True if self else False"""
         ...
     def __hash__(self) -> int:
         """Return hash(self)."""

package/dist/typeshed-fallback/stdlib/faulthandler.pyi

@@ -4,35 +4,31 @@ import sys
 from _typeshed import FileDescriptorLike
 
 def cancel_dump_traceback_later() -> None:
-    """
-    cancel_dump_traceback_later():
-    cancel the previous call to dump_traceback_later().
-    """
+    """Cancel the previous call to dump_traceback_later()."""
     ...
 def disable() -> None:
-    """disable(): disable the fault handler"""
+    """Disable the fault handler."""
     ...
 def dump_traceback(file: FileDescriptorLike = ..., all_threads: bool = ...) -> None:
-    """dump_traceback(file=sys.stderr, all_threads=True): dump the traceback of the current thread, or of all threads if all_threads is True, into file"""
+    """Dump the traceback of the current thread, or of all threads if all_threads is True, into file."""
     ...
 def dump_traceback_later(timeout: float, repeat: bool = ..., file: FileDescriptorLike = ..., exit: bool = ...) -> None:
     """
-    dump_traceback_later(timeout, repeat=False, file=sys.stderrn, exit=False):
-    dump the traceback of all threads in timeout seconds,
+    Dump the traceback of all threads in timeout seconds,
     or each timeout seconds if repeat is True. If exit is True, call _exit(1) which is not safe.
     """
     ...
 def enable(file: FileDescriptorLike = ..., all_threads: bool = ...) -> None:
-    """enable(file=sys.stderr, all_threads=True): enable the fault handler"""
+    """Enable the fault handler."""
     ...
 def is_enabled() -> bool:
-    """is_enabled()->bool: check if the handler is enabled"""
+    """Check if the handler is enabled."""
     ...
 
 if sys.platform != "win32":
     def register(signum: int, file: FileDescriptorLike = ..., all_threads: bool = ..., chain: bool = ...) -> None:
-        """register(signum, file=sys.stderr, all_threads=True, chain=False): register a handler for the signal 'signum': dump the traceback of the current thread, or of all threads if all_threads is True, into file"""
+        """Register a handler for the signal 'signum': dump the traceback of the current thread, or of all threads if all_threads is True, into file."""
         ...
     def unregister(signum: int, /) -> None:
-        """unregister(signum): unregister the handler of the signal 'signum' registered by register()"""
+        """Unregister the handler of the signal 'signum' registered by register()."""
         ...

package/dist/typeshed-fallback/stdlib/functools.pyi

@@ -38,27 +38,27 @@ _RWrapper = TypeVar("_RWrapper")
 @overload
 def reduce(function: Callable[[_T, _S], _T], sequence: Iterable[_S], initial: _T, /) -> _T:
     """
-    reduce(function, sequence[, initial]) -> value
+    reduce(function, iterable[, initial]) -> value
 
-    Apply a function of two arguments cumulatively to the items of a sequence,
-    from left to right, so as to reduce the sequence to a single value.
-    For example, reduce(lambda x, y: x+y, [1, 2, 3, 4, 5]) calculates
+    Apply a function of two arguments cumulatively to the items of a sequence
+    or iterable, from left to right, so as to reduce the iterable to a single
+    value.  For example, reduce(lambda x, y: x+y, [1, 2, 3, 4, 5]) calculates
     ((((1+2)+3)+4)+5).  If initial is present, it is placed before the items
-    of the sequence in the calculation, and serves as a default when the
-    sequence is empty.
+    of the iterable in the calculation, and serves as a default when the
+    iterable is empty.
     """
     ...
 @overload
 def reduce(function: Callable[[_T, _T], _T], sequence: Iterable[_T], /) -> _T:
     """
-    reduce(function, sequence[, initial]) -> value
+    reduce(function, iterable[, initial]) -> value
 
-    Apply a function of two arguments cumulatively to the items of a sequence,
-    from left to right, so as to reduce the sequence to a single value.
-    For example, reduce(lambda x, y: x+y, [1, 2, 3, 4, 5]) calculates
+    Apply a function of two arguments cumulatively to the items of a sequence
+    or iterable, from left to right, so as to reduce the iterable to a single
+    value.  For example, reduce(lambda x, y: x+y, [1, 2, 3, 4, 5]) calculates
     ((((1+2)+3)+4)+5).  If initial is present, it is placed before the items
-    of the sequence in the calculation, and serves as a default when the
-    sequence is empty.
+    of the iterable in the calculation, and serves as a default when the
+    iterable is empty.
     """
     ...
 
@@ -149,7 +149,12 @@ else:
 
 def total_ordering(cls: type[_T]) -> type[_T]: ...
 def cmp_to_key(mycmp: Callable[[_T, _T], int]) -> Callable[[_T], SupportsAllComparisons]:
-    """Convert a cmp= function into a key= function."""
+    """
+    Convert a cmp= function into a key= function.
+
+    mycmp
+      Function that compares two objects.
+    """
     ...
 
 class partial(Generic[_T]):

package/dist/typeshed-fallback/stdlib/gc.pyi

@@ -13,6 +13,7 @@ set_threshold() -- Set the collection thresholds.
 get_threshold() -- Return the current the collection thresholds.
 get_objects() -- Return a list of all objects tracked by the collector.
 is_tracked() -- Returns true if a given object is tracked.
+is_finalized() -- Returns true if a given object has been already finalized.
 get_referrers() -- Return the list of objects that refer to an object.
 get_referents() -- Return the list of objects that an object refers to.
 freeze() -- Freeze all tracked objects and ignore them for future collections.

package/dist/typeshed-fallback/stdlib/importlib/metadata/__init__.pyi

@@ -269,8 +269,8 @@ class Distribution(_distribution_parent):
         :return: List of PackagePath for this distribution or None
 
         Result is `None` if the metadata file that enumerates files
-        (i.e. RECORD for dist-info or SOURCES.txt for egg-info) is
-        missing.
+        (i.e. RECORD for dist-info, or installed-files.txt or
+        SOURCES.txt for egg-info) is missing.
         Result may be empty if the metadata exists but is empty.
         """
         ...
@@ -294,10 +294,11 @@ class DistributionFinder(MetaPathFinder):
         @property
         def path(self) -> list[str]:
             """
-            The path that a distribution finder should search.
+            The sequence of directory path that a distribution finder
+            should search.
 
-            Typically refers to Python package paths and defaults
-            to ``sys.path``.
+            Typically refers to Python installed package paths such as
+            "site-packages" directories and defaults to ``sys.path``.
             """
             ...
 

package/dist/typeshed-fallback/stdlib/io.pyi

@@ -77,9 +77,9 @@ class IOBase(metaclass=abc.ABCMeta):
         ...
     def fileno(self) -> int:
         """
-        Returns underlying file descriptor if one exists.
+        Return underlying file descriptor if one exists.
 
-        OSError is raised if the IO object does not use a file descriptor.
+        Raise OSError if the IO object does not use a file descriptor.
         """
         ...
     def flush(self) -> None:
@@ -115,15 +115,19 @@ class IOBase(metaclass=abc.ABCMeta):
         ...
     def seek(self, offset: int, whence: int = ..., /) -> int:
         """
-        Change stream position.
+        Change the stream position to the given byte offset.
 
-        Change the stream position to the given byte offset. The offset is
-        interpreted relative to the position indicated by whence.  Values
-        for whence are:
+          offset
+            The stream position, relative to 'whence'.
+          whence
+            The relative position to seek from.
 
-        * 0 -- start of stream (the default); offset should be zero or positive
-        * 1 -- current stream position; offset may be negative
-        * 2 -- end of stream; offset is usually negative
+        The offset is interpreted relative to the position indicated by whence.
+        Values for whence are:
+
+        * os.SEEK_SET or 0 -- start of stream (the default); offset should be zero or positive
+        * os.SEEK_CUR or 1 -- current stream position; offset may be negative
+        * os.SEEK_END or 2 -- end of stream; offset is usually negative
 
         Return the new absolute position.
         """
@@ -143,8 +147,8 @@ class IOBase(metaclass=abc.ABCMeta):
         """
         Truncate file to size bytes.
 
-        File pointer is left unchanged.  Size defaults to the current IO
-        position as reported by tell().  Returns the new size.
+        File pointer is left unchanged. Size defaults to the current IO position
+        as reported by tell(). Return the new size.
         """
         ...
     def writable(self) -> bool:
@@ -200,12 +204,12 @@ class BufferedIOBase(IOBase):
     def readinto(self, buffer: WriteableBuffer, /) -> int: ...
     def write(self, buffer: ReadableBuffer, /) -> int:
         """
-        Write the given buffer to the IO stream.
+        Write buffer b to the IO stream.
 
-        Returns the number of bytes written, which is always the length of b
-        in bytes.
+        Return the number of bytes written, which is always
+        the length of b in bytes.
 
-        Raises BlockingIOError if the buffer is full and the
+        Raise BlockingIOError if the buffer is full and the
         underlying raw stream cannot accept more data at the moment.
         """
         ...
@@ -214,29 +218,28 @@ class BufferedIOBase(IOBase):
         """
         Read and return up to n bytes.
 
-        If the argument is omitted, None, or negative, reads and
-        returns all data until EOF.
+        If the size argument is omitted, None, or negative, read and
+        return all data until EOF.
 
-        If the argument is positive, and the underlying raw stream is
+        If the size argument is positive, and the underlying raw stream is
         not 'interactive', multiple raw reads may be issued to satisfy
-        the byte count (unless EOF is reached first).  But for
-        interactive raw streams (as well as sockets and pipes), at most
-        one raw read will be issued, and a short result does not imply
-        that EOF is imminent.
+        the byte count (unless EOF is reached first).
+        However, for interactive raw streams (as well as sockets and pipes),
+        at most one raw read will be issued, and a short result does not
+        imply that EOF is imminent.
 
-        Returns an empty bytes object on EOF.
+        Return an empty bytes object on EOF.
 
-        Returns None if the underlying raw stream was open in non-blocking
+        Return None if the underlying raw stream was open in non-blocking
         mode and no data is available at the moment.
         """
         ...
     def read1(self, size: int = ..., /) -> bytes:
         """
-        Read and return up to n bytes, with at most one read() call
-        to the underlying raw stream. A short result does not imply
-        that EOF is imminent.
+        Read and return up to size bytes, with at most one read() call to the underlying raw stream.
 
-        Returns an empty bytes object on EOF.
+        Return an empty bytes object on EOF.
+        A short result does not imply that EOF is imminent.
         """
         ...
 
@@ -369,15 +372,15 @@ class TextIOBase(IOBase):
         """
         Separate the underlying buffer from the TextIOBase and return it.
 
-        After the underlying buffer has been detached, the TextIO is in an
-        unusable state.
+        After the underlying buffer has been detached, the TextIO is in an unusable state.
         """
         ...
     def write(self, s: str, /) -> int:
         """
-        Write string to stream.
-        Returns the number of characters written (which is always equal to
-        the length of the string).
+        Write string s to stream.
+
+        Return the number of characters written
+        (which is always equal to the length of the string).
         """
         ...
     def writelines(self, lines: Iterable[str], /) -> None:
@@ -392,7 +395,8 @@ class TextIOBase(IOBase):
         """
         Read until newline or EOF.
 
-        Returns an empty string if EOF is hit immediately.
+        Return an empty string if EOF is hit immediately.
+        If size is specified, at most size characters will be read.
         """
         ...
     def readlines(self, hint: int = -1, /) -> list[str]:
@@ -406,10 +410,10 @@ class TextIOBase(IOBase):
         ...
     def read(self, size: int | None = ..., /) -> str:
         """
-        Read at most n characters from stream.
+        Read at most size characters from stream.
 
-        Read from underlying buffer until we have n characters or we hit EOF.
-        If n is negative or omitted, read until EOF.
+        Read from underlying buffer until we have size characters or we hit EOF.
+        If size is negative or omitted, read until EOF.
         """
         ...
 
@@ -444,7 +448,7 @@ class TextIOWrapper(TextIOBase, TextIO, Generic[_BufferT_co]):  # type: ignore[m
     Character and line based layer over a BufferedIOBase object, buffer.
 
     encoding gives the name of the encoding that the stream will be
-    decoded or encoded with. It defaults to locale.getpreferredencoding(False).
+    decoded or encoded with. It defaults to locale.getencoding().
 
     errors determines the strictness of encoding and decoding (see
     help(codecs.Codec) or the documentation for codecs.register) and
@@ -595,8 +599,9 @@ if sys.version_info >= (3, 10):
         """
         A helper function to choose the text encoding.
 
-        When encoding is not None, just return it.
-        Otherwise, return the default text encoding (i.e. "locale").
+        When encoding is not None, this function returns it.
+        Otherwise, this function returns the default text encoding
+        (i.e. "locale" or "utf-8" depends on UTF-8 mode).
 
         This function emits an EncodingWarning if encoding is None and
         sys.flags.warn_default_encoding is true.
@@ -610,8 +615,9 @@ if sys.version_info >= (3, 10):
         """
         A helper function to choose the text encoding.
 
-        When encoding is not None, just return it.
-        Otherwise, return the default text encoding (i.e. "locale").
+        When encoding is not None, this function returns it.
+        Otherwise, this function returns the default text encoding
+        (i.e. "locale" or "utf-8" depends on UTF-8 mode).
 
         This function emits an EncodingWarning if encoding is None and
         sys.flags.warn_default_encoding is true.

package/dist/typeshed-fallback/stdlib/ipaddress.pyi

@@ -148,10 +148,10 @@ class _BaseNetwork(_IPAddressBase, Generic[_A]):
     @property
     def is_private(self) -> bool:
         """
-        Test if this address is allocated for private networks.
+        Test if this network belongs to a private range.
 
         Returns:
-            A boolean, True if the address is reserved per
+            A boolean, True if the network is reserved per
             iana-ipv4-special-registry or iana-ipv6-special-registry.
         """
         ...

package/dist/typeshed-fallback/stdlib/itertools.pyi

@@ -8,17 +8,19 @@ repeat(elem [,n]) --> elem, elem, elem, ... endlessly or up to n times
 
 Iterators terminating on the shortest input sequence:
 accumulate(p[, func]) --> p0, p0+p1, p0+p1+p2
+batched(p, n) --> [p0, p1, ..., p_n-1], [p_n, p_n+1, ..., p_2n-1], ...
 chain(p, q, ...) --> p0, p1, ... plast, q0, q1, ...
 chain.from_iterable([p, q, ...]) --> p0, p1, ... plast, q0, q1, ...
 compress(data, selectors) --> (d[0] if s[0]), (d[1] if s[1]), ...
-dropwhile(pred, seq) --> seq[n], seq[n+1], starting when pred fails
+dropwhile(predicate, seq) --> seq[n], seq[n+1], starting when predicate fails
 groupby(iterable[, keyfunc]) --> sub-iterators grouped by value of keyfunc(v)
-filterfalse(pred, seq) --> elements of seq where pred(elem) is False
+filterfalse(predicate, seq) --> elements of seq where predicate(elem) is False
 islice(seq, [start,] stop [, step]) --> elements from
        seq[start:stop:step]
+pairwise(s) --> (s[0],s[1]), (s[1],s[2]), (s[2], s[3]), ...
 starmap(fun, seq) --> fun(*seq[0]), fun(*seq[1]), ...
 tee(it, n=2) --> (it1, it2 , ... itn) splits one iterator into n
-takewhile(pred, seq) --> seq[0], seq[1], until pred fails
+takewhile(predicate, seq) --> seq[0], seq[1], until predicate fails
 zip_longest(p, q, ...) --> (p[0], q[0]), (p[1], q[1]), ...
 
 Combinatoric generators:
@@ -510,7 +512,7 @@ class combinations_with_replacement(Iterator[_T_co]):
     """
     Return successive r-length combinations of elements in the iterable allowing individual elements to have successive repeats.
 
-    combinations_with_replacement('ABC', 2) --> AA AB AC BB BC CC"
+    combinations_with_replacement('ABC', 2) --> ('A','A'), ('A','B'), ('A','C'), ('B','B'), ('B','C'), ('C','C')
     """
     @overload
     def __new__(cls, iterable: Iterable[_T], r: Literal[2]) -> combinations_with_replacement[tuple[_T, _T]]: ...

package/dist/typeshed-fallback/stdlib/math.pyi

@@ -20,19 +20,31 @@ nan: float
 tau: float
 
 def acos(x: _SupportsFloatOrIndex, /) -> float:
-    """Return the arc cosine (measured in radians) of x."""
+    """
+    Return the arc cosine (measured in radians) of x.
+
+    The result is between 0 and pi.
+    """
     ...
 def acosh(x: _SupportsFloatOrIndex, /) -> float:
     """Return the inverse hyperbolic cosine of x."""
     ...
 def asin(x: _SupportsFloatOrIndex, /) -> float:
-    """Return the arc sine (measured in radians) of x."""
+    """
+    Return the arc sine (measured in radians) of x.
+
+    The result is between -pi/2 and pi/2.
+    """
     ...
 def asinh(x: _SupportsFloatOrIndex, /) -> float:
     """Return the inverse hyperbolic sine of x."""
     ...
 def atan(x: _SupportsFloatOrIndex, /) -> float:
-    """Return the arc tangent (measured in radians) of x."""
+    """
+    Return the arc tangent (measured in radians) of x.
+
+    The result is between -pi/2 and pi/2.
+    """
     ...
 def atan2(y: _SupportsFloatOrIndex, x: _SupportsFloatOrIndex, /) -> float:
     """
@@ -139,7 +151,7 @@ def fabs(x: _SupportsFloatOrIndex, /) -> float:
     ...
 def factorial(x: SupportsIndex, /) -> int:
     """
-    Find x!.
+    Find n!.
 
     Raise a ValueError if x is negative or non-integral.
     """
@@ -278,7 +290,7 @@ def log(x: _SupportsFloatOrIndex, base: _SupportsFloatOrIndex = ...) -> float:
     log(x, [base=math.e])
     Return the logarithm of x to the given base.
 
-    If the base not specified, returns the natural logarithm (base e) of x.
+    If the base is not specified, returns the natural logarithm (base e) of x.
     """
     ...
 def log10(x: _SupportsFloatOrIndex, /) -> float:

package/dist/typeshed-fallback/stdlib/multiprocessing/shared_memory.pyi

@@ -44,7 +44,7 @@ class ShareableList(Generic[_SLT]):
     def __len__(self) -> int: ...
     @property
     def format(self) -> str:
-        """The struct packing format used by all currently stored values."""
+        """The struct packing format used by all currently stored items."""
         ...
     def count(self, value: _SLT) -> int: ...
     def index(self, value: _SLT) -> int: ...

package/dist/typeshed-fallback/stdlib/os/__init__.pyi

@@ -685,12 +685,12 @@ if sys.platform != "win32":
         ...
     def getgrouplist(user: str, group: int, /) -> list[int]:
         """
-        getgrouplist(user, group) -> list of groups to which a user belongs
-
         Returns a list of groups to which a user belongs.
 
-            user: username to lookup
-            group: base group id of the user
+        user
+          username to lookup
+        group
+          base group id of the user
         """
         ...
     def getgroups() -> list[int]:
@@ -698,7 +698,7 @@ if sys.platform != "win32":
         ...
     def initgroups(username: str, gid: int, /) -> None:
         """
-        initgroups(username, gid) -> None
+        Initialize the group access list.
 
         Call the system initgroups() to initialize the group access list with all of
         the groups of which the specified username is a member, plus the specified
@@ -1007,6 +1007,14 @@ if sys.platform != "win32":
         """
         Change the access permissions of the file given by file descriptor fd.
 
+          fd
+            The file descriptor of the file to be modified.
+          mode
+            Operating-system mode bitfield.
+            Be careful when using number literals for *mode*. The conventional UNIX notation for
+            numeric modes uses an octal base, which needs to be indicated with a ``0o`` prefix in
+            Python.
+
         Equivalent to os.chmod(fd, mode).
         """
         ...
@@ -1140,6 +1148,7 @@ if sys.platform != "win32":
 
         - RWF_DSYNC
         - RWF_SYNC
+        - RWF_APPEND
 
         Using non-zero flags requires Linux 4.7 or newer.
         """
@@ -1164,12 +1173,7 @@ if sys.platform != "win32":
             trailers: Sequence[ReadableBuffer] = ...,
             flags: int = 0,
         ) -> int:
-            """
-            sendfile(out, in, offset, count) -> byteswritten
-            sendfile(out, in, offset, count[, headers][, trailers], flags=0)
-                        -> byteswritten
-            Copy count bytes from file descriptor in to file descriptor out.
-            """
+            """Copy count bytes from file descriptor in_fd to file descriptor out_fd."""
             ...
 
     def readv(fd: int, buffers: SupportsLenAndGetItem[WriteableBuffer], /) -> int:
@@ -1324,6 +1328,9 @@ def chmod(path: FileDescriptorOrPath, mode: int, *, dir_fd: int | None = None, f
         If this functionality is unavailable, using it raises an exception.
       mode
         Operating-system mode bitfield.
+        Be careful when using number literals for *mode*. The conventional UNIX notation for
+        numeric modes uses an octal base, which needs to be indicated with a ``0o`` prefix in
+        Python.
       dir_fd
         If not None, it should be a file descriptor open to a directory,
         and path should be relative; path will then be relative to that
@@ -1452,7 +1459,8 @@ def mkdir(path: StrOrBytesPath, mode: int = 0o777, *, dir_fd: int | None = None)
     dir_fd may not be implemented on your platform.
       If it is unavailable, using it will raise a NotImplementedError.
 
-    The mode argument is ignored on Windows.
+    The mode argument is ignored on Windows. Where it is used, the current umask
+    value is first masked out.
     """
     ...
 
@@ -2158,7 +2166,7 @@ if sys.platform != "win32":
     @final
     class sched_param(structseq[int], tuple[int]):
         """
-        Current has only one field: sched_priority");
+        Currently has only one field: sched_priority
 
         sched_priority
           A scheduling parameter.
@@ -2192,7 +2200,7 @@ if sys.platform != "win32":
             ...
         def sched_getscheduler(pid: int, /) -> int:
             """
-            Get the scheduling policy for the process identifiedy by pid.
+            Get the scheduling policy for the process identified by pid.
 
             Passing 0 for pid returns the scheduling policy for the calling process.
             """