Fix docstring Args names that do not match the signatures

CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
+## Unreleased
+
+### Fixed
+
+- Fixed 26 docstring `Args:` entries that named a parameter the function does not take https://github.com/Textualize/textual/pull/6685
+
 ## [8.2.8] - 2026-06-30
 
 ### Fixed

src/textual/_binary_encode.py

@@ -40,7 +40,7 @@ def encode_none(_datum: None) -> bytes:
         Encodes a None value.
 
         Args:
-            datum: Always None.
+            _datum: Always None.
 
         Returns:
             None encoded.

src/textual/_border.py

@@ -353,7 +353,6 @@ def render_border_label(
         inner_style: The inner style (widget background).
         outer_style: The outer style (parent background).
         style: Widget style.
-        console: The console that will render the markup in the label.
         has_left_corner: Whether the border edge will have to render a left corner.
         has_right_corner: Whether the border edge will have to render a right corner.
 

src/textual/_compositor.py

@@ -176,7 +176,7 @@ def __init__(
 
         Args:
             chops: A mapping of offsets to list of segments, per line.
-            crop: Region to restrict update to.
+            spans: A list of `(y, x1, x2)` spans to update.
             chop_ends: A list of the end offsets for each line
         """
         self.chops = chops

src/textual/_loop.py

@@ -61,7 +61,7 @@ def loop_from_index(
         values: A sequence of values.
         index: Starting index.
         direction: Direction to move index (+1 for forward, -1 for backward).
-        bool: Should the index wrap when out of bounds?
+        wrap: Should the index wrap when out of bounds?
 
     Yields:
         A tuple of index and value from the sequence.

src/textual/_styles_cache.py

@@ -101,7 +101,7 @@ def render_widget(self, widget: Widget, crop: Region) -> list[Strip]:
 
         Args:
             widget: A widget.
-            region: A region of the widget to render.
+            crop: A region of the widget to render.
 
         Returns:
             Rendered lines.
@@ -185,7 +185,6 @@ def render(
             base_background: Background color beneath widget.
             background: Background color of widget.
             render_content_line: Callback to render content line.
-            console: The console in use by the app.
             border_title: Optional tuple of (title, color, background, style).
             border_subtitle: Optional tuple of (subtitle, color, background, style).
             content_size: Size of content or None to assume full size.
@@ -291,7 +290,6 @@ def render_line(
             base_background: Background color of widget beneath this line.
             background: Background color of widget.
             render_content_line: Callback to render a line of content.
-            console: The console in use by the app.
             border_title: Optional tuple of (title, color, background, style).
             border_subtitle: Optional tuple of (subtitle, color, background, style).
             opacity: Opacity of line.

src/textual/clock.py

@@ -20,7 +20,6 @@ def __init__(self, *, get_time: Callable[[], float] = monotonic) -> None:
 
         Args:
             get_time: A callable to get time in seconds.
-            start: Start the clock (time is 0 unless clock has been started).
         """
         self._get_time = get_time
         self._start_time = self._get_time()

src/textual/containers.py

@@ -95,7 +95,7 @@ def __init__(
             disabled: Whether the widget is disabled or not.
             can_focus: Can this container be focused?
             can_focus_children: Can this container's children be focused?
-            can_maximized: Allow this container to maximize? `None` to use default logic.,
+            can_maximize: Allow this container to maximize? `None` to use default logic.
         """
 
         super().__init__(

src/textual/css/_help_text.py

@@ -216,7 +216,6 @@ def scalar_help_text(
 
     Args:
         property_name: The name of the property.
-        num_values_supplied: The number of values the user supplied (a number other than 1, 2 or 4).
         context: The context the scalar property is being used in.
 
     Returns:

src/textual/css/_style_properties.py

@@ -312,7 +312,7 @@ def __set__(
 
         Args:
             obj: The ``Styles`` object.
-            value: A 2-tuple containing the type of box to use,
+            border: A 2-tuple containing the type of box to use,
                 e.g. "dashed", and the ``Style`` to be used. You can supply the ``Style`` directly, or pass a
                 ``str`` (e.g. ``"blue on #f0f0f0"`` ) or ``Color`` instead.
 
@@ -563,8 +563,7 @@ def __set__(self, obj: StylesBase, spacing: SpacingDimensions | None):
 
         Args:
             obj: The ``Styles`` object.
-            style: You can supply the ``Style`` directly, or a
-                string (e.g. ``"blue on #f0f0f0"``).
+            spacing: A single integer, or a ``tuple`` of 1, 2, or 4 integers.
 
         Raises:
             ValueError: When the value is malformed,
@@ -1164,7 +1163,7 @@ def __get__(self, obj: StylesBase, type: type[StylesBase]) -> float:
 
         Args:
             obj: The ``Styles`` object.
-            objtype: The ``Styles`` class.
+            type: The ``Styles`` class.
 
         Returns:
             The value of the property (in the range (0, 1)).

src/textual/css/stylesheet.py

@@ -343,7 +343,6 @@ def add_source(
         Args:
             css: String with CSS source.
             read_from: The original source location of the CSS.
-            path: The path of the source if a file, or some other identifier.
             is_default_css: True if the CSS is defined in the Widget, False if the CSS is defined
                 in a user stylesheet.
             tie_breaker: Integer representing the priority of this source.

src/textual/document/_syntax_aware_document.py

@@ -143,7 +143,7 @@ def get_line(self, index: int) -> str:
         """Return the string representing the line, not including new line characters.
 
         Args:
-            line_index: The index of the line.
+            index: The index of the line.
 
         Returns:
             The string representing the line.

src/textual/dom.py

@@ -349,11 +349,7 @@ def compose(self) -> ComposeResult:
         return self
 
     def _initialize_data_bind(self) -> None:
-        """initialize a data binding.
-
-        Args:
-            compose_parent: The node doing the binding.
-        """
+        """initialize a data binding."""
         if not self._reactive_connect:
             return
         for variable_name, (compose_parent, reactive) in self._reactive_connect.items():

src/textual/driver.py

@@ -78,7 +78,7 @@ def process_message(self, message: messages.Message) -> None:
         """Perform additional processing on a message, prior to sending.
 
         Args:
-            event: A message to process.
+            message: A message to process.
         """
         # NOTE: This runs in a thread.
         # Avoid calling methods on the app.

src/textual/drivers/linux_driver.py

@@ -328,7 +328,7 @@ def _patch_lflag(cls, attrs: int) -> int:
         """Patch termios lflag.
 
         Args:
-            attributes: New set attributes.
+            attrs: New set attributes.
 
         Returns:
             New lflag.

src/textual/drivers/linux_inline_driver.py

@@ -257,7 +257,7 @@ def _patch_lflag(cls, attrs: int) -> int:
         """Patch termios lflag.
 
         Args:
-            attributes: New set attributes.
+            attrs: New set attributes.
 
         Returns:
             New lflag.

src/textual/fuzzy.py

@@ -68,7 +68,8 @@ def score(self, candidate: str, positions: Sequence[int]) -> float:
         """Score a search.
 
         Args:
-            search: Search object.
+            candidate: The string that was matched.
+            positions: Offsets of the matched characters within the candidate.
 
         Returns:
             Score.

src/textual/layout.py

@@ -106,7 +106,7 @@ def translate(
 
         Args:
             placements: List of placements.
-            offset: Offset to add to placements.
+            translate_offset: Offset to add to placements.
 
         Returns:
             Placements with adjusted region, or same instance if offset is null.

src/textual/renderables/text_opacity.py

@@ -64,7 +64,6 @@ def process_segments(
             segments: Incoming segments.
             opacity: Opacity to apply.
             ansi_theme: Terminal theme.
-            background: Color of background.
             native_ansi: Allow ANSI colors.
 
         Returns:

src/textual/screen.py

@@ -502,7 +502,7 @@ def arrange(self, size: Size, _optimal: bool = False) -> DockArrangeResult:
 
         Args:
             size: Size of container.
-            optimal: Ignored on screen.
+            _optimal: Ignored on screen.
 
         Returns:
             Widget locations.

src/textual/visual.py

@@ -166,8 +166,6 @@ def get_minimal_width(self, rules: RulesMap) -> int:
 
         Args:
             rules: A mapping of style rules, such as the Widgets `styles` object.
-            container_width: The width of the container, used by Rich Renderables.
-                May be ignored for Textual Visuals.
 
         Returns:
             A width in cells.
@@ -367,7 +365,7 @@ def __init__(self, visual: Visual, spacing: Spacing) -> None:
         """
 
         Args:
-            Visual: A Visual.
+            visual: A Visual.
             spacing: A Spacing object containing desired padding dimensions.
         """
         self._visual = visual

src/textual/walk.py

@@ -181,7 +181,7 @@ def walk_selectable_widgets(
     Args:
         root: The root note (starting point).
         bounds: A Shape object that defines the selection bounds.
-        bounded: Container widgets that require a bounds check.
+        containers: Container widgets that require a bounds check.
 
     Returns:
         An iterable of DOMNodes.