Docs: fixes, updates, reorganization
allow java varargs main

http://docs.oracle.com/javase/specs/jls/se7/html/jls-12.html#jls-12.1.4