Return policy for return *this

[matwey]

Hello,

Lets imaging the following C++ code:

class cls {
public:
    cls& foo() {
        // do something
        return *this;
    }
};

It is not uncommon pattern for allowing chained member-function invocation. What return policy should be used when I want to wrap cls::foo using pybind11? Is automatic suitable for this case? Unfortunately, the documentation lacks of this common example.