[Boost-bugs] [Boost C++ Libraries] #5580: BOOST_PP_MUL documentation regarding efficiency is confusing

Subject: [Boost-bugs] [Boost C++ Libraries] #5580: BOOST_PP_MUL documentation regarding efficiency is confusing
From: Boost C++ Libraries (noreply_at_[hidden])
Date: 2011-05-29 20:41:16

#5580: BOOST_PP_MUL documentation regarding efficiency is confusing
--------------------------------------------------------------------+-------
 Reporter:  Jeffrey Lee Hellrung, Jr. <jeffrey.hellrung@…>          |       Owner:  no-maintainer
     Type:  Bugs                                                    |      Status:  new          
Milestone:  To Be Determined                                        |   Component:  preprocessor 
  Version:  Boost 1.46.1                                            |    Severity:  Problem      
 Keywords:  preprocessor BOOST_PP_MUL                               |  
--------------------------------------------------------------------+-------
 From

 http://www.boost.org/libs/preprocessor/doc/ref/mul.html


 "This macro is the most efficient when x is less than or equal to y.
 However, the efficiency gain is not worth actually comparing the two
 arguments prior to invocation.  In other words, x should be the value that
 is most likely to be the largest of the two operands."

 The first sentence suggest that x <= y is more efficient; the last
 sentence suggests that x >= y is more efficient.  I'm confused :(

-- 
Ticket URL: <https://svn.boost.org/trac/boost/ticket/5580>
Boost C++ Libraries <http://www.boost.org/>
Boost provides free peer-reviewed portable C++ source libraries.