Updated docblocks to match reality

Some docblocks where missing, others incomplete or plain wrong. Little change in code.