search

cplusplus / draft

C++ standards drafts
http://www.open-std.org/jtc1/sc22/wg21/
5.69k stars 749 forks source link

[sf.cmath] contains superfluous "Effects:"-clauses #6728

Open Eelis opened 10 months ago

Eelis commented 10 months ago

For example: https://eel.is/c++draft/sf.cmath.riemann.zeta#1

This "Effects:"-clause doesn't specify anything that isn't already specified by the "Returns:"-clause that immediately follows it. If anything, this "Effects:"-clause sounds like an informal commentary on the intentions of the "Returns:"-clause.

jensmaurer commented 10 months ago

Well, having a bit of prose explanation of the gigantic math formula that follows feels helpful to me.