update documentation to new api
use struct constructor not shim_val_alloc