Updated docblocks to match reality

Some docblocks where missing, others incomplete or plain wrong. Especially increment/decrement did NOT accept arrays, despite the docblock making us think they do.

Only very little change in code.