doc: fix util.isObject documentation

Puts #743 (closed) to rest for good.

The change to fix the functionality would be too radical.

Replaces #822 (arguments for this are also contained in that thread).

These functions should probably be deprecated later. Maybe post-2.0.0?