Doc comments for hal and lib.

Just leaves `drivers` (and `platformtree`) to go.
> Why not use _ for StopBit?

Because I was tired ;)