擅长:python、mysql、java
<p>一般来说,我更喜欢对生成的内容进行更好的控制,而不是将<code>:members:</code>指令添加到<code>automodule</code>中。因此,我建议使用<code>.. autoclass:: ERBFilterCoeffs</code>显式地记录{<cd3>}。我不会在这里添加<code>:members:</code>指令,因为这将包括<code>namedtuple</code>为每个字段创建的非常通用的默认文档。相反,我将在docstring中使用<code>.. py:attribute:: ...</code>元素,您可以使用特殊的<code>#:</code>注释将其放在类定义之前:</p>
<pre><code>#: Magic coefficients.
#:
#: .. py:attirbute:: A0
#:
#: A0 coefficient
#:
#: .. py:attribute:: gain
#:
#: Gain coefficient
ERBFilterCoeffs = namedtuple(
'ERBFilterCoeffs', [# Most parameters omitted
'A0',
'gain',
]
)
</code></pre>