From: Guenter Milde <milde@us...>  20110629 16:30:09

Dear Docutils devels, the Sphinx math extensions defines a "label" argument for the math directive, to be used e.g. :: .. math:: :label: eq:foo f(\epsilon) = \exp\left(\frac{\varepsilon}{k_\text{B}T}\right) which is essentially "syntactic sugar" for an internal hyperlink target:: .. _`eq_foo`: .. math:: \mathbf{M} = \left(\begin{matrix}a&b\\c&d\end{matrix}\right) Should Docutils: a) not support the "label" argument for math (as this is duplicating functionality), b) support the "label" argument for the "math" directive (only), to be compatible with Sphinx, c) support the "label" argument for all directives (similar to "class") as this improves the clarity of the rst source. I vote for c). Günter 