Actually, the more I think about it, the more I think the comments should be removed:

1. we should not be attempting to document operating system APIs

2. it adds considerable size and slows compilation - these files get imported a lot

3. the only comments that should be there are those that explain differences between the D version and the C version