Add ability to include methods from independent files

[hacksparrow]

The methods of a classs need not be defined in the same file as
the class file. They can be included from independent files by
adding /* @class <Name of the class> */ at the top of the
file to be included.

[hacksparrow]

@ritch @bajtos PTAL.

[bajtos]

To be honest, this code looks like pure magic to me and I don't have time right now to build deep understanding of how it actually works. I don't see any obvious problems, and considering that @ritch hasn't responded in the last two weeks, I think it's ok to land this patch as it is.

@hacksparrow I have one question only, the comment for assigning a file to a class, should it start with /* or /**? My impression was that we are processing only jsdoc comments, i.e. /** and ///. The pull request description says /* @class <Name of the class> */. What is correct?

[hacksparrow]

Both /* and /** are valid. The parsing is done by dox. So as long as dox can parse, it works.

[hacksparrow]

@rmg any idea why those two are failing?

[rmg]

The downstream failure appears to be the old job for deploying the apidocs site. I'll take a closer look later.

[bajtos]

@hacksparrow fair enough.

[hacksparrow]

@rmg yo!

[rmg]

@hacksparrow I've removed the dependency trigger, but you'll need to rebase in order to clear the failure status for the PR since statuses are set directly on the commits.

[hacksparrow]

@rmg still the same.

[rmg]

@hacksparrow I had to dig a little deeper than expected, but it should be fixed now. You can either rebase to clear the status or you can just ignore the failure.