This is related to #1509.
Now that top-level block comments are compiled outside of safety wrapper, documentation generators, suck as jsduck have a hard time with it. Essentially, JSDuck tries to infer as much information from code as possible, so that developer doesn't have to write a lot of comment tags. By splitting function documentation (top-level block comment) away from function definition, JSDuck can't infer anything.
Could we get a (command line) option when compiling, to put top-level block comments near function definition?