[x265] [PATCH 1/6] doc(tme): update docs and mark --threaded-me as experimental feature

[Shashank Pathipati]

>From 64847b9d2e6b5bcd407ad43fd21824bfa9e264e1 Mon Sep 17 00:00:00 2001
From: Shashank Pathipati <shashank.pathipati at multicorewareinc.com>
Date: Fri, 10 Apr 2026 14:11:57 +0530
Subject: [PATCH 1/6] doc(tme): update docs and mark --threaded-me as
 experimental feature

---
 doc/reST/cli.rst | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/doc/reST/cli.rst b/doc/reST/cli.rst
index f602e1307..43c488b14 100755
--- a/doc/reST/cli.rst
+++ b/doc/reST/cli.rst
@@ -408,16 +408,21 @@ Performance Options
    can reduce compression efficiency. Recommended on many-core CPUs when
    encode speed is prioritized over compression efficiency.

-   If VBV options are enabled, Threaded ME is automatically disabled and a
-   warning is emitted.
+   This feature is automatically disabled in the following conditions:

-   This feature is implicitly disabled when no thread pool is present.
+   - When no thread pool is present.
+   - When the detected CPU core count is less than 32.
+   - If VBV options are enabled, due to incompatibility with re-encoding trigggers.

-   --threaded-me provides speedups on many-core CPUs, accompanied by a
-   compression efficiency loss.
+   Default disabled. **Experimental Feature**
+
+   .. note::
+       :option:`--threaded-me` currently provides encoding speedups only on
+       many-core machines running at low clock frequencies (at or below
+       approximately 1.5 GHz). On high-frequency systems or machines with
+       fewer cores, the overhead of the additional motion estimation work
+       may outweigh the parallelism gains.

-   Default disabled.
-
 .. option:: --preset, -p <integer|string>

    Sets parameters to preselected values, trading off compression efficiency against
--
2.52.0.windows.1



-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mailman.videolan.org/pipermail/x265-devel/attachments/20260410/34955bfa/attachment.htm>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: 0001-doc-tme-update-docs-and-mark-threaded-me-as-experime.patch
Type: application/octet-stream
Size: 1748 bytes
Desc: 0001-doc-tme-update-docs-and-mark-threaded-me-as-experime.patch
URL: <http://mailman.videolan.org/pipermail/x265-devel/attachments/20260410/34955bfa/attachment.obj>