docs(filtering[rename]): "C-side" → "native" across docstrings and CHANGES

why: "C-side" leaks tmux's implementation language (C) into prose
about an architectural distinction — filter evaluated in tmux's
own format engine vs. re-filtered in Python. "Native" reads
cleanly as "tmux's own", parallels "Python-side", and avoids the
language conflation.

what:
- Rename the MyST anchor (c-side-filtering)= to (native-filtering)=
  in docs/topics/filtering.md; update the 9 {ref} cites across
  server.py, session.py, window.py, neo.py, clients.md,
  traversal.md.
- Replace "tmux's C-side <noun>" with "tmux's native <noun>" in 7
  docstring locations + 1 test docstring.
- Rename the filtering.md section heading "C-Side Filtering" to
  "Native Filtering" and the comparison subsection "Python-side
  vs. C-side" to "Python-side vs. native".
- Rename the CHANGES section heading and lead-paragraph mention to
  match.

Net zero line count (24 inserted, 24 deleted) — pure prose rename.
No functional or type changes; pytest, ruff, ty, and the docs
build are unchanged from pre-rename.

Author: tony

CHANGES

@@ -47,7 +47,7 @@ _Notes on the upcoming release will go here._
 
 libtmux 0.57.0 broadens tmux support. It introduces
 {class}`~libtmux.Client` as a first-class object, threads tmux's
-C-side ``-f`` filter through the typed listing methods so callers can
+native ``-f`` filter through the typed listing methods so callers can
 push predicates into the tmux server, and adds typed access to many
 more format tokens — all scope- and version-gated so they're safe on
 every supported tmux version. Subcommand context now flows through
@@ -193,7 +193,7 @@ call in :func:`warnings.catch_warnings` with
 ``filterwarnings("error")``. See {doc}`MIGRATION` for the escalation
 pattern.
 
-#### C-side filter on typed listing methods (#672)
+#### Native filter on typed listing methods (#672)
 
 {meth}`~libtmux.Server.search_panes`,
 {meth}`~libtmux.Server.search_windows`,

docs/topics/clients.md

@@ -90,7 +90,7 @@ For tmux-server-side filtering (no Python-side iteration), use
 {meth}`~libtmux.Server.search_sessions`-style predicate strings via
 the `-f` flag — but note that `list-clients` only accepts a single
 filter and exposes a narrower token vocabulary than sessions/windows.
-See {ref}`c-side-filtering` for the predicate syntax.
+See {ref}`native-filtering` for the predicate syntax.
 
 ## When `attached_*` returns `None`
 
@@ -111,4 +111,4 @@ can branch on truthiness without a `try`/`except`.
 
 - {doc}`/api/libtmux.client` — autodoc reference
 - {ref}`about` — where `Client` fits in the overall object model
-- {ref}`c-side-filtering` — tmux-side filtering for `Server.clients`
+- {ref}`native-filtering` — tmux-side filtering for `Server.clients`

docs/topics/filtering.md

