rdoc for methods of JoinDependency and friends

JoinDependency and other associated methods are very complex.
Added rdocs makes it slighly easier to see what's going in the
method with a concrete example in some cases.