An alias for clear remains but is scheduled for deprecation.
As discussed in the newsgroup, we want to rename clear to something else which is less likely to conflict with other functions and thus cause problems. destroy was a popular choice, so that's what I picked.
I also added a ddoc comment to destroy which I hope is clear enough, but clear has been undocumented, which it really shouldn't be, especially when we still unfortunately have delete documented.
Renamed clear to destroy.
How about a changelog entry?
I never mess with the changelog in pull requests, because it screws up merging far too easily. Assuming that this gets merged, I'll update the changelog then.
Does having DDoc on aliases work? If so, this could probably be made a doc comment.
They don't; we have the same problem whenever we want to deprecate equals_t.
Yes, they do work. For instance, DateTimeException is an alias for TimeException, and it shows up in the docs. I just didn't put ddoc on the alias, because clear wasn't actually documented in the first place.