another load of documentation; minor Environment API improvements