D-Programming-Language/druntime — pull request #231 by jmdavis (2012-05-30 06:42:47+00:00)
Title: Renamed clear to destroy.

An alias for clear remains but is scheduled for deprecation.

As [discussed in the newsgroup](http://forum.dlang.org/post/jpo00g$u23$1@digitalmars.com), 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.