added id array capability to except and retain
added $btw
update some comments
Merge branch 'WIP'