This is the mail archive of the
gcc-bugs@gcc.gnu.org
mailing list for the GCC project.
[Bug libstdc++/51539] multiplies ::operator () undocumented
- From: "giecrilj at stegny dot 2a.pl" <gcc-bugzilla at gcc dot gnu dot org>
- To: gcc-bugs at gcc dot gnu dot org
- Date: Tue, 13 Dec 2011 23:30:49 +0000
- Subject: [Bug libstdc++/51539] multiplies ::operator () undocumented
- Auto-submitted: auto-generated
- References: <bug-51539-4@http.gcc.gnu.org/bugzilla/>
http://gcc.gnu.org/bugzilla/show_bug.cgi?id=51539
--- Comment #2 from Christopher Yeleighton <giecrilj at stegny dot 2a.pl> 2011-12-13 23:30:49 UTC ---
(In reply to comment #1)
> It returns x*y, which may or may not be the product, the binary operator* could
> be overloaded for Tp with a completely different meaning.
The result of operator * is a product. Of course, the kind of product depends
on the operator used.
>
> Actually I'm wondering if it's worth adding anything here. What else is
> multiplies going to do, except multiply? There's already a link to a page
> saying all the arithmetic operations have corresponding functors, it should be
> self-explanatory.
But then the meaning of the types defined by the class is also self-explanatory
and documented elsewhere, yet they are documented.
You choose: either you add one sentence to the documentation or you use so many
sentences to explain why the sentence need not be added. As you like it.