pybind11/docs/advanced/cast
Dean Moldovan 443ab5946b Replace PYBIND11_PLUGIN with PYBIND11_MODULE
This commit also adds `doc()` to `object_api` as a shortcut for the
`attr("__doc__")` accessor.

The module macro changes from:
```c++
PYBIND11_PLUGIN(example) {
    pybind11::module m("example", "pybind11 example plugin");
    m.def("add", [](int a, int b) { return a + b; });
    return m.ptr();
}
```

to:

```c++
PYBIND11_MODULE(example, m) {
    m.doc() = "pybind11 example plugin";
    m.def("add", [](int a, int b) { return a + b; });
}
```

Using the old macro results in a deprecation warning. The warning
actually points to the `pybind11_init` function (since attributes
don't bind to macros), but the message should be quite clear:
"PYBIND11_PLUGIN is deprecated, use PYBIND11_MODULE".
2017-05-29 03:21:19 +02:00
..
chrono.rst Automate generation of reference docs with doxygen and breathe (#598) 2017-01-31 16:54:08 +01:00
custom.rst add note about custom type casters (fixes #480) 2016-11-04 11:06:22 +01:00
eigen.rst Eigen<->numpy referencing support 2017-02-24 23:19:50 +01:00
functional.rst Replace PYBIND11_PLUGIN with PYBIND11_MODULE 2017-05-29 03:21:19 +02:00
index.rst RFC - Add documentation for strings and Unicode issues (#636) 2017-02-02 13:56:31 +01:00
overview.rst Add type caster for std::variant and other variant-like classes 2017-04-29 17:31:30 +02:00
stl.rst Add type caster for std::variant and other variant-like classes 2017-04-29 17:31:30 +02:00
strings.rst RFC - Add documentation for strings and Unicode issues (#636) 2017-02-02 13:56:31 +01:00