Allow modules to be split across files

[hegemonic]

Right now it's not possible to split a module definition across multiple JS files. It would be useful if that were possible.

We should think about how to implement this in a way that also helps with #272.

Originally reported by @nenaraab as jsdoc/jsdoc.github.io#44:

we have a module which loads another file. In both files we have objects we want to document. It should be documented as one module. So we set @module mymodule in both files. The generated documentation looks fine in general but is displays the twice at one page. They only differ in the module source.

[nenaraab]

Thanks a lot for the quick reply!
Yes, the issue sounds quite similar to "allowing the same namespace to be documented in multiple places without generating duplicate documentation".
Nena & Christoph

[sempasha]

allowing the same namespace to be documented in multiple places without generating duplicate documentation

Wow! Exactly what I'm looking for to do more simple module members definition.

[kgryte]

@hegemonic Has there been any progress on this? We use JSDoc-style comments extensively in our codebase, but often a module is comprised of several files. Being able to prevent duplication of comments (i.e., not having to create virtual comments in the main export), would be highly beneficial.

[cwingrav]

I too would like to see some action on this. It generates several entries for namespaces, each duplicating the namespace generated code. Seems more of a bug, than a feature at this point?

[harish2704]

+1

[harish2704]

I found this solution works #1002 (comment)