Document how to use varargs in Argument Clinic

development-tools/clinic.rst

@@ -1495,6 +1495,37 @@ 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 ``*args`` parameters (starargs / var-positional)
+---------------------------------------------------------------
+
+There are two converters suitable for ``*args``: *array* and *tuple*.
+
+Using the *array* converter will provide the implementation function with
+a C array *args* of type of :c:type:`PyObject * <PyObject>` and the number
+of items in the array as :c:type:`Py_ssize_t` *args_length*.
+For example::
+
+   /*[clinic input]
+   var_positional_sample
+
+       spam: int
+       *args: array
+   [clinic start generated code]*/
+
+Using the *tuple* converter will provide the implementation function with
+a standard :c:type:`PyTupleObject`.
+For example::
+
+   /*[clinic input]
+   var_positional_sample
+
+       spam: int
+       *args: tuple
+   [clinic start generated code]*/
+
+.. versionadded:: 3.11
+
+
 How to convert ``tp_new`` and ``tp_init`` functions
 ---------------------------------------------------