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?