documentation and change defaults around a bit