preemptive is now true by default + improved documentation