Change return-type of `PointInElement` to `bool`

Contrary to the documentation, `PointInElement` only returned the
values 0 (point not in element) and 1 (point in element).

This patch changes the return-type to `bool` and updates the
documentation to match the implementation.