[Bug libstdc++/70716] Doxygen comments on std containers need updating for C++11 allocators

[redi at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=70716

--- Comment #1 from Jonathan Wakely <redi at gcc dot gnu.org> ---
(In reply to Jonathan Wakely from comment #0)
> Also, assignment operators and functions often say "Old data may be lost." I
> think that's a confusing way to say that old elements are replaced, do we
> really want to talk about data loss?

Especially "may be lost" ... that doesn't tell the user anything useful. The
elements are definitely destroyed. Whether that results in data loss or not
depends on the elements, but saying "data may be lost" is too vague to be
useful. Under what conditions is it lost? I think we should just remove those
sentences.