Re: [Numpy-discussion] Directives in numpy docstring convention

2017-12-24 Thread Pauli Virtanen
su, 2017-12-24 kello 18:51 +, Marc Garcia kirjoitti: [clip] > I guess those directives were added to the sphinx after the numpy > docstring convention was created. Just a comment on the historical point: the Numpy docstring standard existed before first Sphinx release. -- Pauli Virtanen ___

[Numpy-discussion] Directives in numpy docstring convention

2017-12-24 Thread Marc Garcia
Hi there, Is there a reason why the numpy docstring convention doesn't use the sphinx directives .. deprecated:: [1] and .. seealso:: [2]? I see that the numpy convention [3] uses the .. note:: directive for the deprecation notes, and for the "See also" it uses a section in this form: See also