Bug 963232 - Add extensive documentation to js/GCAPI.h; r=billm