I always thought that the "deprecated" directive is used if the term of removing the deprecated feature is not set yet, and the "deprecated-removed" directive is used if it is set. After removing the feature both directives are replaced with the "versionchanged" directive which only specifies the version of removing, not version of deprecation.
But after reading the devguide [1] I am no longer so confident. The devguide clearly describes it as specifying version at which the feature "is" removed, not "will be" removed. Maybe I always used this directive incorrectly? Or its meaning was changed with time? Or I incorrectly understand the devguide wording? Or devguide is incorrect? Before 3.8 I only seen "deprecated-removed" with future removing version. The first use "deprecated-removed" for feature which is already deleted happened in 3.8 (maybe the directive was just not updated), and there are now many uses for features removed in asyncio in 3.10. What was the initial meaning of "deprecated-removed", how it should be used now, and is the devguide correct? [1] https://devguide.python.org/documenting/?highlight=deprecated-removed#paragraph-level-markup _______________________________________________ Python-Dev mailing list -- python-dev@python.org To unsubscribe send an email to python-dev-le...@python.org https://mail.python.org/mailman3/lists/python-dev.python.org/ Message archived at https://mail.python.org/archives/list/python-dev@python.org/message/SWBM2N4EFPVQFP4TX6Q33L5OK2WPBFRU/ Code of Conduct: http://python.org/psf/codeofconduct/
