rename functions. add usage note