@@ -258,9 +258,9 @@ True
 >>> w3.kill()
 ```
 
-(c-side-filtering)=
+(native-filtering)=
 
-## C-Side Filtering with `search_*()`
+## Native Filtering with `search_*()`
 
 `QueryList.filter()` runs in Python *after* tmux has returned every
 row. For large servers, or when you only need a handful of matches,
@@ -287,7 +287,7 @@ client-side predicate to tmux is rarely a hot path — a server's client
 count is bounded by attached terminals, not by session/window/pane
 fan-out.
 
-### Python-side vs. C-side
+### Python-side vs. native
 
 | | `.filter()` | `.search_*()` |
 |-|-------------|---------------|
@@ -377,5 +377,5 @@ Use `.filter()` when:
 ## API Reference
 
 See {class}`~libtmux._internal.query_list.QueryList` for the complete
-QueryList API, and each `search_*()` method for the C-side filter
+QueryList API, and each `search_*()` method for the native filter
 contract.

docs/topics/traversal.md

@@ -139,7 +139,7 @@ True
 libtmux collections support Django-style filtering with `filter()` and `get()`.
 For comprehensive coverage of all lookup operators, see {ref}`querylist-filtering`.
 For tmux-server-side predicates (compiled and executed inside tmux, fewer round
-trips on large servers), see {ref}`c-side-filtering`.
+trips on large servers), see {ref}`native-filtering`.
 
 ### Basic Filtering
 

src/libtmux/neo.py

@@ -670,7 +670,7 @@ def fetch_objs(
             engine evaluates as "false" — every row is suppressed and no
             stderr is emitted. A bad filter is indistinguishable from
             "filter matched nothing"; verify predicate syntax against the
-            FORMATS section of ``tmux(1)``. See :ref:`c-side-filtering`
+            FORMATS section of ``tmux(1)``. See :ref:`native-filtering`
             for the typed wrappers that share this caveat.
 
         .. versionadded:: 0.57

src/libtmux/server.py

@@ -1875,7 +1875,7 @@ def list_buffers(
         Without arguments returns tmux's default template
         (``name: N bytes: "sample"``) — kept for backward compatibility.
         Pass *format_string* to project a specific tmux format, or *filter*
-        to push a format-expression predicate into tmux's C-side evaluation
+        to push a format-expression predicate into tmux's native evaluation
         (avoids parsing the default template in Python).
 
         Parameters
@@ -2388,7 +2388,7 @@ def search_sessions(
         *,
         filter: str | None = None,  # noqa: A002
     ) -> QueryList[Session]:
-        """Sessions, optionally filtered by tmux's C-side format predicate.
+        """Sessions, optionally filtered by tmux's native format predicate.
 
         Like :attr:`Server.sessions` but adds an optional ``filter`` kwarg
         that is plumbed through to ``$ tmux list-sessions -f <filter>``.
@@ -2420,7 +2420,7 @@ def search_sessions(
         --------
         :attr:`Server.sessions` : unfiltered :class:`QueryList` of every
             session (Python-side ``.filter()`` runs against this).
-        :ref:`c-side-filtering` : when to pick ``search_*`` over
+        :ref:`native-filtering` : when to pick ``search_*`` over
             ``QueryList.filter()``.
 
         Examples
@@ -2448,7 +2448,7 @@ def search_windows(
         *,
         filter: str | None = None,  # noqa: A002
     ) -> QueryList[Window]:
-        """All windows across sessions, optionally filtered by tmux's C-side predicate.
+        """All windows across sessions, optionally filtered by tmux's native predicate.
 
         Like :attr:`Server.windows` but with a ``filter`` kwarg plumbed to
         ``$ tmux list-windows -a -f <filter>``.
@@ -2475,7 +2475,7 @@ def search_windows(
         :attr:`Server.windows` : unfiltered :class:`QueryList` of every
             window across every session (Python-side ``.filter()`` runs
             against this).
-        :ref:`c-side-filtering` : when to pick ``search_*`` over
+        :ref:`native-filtering` : when to pick ``search_*`` over
             ``QueryList.filter()``.
 
         Examples
@@ -2506,7 +2506,7 @@ def search_panes(
         *,
         filter: str | None = None,  # noqa: A002
     ) -> QueryList[Pane]:
-        """All panes across the server, optionally filtered by tmux's C-side predicate.
+        """All panes across the server, optionally filtered by tmux's native predicate.
 
         Like :attr:`Server.panes` but with a ``filter`` kwarg plumbed to
         ``$ tmux list-panes -a -f <filter>``. This is the typed entry point
@@ -2537,7 +2537,7 @@ def search_panes(
         --------
         :attr:`Server.panes` : unfiltered :class:`QueryList` of every
             pane (Python-side ``.filter()`` runs against this).
-        :ref:`c-side-filtering` : when to pick ``search_*`` over
+        :ref:`native-filtering` : when to pick ``search_*`` over
             ``QueryList.filter()``.
 
         Examples

src/libtmux/session.py

@@ -207,7 +207,7 @@ def search_windows(
         *,
         filter: str | None = None,  # noqa: A002
     ) -> QueryList[Window]:
-        """Windows in this session, optionally filtered by tmux's C-side predicate.
+        """Windows in this session, optionally filtered by tmux's native predicate.
 
         Like :attr:`Session.windows` but with a ``filter`` kwarg plumbed to
         ``$ tmux list-windows -t <session> -f <filter>``.
@@ -234,7 +234,7 @@ def search_windows(
         :attr:`Session.windows` : unfiltered :class:`QueryList` of every
             window in this session (Python-side ``.filter()`` runs
             against this).
-        :ref:`c-side-filtering` : when to pick ``search_*`` over
+        :ref:`native-filtering` : when to pick ``search_*`` over
             ``QueryList.filter()``.
 
         Examples
@@ -263,7 +263,7 @@ def search_panes(
         *,
         filter: str | None = None,  # noqa: A002
     ) -> QueryList[Pane]:
-        """Panes in this session, optionally filtered by tmux's C-side predicate.
+        """Panes in this session, optionally filtered by tmux's native predicate.
 
         Like :attr:`Session.panes` but with a ``filter`` kwarg plumbed to
         ``$ tmux list-panes -s -t <session> -f <filter>``.
@@ -290,7 +290,7 @@ def search_panes(
         :attr:`Session.panes` : unfiltered :class:`QueryList` of every
             pane in this session (Python-side ``.filter()`` runs against
             this).
-        :ref:`c-side-filtering` : when to pick ``search_*`` over
+        :ref:`native-filtering` : when to pick ``search_*`` over
             ``QueryList.filter()``.
 
         Examples

src/libtmux/window.py

@@ -211,7 +211,7 @@ def search_panes(
         *,
         filter: str | None = None,  # noqa: A002
     ) -> QueryList[Pane]:
-        """Panes in this window, optionally filtered by tmux's C-side predicate.
+        """Panes in this window, optionally filtered by tmux's native predicate.
 
         Like :attr:`Window.panes` but with a ``filter`` kwarg plumbed to
         ``$ tmux list-panes -t <window> -f <filter>``.
@@ -238,7 +238,7 @@ def search_panes(
         :attr:`Window.panes` : unfiltered :class:`QueryList` of every
             pane in this window (Python-side ``.filter()`` runs against
             this).
-        :ref:`c-side-filtering` : when to pick ``search_*`` over
+        :ref:`native-filtering` : when to pick ``search_*`` over
             ``QueryList.filter()``.
 
         Examples

tests/test_session.py

@@ -688,7 +688,7 @@ def test_session_last_window_exception_tags_subcommand(session: Session) -> None
 
 
 def test_session_search_windows_filter(session: Session) -> None:
-    """``Session.list_windows(filter=...)`` filters via tmux's C-side -f flag."""
+    """``Session.list_windows(filter=...)`` filters via tmux's native -f flag."""
     session.new_window(window_name="gap7s_keep")
     session.new_window(window_name="other_drop")