global emitter added and documented source