[libstdc++] Doxygen markup for algorithms

[Kenny Simpson]

I believe the description for std::for_each is overly
restrictive.  In particular, the requirement that
        *  @p f must not modify its argument.

Not the the old draft Standard had this restriction,
but the final version does not. (implied from issue
290 - don't have my copy of the Standard in front of
me).

See
http://std.dkuug.dk/jtc1/sc22/wg21/docs/lwg-active.html#290

And also see Section 9.2.2: Nonmodifying Algorithms 
and Modifying Algorithms in Josutis' Book where he
states that the function object passed to for_each may
modify the element.

-Kenny


__________________________________________________
Do You Yahoo!?
Send FREE Valentine eCards with Yahoo! Greetings!
http://greetings.yahoo.com