documentation (environment)
update doco
add method for disabling alloca