Renamed publishLazy to lazyPublish and added docs.  Added deepPublish() to Events.
Renamed publishLazy to lazyPublish and added docs.  Added deepPublish() to Events.

shepheb/foam,foam-framework/foam,foam-framework/foam,osric-the-knight/foam,mdittmer/foam,osric-the-knight/foam,mdittmer/foam,foam-framework/foam,jacksonic/foam,jacksonic/foam,jlhughes/foam,jacksonic/foam,jacksonic/foam,foam-framework/foam,jlhughes/foam,osric-the-knight/foam,mdittmer/foam,shepheb/foam,jlhughes/foam,foam-framework/foam,shepheb/foam,mdittmer/foam,jlhughes/foam,osric-the-knight/foam