Document how to use varargs in Argument Clinic

aisk · JelleZijlstra · skirpichev · skirpichev · commit 436be4a340ff · 2025-08-12T14:37:04.000+03:00
Co-authored-by: Jelle Zijlstra &lt;jelle.zijlstra@gmail.com&gt;
Co-authored-by: Sergey B Kirpichev &lt;skirpichev@gmail.com&gt;
diff --git a/development-tools/clinic.rst b/development-tools/clinic.rst
@@ -1495,6 +1495,27 @@ You can still use a self converter, a return converter, and specify
 a *type* argument to the object converter for :c:macro:`METH_O`.
 
 
+How to convert var-positional parameter functions
+-------------------------------------------------
+
+To convert a var-positional parameter function,
+prepending the parameter name with ``*`` ,
+and the parameter should use the ``object`` converter::
+
+   /*[clinic input]
+   var_positional_sample
+
+       foo: int
+       *args: object
+   [clinic start generated code]*/
+
+The implementation function will receive var-positional arguments
+as *args* array.
+
+.. versionadded:: 3.11
+.. versionchanged:: 3.14
+
+
 How to convert ``tp_new`` and ``tp_init`` functions
 ---------------------------------------------------
 
