Updated docblocks to match reality

Some of the docblocks where incomplete, some missing, and others where just plain wrong. Specifically increment/decrement do NOT accept arrays .