add stubs and documentation for various functions