What is the correct way to document a **kwargs parameter?

autodoc, python, python-sphinx

Solution

I think `subprocess`-module's docs is a good example. Give an exhaustive list of all parameters for a top/parent class. Then just refer to that list for all other occurrences of `**kwargs`.

Problem

I'm using Sphinx and the autodoc extension to generate API documentation for my Python modules. Whilst I can see how to nicely document specific parameters, I cannot find an example of how to document a `**kwargs` parameter. Does anyone have a good example of a clear way to document these?

Original source