Updated docblocks to match reality

Updated docblocks to match reality. Some docblocks where missing, others just plain wrong (increment / decrement do not accept arrays)