update docs on core function stubbing. fixes issue #1