I have a new MacBook Pro, when I'm using it the screen goes suddenly blank for a second and comes back, it feels like as if someone unplugged my screen and plugged it back immediately.. why does this happen? 

Initially I thought it was only happening when I'm running on battery, but happens even when I'm connected too.

This is very sporadic. 


Question: How to get Javadoc to include documentation for a sub-project?
Answer: I realize that this suggestion lies outside of the implied constraints of your question, but it might be better to use an SCM tool (and not your IDE) to publish javadoc that covers dependent projects. For example, Maven has a plugin specifically designed to publish javadoc for modular projects.