Hi Nicholas!

On Thu, Jun 25, 2020 at 07:07:15AM -0400, Nicholas D Steeves wrote:
> Sphinx 3.0 removed sphinx.locale.l_() for sphinx.locale._() and/or
> sphinx.locale.__().  I've forwarded the issue upstream, because I don't
> believe I'll have time to check all of their documentation for other
> Sphinx 1.x vestiges.
>
> I wasn't able to find a migration doc, mention of sphinx.locale.l_()
> appears to have been cut (by upstream) from 1.8.4's docs...this seems
> strange and user-hostile, especially for documentation-related
> software.
>
> Is a migration doc available somewhere?  In this case I feel like I
> wasn't able to assess if it's something I could handle myself (in the
> time I am free), due to lack of documentation.

My bad, for API that was dropped in 3.x you need to look in 2.x docs,
not in 3.x.

So the correct link would be this one:

https://www.sphinx-doc.org/en/2.0/extdev/deprecated.html

which says that sphinx.locale.l_() was deprecated in 1.8, and the
alternative is sphinx.locale._():

https://www.sphinx-doc.org/en/3.x/extdev/i18n.html#sphinx.locale._

Apart from the table of deprecated interfaces, there are no other migration
docs.

--
Dmitry Shachnev

Attachment: signature.asc
Description: PGP signature

Reply via email to