document the swap-on-free idiom usage

Effective C++, item 17

Change-Id: I5c6f20c9631f1ca86b481a56ef08d578a7addbad