Also relevant side question should pop be added to apis.rst? My opinions are in the link, but others should chime in.
This might also be of broader interest to relate to "rapid stdlib retractions in the Nim 1.0 era" if we did want to just rename rather than deprecate the brand new take overloads.
+1.
Is it me or the apis.rst has a completely broken format on Github? https://github.com/nim-lang/Nim/blob/devel/doc/apis.rst
@mratsim - it's not just you. Formatting looks pretty garbled.
@araq - sensible to me to duplicate/alias rather than deprecate. Pretty low-cost.
As proc name overloading is one of the ways to offer genericity in Nim code, selecting the right name is important, particularly for data structures that share similar behaviours. Some languages have symbol renaming or aliasing, like Eiffel, to handle such cases of semantic similarity.
+1 for pop