[C++-sig] Boost.Python v2: A few small changes

[David Abrahams]

In preparation for release, I've been working on documentation. When I read
my documentation, I sometimes get an uncomfortable feeling about what I
have to write and realize it would be better to fix the implementation. A
few small changes are happening now as a result:

1. The BOOST_PYTHON_[MEMBER_]FUNCTION_OVERLOADS macros used to expose
functions with default arguments will not be available by simply #including
<boost/python/class.hpp> or <boost/python/def.hpp>. Instead they will be
moved to <boost/python/overloads.hpp>

2. The module class is officially disappearing, for real. I'm going to keep
module.hpp, but only so I can do:

    #include <boost/python/module_init.hpp>
    #define BOOST_PYTHON_MODULE BOOST_PYTHON_MODULE_INIT

BOOST_PYTHON_MODULE_INIT will continue to be available but deprecated for
Boost 1.29.0, but the "official" macro will be BOOST_PYTHON_MODULE

By the way, I've been pondering the merits of having a <boost/python.hpp>
header which exposes all of the public headers, just for ease-of-use.
Opinions?

-----------------------------------------------------------
           David Abrahams * Boost Consulting
dave at boost-consulting.com * http://www.boost-consulting.com