updated docs to show use with globals.