Provide examples of using JSDoc with code wrapped in IIFEs

[hegemonic]

We should provide some non-module examples that show how to use JSDoc with code wrapped in IIFEs. See jsdoc/jsdoc#456 for more context.

[Haroenv]

So what is the workaround now to let jsdoc generate documentation if you encapsulate your function?

I'm encapsulating my function like this:

(function() {
  // some code with functions and documentation
})();

Which generates output if I leave out the encapsulation.

[garapa]

I've found out that you may use annotations on IIFE's (@Class or @method for example) to generate the docs.

Something like this:

/**
  * @class className
*/
(function(){
         /**
           * @name #init
           * @function
           * @memberOf className
         */
        function init() {
          
        };
})();