clockgen: add header documentation
clockgen: remove useless casts