updated docs concerning globals