finished code and docs for noncontiguous updates