trying to clean up the doco
doco for S4 classes
fixed caretList tests up a bit