add docblocks
restore old method calls as deprecated pass-throughs to RelationsContainer