add 'null' function and more documentation